redirect_url,并在跳转时携带本次支付的结果参数。本文说明 API - 支付 场景下同步跳转所携带的参数及其两种跳转方式。同步跳转仅用于前端页面回显支付结果,不可作为商户发货或对账的最终依据。请以服务端接收到的异步通知(notification)或支付查询接口返回的结果为准。
| 跳转方式 | 请求方式 | 参数传递方式 |
|---|---|---|
| GET 跳转(默认) | GET | 参数以查询串形式拼接在 redirect_url 之后(?a=1&b=2),并保留商户下单时 redirect_url 上自带的原始参数 |
| POST 跳转 | POST | 以表单(application/x-www-form-urlencoded)形式将下列参数 POST 提交到 redirect_url,不合并商户自带参数 |
说明:默认采用 GET 方式跳转。若商户需要 POST 方式跳转(如服务端接收表单的场景),可联系连连支付调整为 POST 跳转。
| 参数名 | 类型 | 是否必需 | 说明 | 示例值 |
|---|---|---|---|---|
| sign_type | string | 必需 | 签名方式,固定为 RSA | RSA |
| merchant_id | string | 必需 | 商户号 | 202004070000395003 |
| merchant_transaction_id | string | 必需 | 商户支付交易 ID,即下单时传入的 merchant_transaction_id | 693100628120965120 |
| order_currency_code | string | 必需 | 下单币种 | USD |
| order_amount | string | 必需 | 下单金额,单位元,保留 2 位小数 | 88.88 |
| payment_currency_code | string | 必需 | 支付币种 | USD |
| payment_amount | string | 必需 | 支付金额,单位元,保留 2 位小数 | 88.88 |
| payment_status | string | 必需 | 支付订单状态,如 PS 表示支付成功,完整取值详见订单状态说明文档 | PS |
| signature | string | 必需 | 签名值,商户侧使用连连全球收单配置的对应公钥验签 | XJxQTCs1QTsp+Xo3... |
signature 外的所有业务参数。安全提醒: payment_status等参数在浏览器跳转过程中可被篡改,商户务必完成验签,切勿在未验签的情况下直接依据跳转参数更新订单状态。
redirect_url 之后:https://merchant.example.com/return?sign_type=RSA&merchant_id=202004070000395003&merchant_transaction_id=693100628120965120&order_currency_code=USD&order_amount=88.88&payment_currency_code=USD&payment_amount=88.88&payment_status=PS&signature=XJxQTCs1QTsp...redirect_url,参数结构如下:{
"sign_type": "RSA",
"merchant_id": "202004070000395003",
"merchant_transaction_id": "693100628120965120",
"order_currency_code": "USD",
"order_amount": "88.88",
"payment_currency_code": "USD",
"payment_amount": "88.88",
"payment_status": "PS",
"signature": "XJxQTCs1QTsp+Xo3..."
}