1. 开始接入
  • 概览
  • 集成模式
    • 收银台模式
    • 嵌入式 iframe 模式
    • Direct API 模式
    • 插件模式
  • 支付方式
    • 支付方式概览
    • 全球
      • 国际卡
      • Afterpay
      • Apple Pay
      • Google Pay
      • Klarna
    • 中国大陆&港台地区
      • Alipay CN
      • Alipay HK
      • JKO PAY
      • TWN BANK
      • WeChat Pay
    • 日韩地区
      • 日本
        • Konbini
      • 韩国
        • Kakao Pay
        • Naver Pay
        • PAYCO
    • 东南亚地区
      • 印度尼西亚
        • Akulaku
        • BNI
        • BRI
        • CIMB Clicks
        • DANA
        • Mandiri
        • Maybank
        • Nobu Bank QRIS
        • OVO
        • Permata
      • 马来西亚
        • Boost
        • Mcash
        • Touch n Go
      • 菲律宾
        • BPI
        • Coins.ph
        • GCash
        • GrabPay
        • Maya
      • 泰国
        • Bualuang iBanking
        • Krungsri Online
        • Prompt Pay
        • Rabbit LINE Pay
        • TrueMoney
      • 越南
        • Napas Card
        • VietQR
        • Zalopay
  • 开始接入
    • 申请测试商户
    • 测试验收场景
    • 上线前准备
    • 如何配置公钥
    • 请求与响应结构
    • API 签名组装规则
    • 支付完成同步跳转参数说明
    • 收银台对接
      • 收银台流程说明
    • iframe 对接
      • 国际卡支付流程(iframe)
      • 国际卡绑卡流程(iframe)
      • Google Pay 流程(iframe)
      • Apple Pay 流程(iframe)
    • Direct API 对接
      • 国际卡支付流程(Direct API)
      • WeChatPay 流程(Direct API)
      • Alipay+ 流程(Direct API)
      • Apple Pay 流程(Direct API)
  • APIs
    • 接口
      • API - 支付
      • API - 支付查询
      • API - 退款
      • API - 退款查询
      • API - 支付取消
      • API - 获取iframe凭证
      • API - 解绑
      • API - 绑卡查询
      • API - 物流上传
      • API - 支付查询-POST
    • 通知
      • Notify - 支付结果通知
      • Notify - 退款结果通知
      • Notify - 绑卡结果通知
      • Notify - 争议结果通知
  • 附录
    • 返回码
    • 业务错误码
    • 订单状态
    • 国家编码
    • 州
    • 币种
    • 承运商
    • 资源下载
      • 插件
      • 对接 SDK - Java
      • 对接 SDK - Node
  1. 开始接入

支付完成同步跳转参数说明

用户在收银台完成支付后,会将用户浏览器重定向回商户下单时传入的成功回跳地址 redirect_url,并在跳转时携带本次支付的结果参数。本文说明 API - 支付 场景下同步跳转所携带的参数及其两种跳转方式。
同步跳转仅用于前端页面回显支付结果,不可作为商户发货或对账的最终依据。请以服务端接收到的异步通知(notification)或支付查询接口返回的结果为准。

跳转方式#

同步跳转支持 GET、POST 两种方式,具体采用哪种由商户维度的跳转配置决定:
跳转方式请求方式参数传递方式
GET 跳转(默认)GET参数以查询串形式拼接在 redirect_url 之后(?a=1&b=2),并保留商户下单时 redirect_url 上自带的原始参数
POST 跳转POST以表单(application/x-www-form-urlencoded)形式将下列参数 POST 提交到 redirect_url,不合并商户自带参数
说明:默认采用 GET 方式跳转。若商户需要 POST 方式跳转(如服务端接收表单的场景),可联系连连支付调整为 POST 跳转。

请求参数#

无论 GET 或 POST,跳转均携带以下业务参数:
参数名类型是否必需说明示例值
sign_typestring必需签名方式,固定为 RSARSA
merchant_idstring必需商户号202004070000395003
merchant_transaction_idstring必需商户支付交易 ID,即下单时传入的 merchant_transaction_id693100628120965120
order_currency_codestring必需下单币种USD
order_amountstring必需下单金额,单位元,保留 2 位小数88.88
payment_currency_codestring必需支付币种USD
payment_amountstring必需支付金额,单位元,保留 2 位小数88.88
payment_statusstring必需支付订单状态,如 PS 表示支付成功,完整取值详见订单状态说明文档PS
signaturestring必需签名值,商户侧使用连连全球收单配置的对应公钥验签XJxQTCs1QTsp+Xo3...

签名与验签说明#

签名构建因子为除 signature 外的所有业务参数。
连连全球收单使用商户配置的 RSA 私钥对参数进行签名,商户侧使用对应的公钥验签,验签通过后方可信任跳转参数。
关于签名因子的排序与拼接规则,请参考API 签名组装规则。
安全提醒:payment_status 等参数在浏览器跳转过程中可被篡改,商户务必完成验签,切勿在未验签的情况下直接依据跳转参数更新订单状态。

示例#

GET 方式#

参数拼接在 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...

POST 方式(默认)#

以表单形式 POST 提交到 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..."
}
上一页
API 签名组装规则
下一页
收银台流程说明