版本：1.1.1

SaaS 码类交易接口文档

1. 简介

给合作方提供码类交易以及关联的后续交易相关接口

请求地址，请求头信息参看文档: saas公共请求及响应参数-3. 请求公共参数信息

响应头信息参看文档: saas公共请求及响应参数-4. 响应公共参数信息

2.业务接口

2.1 预下单

介绍:用于预先创建订单,后传入订单编号等信息发起【钱包支付】场景

接口地址: /saas/qrcode

字段名	类型	是否必传	字段名称	说明
interfaceVersion	String	是	版本号	默认值:1.0.0
language	String	否	语言	语言(zh_CN,zh_TW,en_US)默认取值:zh_CN
interfaceName	String	是	接口名称	填写:`preOrder`
businessType	String	是	业务类型	填写:`qrcode`
orgNo	String	是	机构编号
orgCertId	String	是	机构密钥证书序列号
signature	String	是	机构签名
signMethod	String	是	机构签名方法	取值范围:RSA-SHA256,ECDSA-SHA256,HMAC-SHA256

请求参数

字段名

类型

是否必传

字段名称

说明

merchant

字段名	类型	是否必传	字段名称	说明
merchantNo	String	是	商户号
productNo	String	否	产品编号	参考附录-枚举字典 1 产品编码 ProductNo

Object

是

商户对象信息

order

字段名	类型	是否必传	字段名称	说明
externalOrderNo	String	是	商家订单号（外部订单号）	调用方根据自身业务规则生成唯一的订单号
amount	String	是	订单金额	默认单位为人民币的"元"，支持小数点后两位（即精确到"分"）。当涉及其他币种时，单位会根据币种的不同而变化。例如：人民币（CNY）：单位为"元" 美元（USD）：单位为"美元" 欧元（EUR）：单位为"欧元" 港币（HKD）：单位为"港元"
tipAmount	String	否	小费金额	参考订单金额说明
currency	String	是	币种	参考附录-枚举字典 12 币种 Currency
orderDetails	String	是	订单详情	例如："饼干一包,水果一袋"
externalAdditionalData	String	否	外部附加数据	传入业务方自定义订单参数，JSON格式

Object

是

订单对象信息

Curl请求示例

curl --location '${PAYMENT_DOMAIN}/saas/qrcode' \
--header 'businessType: qrcode' \
--header 'interfaceName: preOrder' \
--header 'interfaceVersion: 1.0.0' \
--header 'language: zh_CN' \
--header 'orgNo: S**************' \
--header 'orgCertId: ****************************************' \
--header 'signature: NA6auJMyYbFnqyW+BQPs2zBYp2Ql8Ge5ZfQA39/ccYLlNo5gJrKrma1R7qKury9o38Pz7vMm49hY8rkVk1RT7xf8PcxI7YLx/Qrj558j8XsOoFQvplIO3pnqWGrVIXJIE6myj2uXcWRHZ7HMsL3lMVJP0pk3tQiu+OGlcDU9A7k3IXW5uGffoTT2IWcjumB4LWauTN6NQIeEWMWcZaNgyNnkQUXadwjetElDYz9QyliwkVkEfM3p+ADOT4ASMDFWYqKWwdzbLQ+8z4uz3ZYpqIOsqbBu4xKanN6bk8a1pjtcvm0yARfIIKD3BjW6+jX7DxROKpM1jkWTOADbR9yWfQ==' \
--header 'signMethod: RSA-SHA256' \
--header 'Content-Type: application/json' \
--data '{
    "requestId": "S**************_20250722074708479_d3",
    "requestTime": "2025-07-22T07:47:08.479+08:00",
    "nonceStr": "Shk8Z7KCSzFk7Wtg46lrsqL3hBj7lZg2",
    "data": {
        "merchant": {
            "merchantNo": "**********",
            "productNo": "C102"
        },
        "order": {
            "externalOrderNo": "EXT_ORDER_20250722154708",
            "amount": "3500.00",
            "tipAmount": "120.00",
            "currency": "HKD",
            "orderDetails": "饼干一包,水果一袋"
        }
    }
}'

响应参数

字段名

类型

是否必传

字段名称

说明

order

字段名	类型	是否必传	字段名称	说明
orderNo	String	是	平台订单号
externalOrderNo	String	否	商家订单号（外部订单号）	调用方根据自身业务规则生成唯一的订单号
amount	String	是	订单金额
tipAmount	String	否	小费金额
authorizeAmount	decimal	否	授权金额
currency	String	是	币种	参考附录-枚举字典 12 币种 Currency
orderStatus	String	是	订单状态	参考附录-枚举字典 2 订单状态 OrderStatus
externalAdditionalData	String	否	外部附加数据	返回业务方自定义订单参数原值，JSON格式

Object

是

订单对象信息

响应Headers数据示例：

signature: YYr2KEbovzSKTK6lZhTI7OBDqr2BPwOnRYnKoHz/iU0spIaiUx7cNyOgTwNTYbIoXqPD22FokPxuams3alIfx4HxfynKuhVNkdF62mkqU9r9JalglF3/2gcmHh1cAGq9BYVoTADXicsylKszG8Vmp7u2W3vAHWwRpEm3LYuia6od9rrmrjIih6rlVVvIJTd4aKsVYCsIhvNsU14F/ja2lxpBRLksEwkGAPw7s3ElPpoLHThiWh9DG7cvlM9CvQBF7ltpq1y70Yr99WB9V1r6KU3JaWsN5N9ol7pdY/Hr3Xz1nrjU952Giqm/qBUviZy2s2NjwpNhsXotsOPAJHwHSA==
orgCertId: ****************************************
signMethod: RSA-SHA256

响应Body数据示例

{
  "requestId": null,
  "requestTime": null,
  "responseTime": "2025-07-22T07:47:17.546+00:00",
  "respCode": 200,
  "respMsg": "success",
  "busCode": null,
  "busMsg": null,
  "busSubCode": null,
  "busSubMsg": null,
  "data": {
    "order": {
      "externalOrderNo": "EXT_ORDER_20250722154708",
      "orderNo": "10820250722000011214",
      "amount": "3500.00",
      "tipAmount": "120.00",
      "currency": "HKD",
      "orderStatus": "01"
    }
  }
}

2.2 主扫

介绍:商家系统生成收款二维码并展示给用户,用户打开对应的支付App,主动扫描商家的二维码完成支付

接口地址: /saas/qrcode

字段名	类型	是否必传	字段名称	说明
interfaceVersion	String	是	版本号	默认值:1.0.0
language	String	否	语言	语言(zh_CN,zh_TW,en_US)默认取值:zh_CN
interfaceName	String	是	接口名称	填写:`CScanB`
businessType	String	是	业务类型	填写:`qrcode`
orgNo	String	是	机构编号
orgCertId	String	是	机构密钥证书序列号
signature	String	是	机构签名
signMethod	String	是	机构签名方法	取值范围:RSA-SHA256,ECDSA-SHA256,HMAC-SHA256

主扫请求参数

字段名

类型

是否必传

字段名称

说明

merchant

字段名	类型	是否必传	字段名称	说明
merchantNo	String	是	商户号
productNo	String	是	产品编号	参考附录-枚举字典 1 产品编码 ProductNo

Object

是

商户对象信息

transaction

字段名	类型	是否必传	字段名称	说明
merchantSerialNo	String	是	商户流水号	调用方根据自身业务规则生成唯一的交易流水号
amount	String	是	支付金额	默认单位为人民币的“元”，支持小数点后两位（即精确到“分”）。当涉及其他币种时，单位会根据币种的不同而变化。例如：人民币（CNY）：单位为“元” 美元（USD）：单位为“美元” 欧元（EUR）：单位为“欧元” 港币（HKD）：单位为“港元”
tipAmount	String	否	小费金额	参考支付金额说明
currency	String	是	币种	参考附录-枚举字典 12 币种 Currency
paymentSubType	String	是	交易子类型	参考附录-枚举字典 7 支付子类型 PaymentSubType
notifyUrl	String	否	交易结果通知地址	交易完成后，系统向该地址发送交易结果通知
externalAdditionalData	String	否	外部附加数据	传入业务方自定义交易参数，JSON格式

Object

是

支付单信息

Curl请求示例

curl --location '${PAYMENT_DOMAIN}/saas/qrcode' \
--header 'businessType: qrcode' \
--header 'interfaceName: CScanB' \
--header 'interfaceVersion: 1.0.0' \
--header 'language: zh_CN' \
--header 'orgNo: S**************' \
--header 'orgCertId: ****************************************' \
--header 'signature: MHrkx3rnZYVwZkKzFoWTVmJm5grhIM4qlWejwe9JZ20SsSk2WUer4QOYFW8n8dYDZ2Hx9gCpw/+4AddfDSQhFzz56Uy0OVS+hHT2OYfpsEyWZ3qqZAufdZPy4wGLwushul64TrDtQTTxXS3TeqdYCr12Om2pcuRl2UjSJVGicphOheJ/ionEHnqcaRm+H0VGjd8Iqf9B/lTEH5jVt3KZ7o+XLt8Sf0BANKfYSoHTewiyXJ9rwC7tbAF4QgfFJaD6zMzHWBQ3QDsWAEpRDzbYHOQM5YUV+2MuMXTDvCSlwIOu7Q2RRxURx+UI1TFTJYijenDsJb6aYcwVrhUJMxeACQ==' \
--header 'signMethod: RSA-SHA256' \
--header 'Content-Type: application/json' \
--data '{
    "requestId": "S**************_20250722081933363_95",
    "requestTime": "2025-07-22T08:19:33.363+08:00",
    "nonceStr": "9j800IuHM16FG3dGhdENBADw8uMhMOFV",
    "data": {
        "merchant": {
            "merchantNo": "**********",
            "productNo": "C102"
        },
        "transaction": {
            "merchantSerialNo": "MERCHANT_SERIAL_20250722161933",
            "amount": "1.00",
            "tipAmount": "0.00",
            "currency": "HKD",
            "paymentSubType": "09",
            "notifyUrl": "https://example.com/notify"
        }
    }
}'

响应参数

字段名

类型

是否必传

字段名称

说明

transaction

字段名	类型	是否必传	字段名称	说明
transactionNo	String	是	支付流水号
originalTransactionNo	String	否	原支付流水号
merchantSerialNo	String	否	商户流水号
amount	decimal	是	支付金额	单位：元
tipAmount	decimal	否	小费金额	单位：元
currency	String	是	币种	参考附录-枚举字典 12 币种 Currency
status	String	是	支付单状态	参考附录-枚举字典 11 交易状态 TransactionStatus
orderNo	String	是	平台订单号	平台方生成的订单号信息
externalOrderNo	String	否	外部订单号（商家订单号）
refundAmount	decimal	否	退款金额	单位：元
transactionType	String	是	交易类型	参考附录-枚举字典 3 交易类型 TransactionType
paymentWay	String	是	支付方式	参考附录-枚举字典 5 支付方式 PaymentWay
authCode	String	否	授权码
responseCode	String	否	主码
responseMessage	String	否	主码说明
completionTime	timestamp	否	交易完成时间
transactionTime	timestamp	是	交易时间
transactionZoneUTCTime	timestamp	是	交易时区时间
transactionZoneId	String	是	时区	交易时区例：Asia/Shanghai
timeZoneFlag	Integer	是	时区标识	时区标识：0.标准时间，1.夏令时
qrURL	String	是	扫码链接地址
externalAdditionalData	String	否	外部附加数据	返回业务方自定义交易参数原值，JSON格式

Object

是

支付单对象

响应Headers数据示例：

signature: AzSjQ7qbTYlyZ9Ae+KcYdikWssh+DFUJg6t/WxK6U/DOu6177La59zHqr/UcpKVLq7fm6R6kKy5cC2zxDms9+/QkXqYNxK06aKRSRD0qdg81ixH7YQXdeqoM2x/WPGtAfCjlHMstP0NDDmSOz7AUv35K6gyj4WlHkZn4satnCwJ+GUCoHDJnqhMw7geqPuvevQ4kulsyzdJEyfQ5hJLhwkeqK9FhL3GVhLNGqSn1iVzK6C3kbE3E85lrAP9lJyKSqhqJLRyta3Uzp5oKMAlMuEU8a7oJtkm7KtQenA8Z39PpmHeIYAYJ4MWueqdr7gN+Ruxtgvsu4dsRcrM2qAZDIg==
orgCertId: ****************************************
signMethod: RSA-SHA256

响应Body数据示例

{
  "requestId": null,
  "requestTime": null,
  "responseTime": "2025-07-22T08:19:44.863+00:00",
  "respCode": 200,
  "respMsg": "success",
  "busCode": null,
  "busMsg": null,
  "busSubCode": null,
  "busSubMsg": null,
  "data": {
    "transaction": {
      "merchantNo": "**********",
      "merchantSerialNo": "MERCHANT_SERIAL_20250722161933",
      "amount": 1.00,
      "transactionNo": "TKCEE01701B100000844121737805824",
      "orderNo": "10820250722000011218",
      "refundAmount": 0.00,
      "tipAmount": 0.00,
      "currency": "HKD",
      "transactionType": "01",
      "paymentWay": "03",
      "status": "21",
      "responseCode": "200",
      "transactionTime": "2025-07-22T08:19:43.000+00:00",
      "transactionZoneUTCTime": "2025-07-22T16:19:43.000+08:00",
      "transactionZoneId": "Asia/Hong_Kong",
      "timeZoneFlag": 0,
      "qrURL": "weixin://wxpay/bizpayurl?pr=uvcC8Fuz1"
    }
  }
}

2.3 被扫

介绍:用户展示付款码(动态二维码/条形码),商家使用扫码枪或摄像头扫描用户的付款码完成支付。

接口地址: /saas/qrcode

字段名	类型	是否必传	字段名称	说明
interfaceVersion	String	是	版本号	默认值:1.0.0
language	String	否	语言	语言(zh_CN,zh_TW,en_US)默认取值:zh_CN
interfaceName	String	是	接口名称	填写:`BScanC`
businessType	String	是	业务类型	填写:`qrcode`
orgNo	String	是	机构编号
orgCertId	String	是	机构密钥证书序列号
signature	String	是	机构签名
signMethod	String	是	机构签名方法	取值范围:RSA-SHA256,ECDSA-SHA256,HMAC-SHA256

请求参数

字段名

类型

是否必传

字段名称

说明

merchant

字段名	类型	是否必传	字段名称	说明
merchantNo	String	是	商户号
productNo	String	是	产品编号	参考附录-枚举字典 1 产品编码 ProductNo

Object

是

商户对象信息

transaction

字段名	类型	是否必传	字段名称	说明
merchantSerialNo	String	是	商户交易流水号	调用方根据自身业务规则生成唯一的交易流水号
amount	String	是	支付金额	默认单位为人民币的"元"，支持小数点后两位（即精确到"分"）。当涉及其他币种时，单位会根据币种的不同而变化。例如：人民币（CNY）：单位为"元" 美元（USD）：单位为"美元" 欧元（EUR）：单位为"欧元" 港币（HKD）：单位为"港元"
tipAmount	String	否	小费金额	参考支付金额说明
currency	String	是	币种	参考附录-枚举字典 12 币种 Currency
paymentSubType	String	是	交易子类型	参考附录-枚举字典 7 支付子类型 PaymentSubType
authCode	String	是	授权码	即支付宝/微信/银联二维码的被扫支付必填
notifyUrl	String	否	交易结果通知地址	交易完成后，系统向该地址发送交易结果通知
externalAdditionalData	String	否	外部附加数据	传入业务方自定义交易参数，JSON格式

Object

是

订单对象信息

Curl请求示例

curl --location '${PAYMENT_DOMAIN}/saas/qrcode' \
--header 'businessType: qrcode' \
--header 'interfaceName: BScanC' \
--header 'interfaceVersion: 1.0.0' \
--header 'language: zh_CN' \
--header 'orgNo: S**************' \
--header 'orgCertId: ****************************************' \
--header 'signature: DOd0Fqe56lw0md0iyAyNYv2Nyvm2KjCjxnNkBtnzCr0qwDbWLv6t1pXUQoT+yH5khVLA0fmfz/prh9Y7USV2bGfMCIKRKd8Ib1+5as+5xVfevYzzqsIZ9sC9vF9DJF7tCYM/luFbRZNeNdGZuubEomZ6KSMDKRGBMnMBdfW5tdNg1LLBE2Pt44fgI66W6tXAbM7C3V3V5H3rnHHxvivcpmw68QC57XjQzb6wcKGKE+fVF9GsyS3uHyscL4eUcxDP575TZbgajyqavzq1hZ+DMix4Owp72W86ZJfHpqeiMspuxaFtYBDxfOXw/UB2VIkMrTeiuihXVtothngT1K3RWA==' \
--header 'signMethod: RSA-SHA256' \
--header 'Content-Type: application/json' \
--data '{
    "requestId": "S**************_20250722090019492_24",
    "requestTime": "2025-07-22T09:00:19.492+08:00",
    "nonceStr": "09CpLwGrUBVfkV4rbr2tj5xaD4FzGfC3",
    "data": {
        "merchant": {
            "merchantNo": "**********",
            "productNo": "C102"
        },
        "transaction": {
            "merchantSerialNo": "MERCHANT_SERIAL_20250722170019",
            "amount": "1.00",
            "tipAmount": "0.00",
            "currency": "HKD",
            "paymentSubType": "08",
            "authCode": "285247730575324428",
            "notifyUrl": "https://example.com/notify"
        }
    }
}'

响应参数

字段名

类型

是否必传

字段名称

说明

transaction

字段名	类型	是否必传	字段名称	说明
transactionNo	String	是	支付流水号
originalTransactionNo	String	否	原支付流水号
merchantSerialNo	String	否	商户流水号
amount	decimal	是	支付金额	单位：元
tipAmount	decimal	否	小费金额	单位：元
currency	String	是	币种	参考附录-枚举字典 12 币种 Currency
status	String	是	支付单对象	参考附录-枚举字典 11 交易状态 TransactionStatus
orderNo	String	是	平台订单号	平台方生成的订单号信息
externalOrderNo	String	否	外部订单号	商家生成的订单号信息
refundAmount	decimal	否	退款金额	单位：元
transactionType	String	是	交易类型	参考附录-枚举字典 3 交易类型 TransactionType
paymentWay	String	是	支付方式	参考附录-枚举字典 5 支付方式 PaymentWay
authCode	String	否	授权码
responseCode	String	否	主码
responseMessage	String	否	主码说明
completionTime	timestamp	否	交易完成时间
transactionTime	timestamp	是	交易时间
transactionZoneUTCTime	timestamp	是	交易时区时间
transactionZoneId	String	是	时区	交易时区例：Asia/Shanghai
timeZoneFlag	Integer	是	时区标识	时区标识：0.标准时间，1.夏令时
externalAdditionalData	String	否	外部附加数据	返回业务方自定义交易参数原值，JSON格式

Object

是

支付单对象

响应Headers数据示例：

signature: IZR118+qyyz8BdqAOtddWSmX2FA8K3sm8PPW5M2PISk+Vs0AYyq/FXCu3Y4wgL4eJDq/KCrQbUSQkfPHzg/i5aJcUUtKzhQseTIBEN2+6VX6+iOnhNVMHeMU5dFuXNDW+dIvMcKcCqygJHsm2psiZ3w8f0oGBEhHPLrhglHXvpsHL7jWHfXOhjvr3CBiLmMAIliauTWH450RRCRGCJOIc5oZ4yEUzwsYa/LPUu45L4jtTHvE2XCnW6D6RIanS6OyulmqTI8JBI8f6mk41xauVp0jvmUgIfdPDAvNFKMfqwgPwkWH2OyENzSxvKJNqxBKM8upop5zhC9E6o9BPqurtQ==
orgCertId: ****************************************
signMethod: RSA-SHA256

响应Body数据示例

{
  "requestId": null,
  "requestTime": null,
  "responseTime": "2025-07-22T09:00:41.925+00:00",
  "respCode": 200,
  "respMsg": "success",
  "busCode": null,
  "busMsg": null,
  "busSubCode": null,
  "busSubMsg": null,
  "data": {
    "transaction": {
      "amount": 1,
      "authCode": "285247730575324428",
      "completionTime": "2025-07-22T08:52:35.000+00:00",
      "currency": "HKD",
      "merchantNo": "**********",
      "merchantSerialNo": "2512351894926822",
      "orderNo": "10820250722000011224",
      "paymentWay": "03",
      "refundAmount": 0,
      "responseCode": "200",
      "status": "00",
      "timeZoneFlag": 0,
      "tipAmount": 0,
      "transactionNo": "TK2CD22B7BD100000844222702354432",
      "transactionTime": "2025-07-22T08:52:31.000+00:00",
      "transactionType": "01",
      "transactionZoneId": "Asia/Hong_Kong",
      "transactionZoneUTCTime": "2025-07-22T16:52:31.000+08:00"
    }
  }
}

2.4 钱包支付

介绍:支持多种在线支付场景,如微信 H5、支付宝 APP 等,需根据不同的交易场景类型传入相应的支付对象信息

接口地址: /saas/qrcode

字段名	类型	是否必传	字段名称	说明
interfaceVersion	String	是	版本号	默认值:1.0.0
language	String	否	语言	语言(zh_CN,zh_TW,en_US)默认取值:zh_CN
interfaceName	String	是	接口名称	填写:`online`
businessType	String	是	业务类型	填写:`qrcode`
orgNo	String	是	机构编号
orgCertId	String	是	机构密钥证书序列号
signature	String	是	机构签名
signMethod	String	是	机构签名方法	取值范围:RSA-SHA256,ECDSA-SHA256,HMAC-SHA256

请求参数

字段名

类型

是否必传

字段名称

说明

merchant

字段名	类型	是否必传	字段名称	说明
merchantNo	String	是	商户号
productNo	String	是	产品编号	参考附录-枚举字典 1 产品编码 ProductNo

Object

是

商户对象信息

order

字段名

类型

是否必传

字段名称

说明

externalOrderNo

String

是

外部订单号（商家订单号）

调用方根据自身业务规则生成唯一的订单号

amount

String

是

订单金额

默认单位为人民币的"元"，支持小数点后两位（即精确到"分"）。当涉及其他币种时，单位会根据币种的不同而变化。
例如：人民币（CNY）：单位为"元"
美元（USD）：单位为"美元"
欧元（EUR）：单位为"欧元"
港币（HKD）：单位为"港元"

currency

String

是

币种

参考附录-枚举字典 12 币种 Currency

orderDetails

String

是

订单详情

例如："饼干一包,水果一袋"

externalAdditionalData

String

否

外部附加数据

传入业务方自定义订单参数，JSON格式

goodsDetails

字段名	类型	是否必传	字段名称
sku	String	是	商品编号
productName	String	是	商品名称
price	Number	是	商品单价
quantity	Number	是	商品购买数量
productImage	String	否	商品图片URL
productUrl	String	否	商品链接URL

Array

否

商品信息列表

支付宝PC，APP，H5支付时选填

Object

是

订单对象信息

transaction

字段名

类型

是否必传

字段名称

说明

merchantSerialNo

String

否

外部流水号（商户交易流水号）

调用方根据自身业务规则生成唯一的交易流水号

amount

String

是

支付金额

跟预下单时的订单金额amount保持一致

currency

String

是

币种

参考附录-枚举字典 12 币种 Currency

transactionSceneType

String

是

交易场景类型

参考附录-枚举字典 4 交易场景类型 transactionSceneType

saasWechatPayVo

字段名	类型	是否必传	字段名称	说明
openId	String	否	微信openId	微信小程序，微信公众号必填
mchIp	String	否	终端ip	微信app，公众号必填
subAppid	String	否	微信子APPID	微信app，公众号，小程序必填

Object

否

微信支付对象

微信app，微信h5，微信小程序，微信公众号必填

saasAliPayVo

字段名

类型

是否必传

字段名称

说明

returnUrl

String

是

支付完成后跳转url

支付宝APP，H5支付时必填

referUrl

String

是

商户网站地址

支付宝PC，APP，H5支付时必填

paymentInstitution

String

选填

付款机构

支付宝PC、APP、H5支付时必填。香港支持ALIPAYHK，ALIPAYCN；新加坡支持ALIPAYCN,ALIPAYHK,KAKAPAY,TNG,GCASH,TRUEMONEY 参考附录-枚举字典 2.13 钱包类型

supplier

String

否

供应商户的名称

支付宝H5支付时选填

appenv

String

否

app运行环境

支付宝APP支付时必填；Example:appenv="system=android^version=3.0.1.2"

osType

String

否

系统类型

支付宝H5支付和新加坡支付宝APP支付必填（仅新加坡区域商户适用）取值支持：IOS（指示支付侧环境为IOS系统）ANDROID（指示支付侧环境为安卓系统）

tradeInformation

字段名	类型	是否必传	字段名称	说明
businessType	String	是	业务类型	1: 酒店2: 航空3: 留学咨询4:商品销售5: 其他所有的业务类型除了以下4类. 例如, 手机数据服务管理,接机服务, etc；多个业务类型，用(\|)隔开
hotelName	String	否	酒店名字	当businessType为1时，必须填写；多个hotel_name用(\|)隔开；例如：test-01\| test-02\|test-03
checkInTime	String	否	入住时间	格式：yyyy-MM-dd，时区：GMT +8；当businessType为1时，必须填写；例如：2018-10-22
checkOutTime	String	否	退房时间	格式：yyyy-MM-dd，时区：GMT +8； *当Business type为1时，必须填写；例如：2018-10-22
flightNumber	String	否	航班号	当businessType为2时, 必须填写；多个航班号用(\|)隔开；例如:test-01\|test-02
departureTime	String	否	起飞时间	格式：yyyy-MM-dd HH:mm，时区：GMT +8；当business_type为2时, 必须填写；例如：2018-10-22
admissionNoticeUrl	String	否	录取通知书地址	当businessType为3时，必须填写；
goodsInfo	String	否	商品信息	当businessType为4时，必须填写；名称^数量，多个商品存在的时候，用(\|)隔开；例如：Example:pencil^2\|eraser^5\|pen^2
totalQuantity	String	否	商品重量	当businessType为4时，必须填写；例如：8
otherBusinessType	String	否	其他业务类型	当business_type为5时，必须填写；例如：Airport pick up service

Object

否

支付宝交易信息

支付宝PC，APP，H5支付时填

Object

否

支付宝对象

支付宝H5，支付宝app必填

notifyUrl

String

否

交易结果通知地址

交易完成后，系统向该地址发送交易结果通知

externalAdditionalData

String

否

外部附加数据

传入业务方自定义交易参数，JSON格式

Object

是

支付单对象信息

Curl请求示例

支付宝H5：

curl --location '${PAYMENT_DOMAIN}/saas/qrcode' \
--header 'businessType: qrcode' \
--header 'interfaceName: online' \
--header 'interfaceVersion: 1.0.0' \
--header 'language: zh_CN' \
--header 'orgNo: S**************' \
--header 'orgCertId: ****************************************' \
--header 'signature: KXrOy00ywC9OgYjV4pONz6DgcjuMoKM8am19BfQNVYbhY1rPrW9DDpMdjk5Zj3I2iXw6aZq4YxpYM7MxJkIDTLwAtLS1d2+aLrB8YZ8isPYd0E8qNXwD7Pc2GAg0wwDMIv6mzIfSc8xLLGo2klBACsURwdb1ut+A6MMhKaS8X29X9McwqXLw6YLEn5Pwt3ANuOLphZjWsumAyb9jQ+IcMBZWFfS9h561vn6bvYagz1Q3bj0twEGjEuhUovmFgcgJOeMlBeW8SR0nWW19ijyhfZLqy+qVHIGOOW2QtBX9BT1C2QJ8PAGgWWr+Gz9VNOVMFwsLSU6mFcTq9QJfJl0B6g==' \
--header 'signMethod: RSA-SHA256' \
--header 'Content-Type: application/json' \
--data '{
    "requestId": "S**************_20250722091723679_fa",
    "requestTime": "2025-07-22T09:17:23.679+08:00",
    "nonceStr": "oBDtqZ2g7sfgAo2xpWebhelqrn81uifI",
    "data": {
        "merchant": {
            "merchantNo": "**********",
            "productNo": "C201"
        },
        "order": {
            "externalOrderNo": "EXT_ORDER_20250722171723",
            "amount": "1.00",
            "currency": "HKD",
            "orderDetails": "饼干一包,水果一袋",
            "externalAdditionalData":"订单附加信息"
        },
        "transaction": {
            "amount": "1.00",
            "currency": "HKD",
            "transactionSceneType": "41",
            "paymentSubType": "08",
            "saasAliPayVo": {
                "returnUrl": "https://www.baidu.com/",
                "referUrl": "https://www.baidu.com/",
                "osType": "ANDROID",
                "supplier": "支付宝h5测试",
                "paymentInstitution": "ALIPAYCN",
                "tradeInformation": {
                    "businessType": "1",
                    "hotelName": "test-01",
                    "checkInTime": "2025-08-13",
                    "checkOutTime": "2025-08-31"
                }
            },
            "notifyUrl": "https://example.com/notify"
        }
    }
}'

微信H5：

curl --location '${PAYMENT_DOMAIN}/saas/qrcode' \
--header 'businessType: qrcode' \
--header 'interfaceName: online' \
--header 'interfaceVersion: 1.0.0' \
--header 'language: zh_CN' \
--header 'orgNo: S**************' \
--header 'orgCertId: ****************************************' \
--header 'signature: KXrOy00ywC9OgYjV4pONz6DgcjuMoKM8am19BfQNVYbhY1rPrW9DDpMdjk5Zj3I2iXw6aZq4YxpYM7MxJkIDTLwAtLS1d2+aLrB8YZ8isPYd0E8qNXwD7Pc2GAg0wwDMIv6mzIfSc8xLLGo2klBACsURwdb1ut+A6MMhKaS8X29X9McwqXLw6YLEn5Pwt3ANuOLphZjWsumAyb9jQ+IcMBZWFfS9h561vn6bvYagz1Q3bj0twEGjEuhUovmFgcgJOeMlBeW8SR0nWW19ijyhfZLqy+qVHIGOOW2QtBX9BT1C2QJ8PAGgWWr+Gz9VNOVMFwsLSU6mFcTq9QJfJl0B6g==' \
--header 'signMethod: RSA-SHA256' \
--header 'Content-Type: application/json' \
--data '{
    "requestId": "S**************_20250722091723679_fa",
    "requestTime": "2025-07-22T09:17:23.679+08:00",
    "nonceStr": "oBDtqZ2g7sfgAo2xpWebhelqrn81uifI",
    "data": {
        "merchant": {
            "merchantNo": "**********",
            "productNo": "C201"
        },
        "order": {
            "externalOrderNo": "EXT_ORDER_20250722171723",
            "amount": "1.00",
            "currency": "HKD",
            "orderDetails": "饼干一包,水果一袋",
            "externalAdditionalData":"订单附加信息"
        },
        "transaction": {
            "amount": "1.00",
            "currency": "HKD",
            "transactionSceneType": "39",
            "paymentSubType": "09",
            "saasWechatPayVo": {
                "mchIp": "1.202.216.194"
            },
            "notifyUrl": "https://example.com/notify"
        }
    }
}'

响应参数

字段名

类型

是否必传

字段名称

说明

transaction

字段名	类型	是否必传	字段名称	说明
transactionNo	String	是	支付流水号
originalTransactionNo	String	否	原支付流水号
merchantSerialNo	String	否	商户流水号
amount	decimal	是	支付金额	单位：元
tipAmount	decimal	否	小费金额	单位：元
currency	String	是	币种
status	String	是	支付单状态	参考附录-枚举字典 11 交易状态 TransactionStatus
orderNo	String	是	订单号
externalOrderNo	String	否	外部订单号
refundAmount	decimal	否	退款金额	单位：元
transactionType	String	是	交易类型	参考附录-枚举字典 3 交易类型 TransactionType
paymentWay	String	是	支付方式	参考附录-枚举字典 5 支付方式 PaymentWay
authCode	String	否	授权码
responseCode	String	否	主码
responseMessage	String	否	主码说明
completionTime	timestamp	否	交易完成时间
transactionTime	timestamp	是	交易时间
transactionZoneUTCTime	timestamp	是	交易时区时间
transactionZoneId	String	是	时区	交易时区例：Asia/Shanghai
timeZoneFlag	Integer	是	时区标识	时区标识：0.标准时间，1.夏令时
payInfo	String	是	支付信息	详细信息见下方示例
externalAdditionalData	String	否	外部附加数据	返回业务方自定义交易参数原值，JSON格式

Object

是

支付单对象

响应Headers数据示例：

signature: QYP9LNuhDkC1miPFaM5LSjPFsCwLeHL0VXMg83XK0gNDXBBA7kZFx+DWx4VA2+f8BRNynE1c0Lt9vtxgQc79eHkVwAyPUU8lVY3fkv5A7wpnwBP6uSMleFMS20otkcqCWGon5FsLs95Dxk8WvfUv4GRKHd2ByIarosJsD4VTagamsZVbY/tUJPhoVWYTZ7jbNb1l8Ap9oo+wyWPsN6LnHTQsalTaqOTdmKbpNdgkmeuYExptykGl4AEeJJ5n6GpJygwNP6ro9N3NacYITXH2gnWMeAOhJiN2imqDkgDE2YwpMi2advABQ7GR8VUwKbaVK7CzGcu91PY/2sMKZuLlRA==
orgCertId: ****************************************
signMethod: RSA-SHA256

响应Body数据示例

支付宝H5：

说明：支付宝H5返回的payInfo字段为JSON Str格式参数，需要组装为form表单发起支付，请求地址为action 对应的参数，请求方法为method对应参数。注意表单数据除去action和method字段后(_input_charset有没有都不影响) 要与返回信息完全一致，否则支付宝签名验证失败:ILLEGAL_SIGN ~~，参考示例：alipayDemo.html~~ 。

{
  "requestId": null,
  "requestTime": null,
  "responseTime": "2025-07-22T09:00:41.925+00:00",
  "respCode": 200,
  "respMsg": "success",
  "busCode": null,
  "busMsg": null,
  "busSubCode": null,
  "busSubMsg": null,
  "data": {
    "payInfo": "{\"secondary_merchant_industry\":\"5655\",\"payment_inst\":\"ALIPAYCN\",\"method\":\"post\",\"_input_charset\":\"UTF-8\",\"subject\":\"随行付测试商户\",\"refer_url\":\"https://www.baidu.com/\",\"sign\":\"a8842ec37a5d59055b97931ba91164c2\",\"body\":\"chothes\",\"notify_url\":\"https://test.allinpayhk.com/gateway/api/notify/alipayNotify\",\"product_code\":\"NEW_WAP_OVERSEAS_SELLER\",\"secondary_merchant_id\":\"888000000015161876\",\"out_trade_no\":\"2025032011143950\",\"partner\":\"2088021966645500\",\"timeout_rule\":\"30m\",\"service\":\"create_forex_trade_wap\",\"trade_information\":\"{\\\"check_in_time\\\":\\\"2018-10-20\\\",\\\"business_type\\\":\\\"1\\\",\\\"check_out_time\\\":\\\"2018-10-22\\\",\\\"hotel_name\\\":\\\"test-01\\\"}\",\"supplier\":\"支付宝h5测试\",\"total_fee\":\"1.01\",\"secondary_merchant_name\":\"通华商城-跳转测试\",\"return_url\":\"https://www.baidu.com/\",\"action\":\"https://api-sea-global.alipayplus.com/gateway.do?_input_charset=UTF-8\",\"currency\":\"HKD\",\"sign_type\":\"MD5\"}",
    "transaction": {
      "amount": 100.0,
      "completionTime": 1742441942000,
      "currency": "HKD",
      "externalOrderNo": "ORDER_1742441813580d435d62d2c544",
      "orderNo": "10820250320000005149",
      "paymentWay": "03",
      "refundAmount": 0.0,
      "responseCode": "200",
      "status": "21",
      "timeZoneFlag": 0,
      "tipAmount": 1.0,
      "transactionNo": "TKAE17D380AD00000628731768750080",
      "transactionTime": 1742441942000,
      "transactionType": "01",
      "transactionZoneId": "Asia/Hong_Kong",
      "transactionZoneUTCTime": 1742413142000
    }
  }
}

微信H5：

说明：微信H5支付返回的payInfo为跳转链接，需要在报备给微信的地址页面上，前端用js方法window.location.href跳转，请商户自行处理跳转，注意需要携带原页面的origin及reference参数供微信进行权限验证。

{
  "requestId": null,
  "requestTime": null,
  "responseTime": "2025-07-22T09:00:41.925+00:00",
  "respCode": 200,
  "respMsg": "success",
  "busCode": null,
  "busMsg": null,
  "busSubCode": null,
  "busSubMsg": null,
  "data": {
    "payInfo": "https://wx.tenpay.com/cgi-bin/mmpayweb-bin/checkmweb?prepay_id=wx18202217738298801a5efe989a35090001&package=3164057218",
    "transaction": {
      "amount": 100.0,
      "completionTime": 1742441942000,
      "currency": "HKD",
      "externalOrderNo": "ORDER_1742441813580d435d62d2c544",
      "orderNo": "10820250320000005149",
      "paymentWay": "03",
      "refundAmount": 0.0,
      "responseCode": "200",
      "status": "21",
      "timeZoneFlag": 0,
      "tipAmount": 1.0,
      "transactionNo": "TKAE17D380AD00000628731768750080",
      "transactionTime": 1742441942000,
      "transactionType": "01",
      "transactionZoneId": "Asia/Hong_Kong",
      "transactionZoneUTCTime": 1742413142000
    }
  }
}

2.5 撤销

介绍:用于对已完成的交易进行撤销,撤销会将交易金额全额返回给客户

接口地址: /saas/qrcode

字段名	类型	是否必传	字段名称	说明
interfaceVersion	String	是	版本号	默认值:1.0.0
language	String	否	语言	语言(zh_CN,zh_TW,en_US)默认取值:zh_CN
interfaceName	String	是	接口名称	填写:`revoke`
businessType	String	是	业务类型	填写:`qrcode`
orgNo	String	是	机构编号
orgCertId	String	是	机构密钥证书序列号
signature	String	是	机构签名
signMethod	String	是	机构签名方法	取值范围:RSA-SHA256,ECDSA-SHA256,HMAC-SHA256

请求参数

字段名

类型

是否必传

字段名称

说明

merchant

字段名	类型	是否必传	字段名称	说明
merchantNo	String	是	商户号

Object

是

商户对象信息

transaction

字段名	类型	是否必传	字段名称	说明
merchantSerialNo	String	是	商户交易流水号	调用方根据自身业务规则生成唯一的交易流水号
transactionNo	String	是	原交易流水号
notifyUrl	String	否	交易结果通知地址	交易完成后，系统向该地址发送交易结果通知
externalAdditionalData	String	否	外部附加数据	传入业务方自定义交易参数，JSON格式

Object

是

订单对象信息

Curl请求示例

curl --location '${PAYMENT_DOMAIN}/saas/qrcode' \
--header 'businessType: qrcode' \
--header 'interfaceName: revoke' \
--header 'interfaceVersion: 1.0.0' \
--header 'language: zh_CN' \
--header 'orgNo: S**************' \
--header 'orgCertId: ****************************************' \
--header 'signature: F303YfKSXirtJUb+yn3l0j0B+cfG77Hn9nPVAHckxwfYzWzmL7eA7emLGTcimEQyLHW/hHSgkAijdY2SoqaLDArzjHWiSWhAIsvegptlGfCmoqnaRvSFkv/ApZMC7Ds0hXJP9OnnigdT90xZ3a6KOsHkKK86MSfCy4inlr1x18kR2mQb/XGX2TMCzRx2LgFwaHZTl3HmM0hZnAR2kuHQ7AIIwowDXaxLgiPcxMC6WAPvXKNuY7jLbHWXx5uhx7CpA/J+40/t5Bn3OzaisIZok/Vb3kDWuh6GCYrVKu/SL58nkeathEzEJERPXA4tXFEJsdeXPjpl5vy8kSBxcrRrKw==' \
--header 'signMethod: RSA-SHA256' \
--header 'Content-Type: application/json' \
--data '{
    "requestId": "S**************_20250722090512221_6e",
    "requestTime": "2025-07-22T09:05:12.221+08:00",
    "nonceStr": "38kOL4xca0VaUVOsPOInamg8XmEdUm0X",
    "data": {
        "merchant": {
            "merchantNo": "**********"
        },
        "transaction": {
            "transactionNo": "TK2CD22B7BD100000844222702354432",
            "merchantSerialNo": "MERCHANT_SERIAL_20250722170512",
            "notifyUrl": "https://example.com/notify"
        }
    }
}'

响应参数

字段名

类型

是否必传

字段名称

说明

transaction

字段名	类型	是否必传	字段名称	说明
transactionNo	String	是	支付流水号
originalTransactionNo	String	否	原支付流水号
merchantSerialNo	String	否	商户交易流水号
amount	decimal	是	支付金额	单位：元
tipAmount	decimal	否	小费金额	单位：元
currency	String	是	币种
status	String	是	支付单状态	参考附录-枚举字典 11 交易状态 TransactionStatus
orderNo	String	是	订单号
externalOrderNo	String	否	外部订单号
refundAmount	decimal	否	退款金额	单位：元
transactionType	String	是	交易类型	参考附录-枚举字典 3 交易类型 TransactionType
paymentWay	String	是	支付方式	参考附录-枚举字典 5 支付方式 PaymentWay
authCode	String	否	授权码
responseCode	String	否	主码
responseMessage	String	否	主码说明
completionTime	timestamp	否	交易完成时间
transactionTime	timestamp	是	交易时间
transactionZoneUTCTime	timestamp	是	交易时区时间
transactionZoneId	String	是	时区	交易时区例：Asia/Shanghai
timeZoneFlag	Integer	是	时区标识	时区标识：0.标准时间，1.夏令时
externalAdditionalData	String	否	外部附加数据	返回业务方自定义交易参数原值，JSON格式

Object

是

支付单对象

响应Headers数据示例：

signature: ls2MDvcy3SrQ12ysCPFErzoZu38R6G+cA5jKHaaAAUyHZ6ttCsNv2BZmBh9hE3e2GvpNAsetzkBb4q8ODkSywvQ/M1vj4+Y60osNc3csLp/Pf0GF6nkuzEgxncVkiek/XqzAFInbET9v0dwZVeaxI1GirzngaBdQCak3jPKgDwg+tv649HeAUnlb12JJUBtgr4xfs8XuBE6RjTTJCb7+oStvm1MGaaNGHU7MJcND1m3Wfjl7Nb5qjOdzlTU08kcflahvDTgDZNzg8PWnTlZSwiMRxCisPgNGTzUCgMpLI7kl6eJGE1HsCew/uqfRQ1zbDJGY6ylCU8xyAQJAFBDMmw==
orgCertId: ****************************************
signMethod: RSA-SHA256

响应Body数据示例

{
  "requestId": null,
  "requestTime": null,
  "responseTime": "2025-07-22T09:05:24.153+00:00",
  "respCode": 200,
  "respMsg": "success",
  "busCode": null,
  "busMsg": null,
  "busSubCode": null,
  "busSubMsg": null,
  "data": {
    "transaction": {
      "merchantNo": "**********",
      "merchantSerialNo": "MERCHANT_SERIAL_20250722170512",
      "amount": 1.00,
      "transactionNo": "TK76D7C7FAF100000844235318001664",
      "originalTransactionNo": "TK2CD22B7BD100000844222702354432",
      "orderNo": "10820250722000011224",
      "refundAmount": 0.00,
      "tipAmount": 0.00,
      "currency": "HKD",
      "transactionType": "02",
      "paymentWay": "03",
      "status": "00",
      "responseCode": "200",
      "transactionTime": "2025-07-22T09:05:21.000+00:00",
      "transactionZoneUTCTime": "2025-07-22T17:05:21.000+08:00",
      "transactionZoneId": "Asia/Hong_Kong",
      "timeZoneFlag": 0,
      "completionTime": "2025-07-22T09:05:24.000+00:00"
    }
  }
}

2.6 退款

介绍:用于对已完成的交易进行全额或部分退款

接口地址: /saas/qrcode

字段名	类型	是否必传	字段名称	说明
interfaceVersion	String	是	版本号	默认值:1.0.0
language	String	否	语言	语言(zh_CN,zh_TW,en_US)默认取值:zh_CN
interfaceName	String	是	接口名称	填写:`refund`
businessType	String	是	业务类型	填写:`qrcode`
orgNo	String	是	机构编号
orgCertId	String	是	机构密钥证书序列号
signature	String	是	机构签名
signMethod	String	是	机构签名方法	取值范围:RSA-SHA256,ECDSA-SHA256,HMAC-SHA256

请求参数

字段名

类型

是否必传

字段名称

说明

merchant

字段名	类型	是否必传	字段名称	说明
merchantNo	String	是	商户号

Object

是

商户对象信息

transaction

字段名	类型	是否必传	字段名称	说明
merchantSerialNo	String	是	商户交易流水号	调用方根据自身业务规则生成唯一的交易流水号
transactionNo	String	是	原交易流水号
amount	String	是	退款金额	默认单位为人民币的"元"，支持小数点后两位（即精确到"分"）。当涉及其他币种时，单位会根据币种的不同而变化。例如：人民币（CNY）：单位为"元" 美元（USD）：单位为"美元" 欧元（EUR）：单位为"欧元" 港币（HKD）：单位为"港元"
tipAmount	String	否	小费金额	参考小费金额说明
notifyUrl	String	否	交易结果通知地址	交易完成后，系统向该地址发送交易结果通知
externalAdditionalData	String	否	外部附加数据	传入业务方自定义交易参数，JSON格式

Object

是

订单对象信息

Curl请求示例

curl --location '${PAYMENT_DOMAIN}/saas/qrcode' \
--header 'businessType: qrcode' \
--header 'interfaceName: refund' \
--header 'interfaceVersion: 1.0.0' \
--header 'language: zh_CN' \
--header 'orgNo: S**************' \
--header 'orgCertId: ****************************************' \
--header 'signature: H/6mvGarqsONrrZibg0Ujy0kJ+JuzwfZwLQ2+EIdAEkNMh5OlHLCop5yut0JRllckVQAjwyj+5o9C1VWAxzOOql+pKqXixA1SRxEaHlSKUnD6isDZS6aShlPdDLP0/3KT98s3fS7Imq/XnKWHC8Tcz1Uv4iY+YvZprPQ/Phew7jBPYWT9eEqfWpLlnd/hdxudY9wheTsjJovKcn4mO8i+MEQjv9lZhgDS5lCnQAl636M5mkTqANpWTeju+j/f+jyZw5ZUSeZQuGBMJMDIW1MGinWf8K4efik59Bg9hbbPh2IS1MQ91s8+lDGUsdzMZthp4wuHB30p9UwOA9cUidVjQ==' \
--header 'signMethod: RSA-SHA256' \
--header 'Content-Type: application/json' \
--data '{
    "requestId": "S**************_20250722082845906_9b",
    "requestTime": "2025-07-22T08:28:45.906+08:00",
    "nonceStr": "mLp7E7NoE0pSOzIhBpz1HpctMenhbq2t",
    "data": {
        "merchant": {
            "merchantNo": "**********"
        },
        "transaction": {
            "transactionNo": "TKCEE01701B100000844121737805824",
            "merchantSerialNo": "MERCHANT_SERIAL_20250722162845",
            "amount": "1.00",
            "tipAmount": "0.00",
            "notifyUrl": "https://example.com/notify"
        }
    }
}'

响应参数

字段名

类型

是否必传

字段名称

说明

transaction

字段名	类型	是否必传	字段名称	说明
transactionNo	String	是	支付流水号
originalTransactionNo	String	否	原支付流水号
merchantSerialNo	String	否	商户交易流水号
amount	decimal	是	支付金额	单位：元
tipAmount	decimal	否	小费金额	单位：元
currency	String	是	币种
status	String	是	支付单对象	参考附录-枚举字典 11 交易状态 TransactionStatus
orderNo	String	是	订单号
externalOrderNo	String	否	外部订单号
refundAmount	decimal	否	退款金额	单位：元
transactionType	String	是	交易类型	参考附录-枚举字典 3 交易类型 TransactionType
paymentWay	String	是	支付方式	参考附录-枚举字典 5 支付方式 PaymentWay
authCode	String	否	授权码
responseCode	String	否	主码
responseMessage	String	否	主码说明
completionTime	timestamp	否	交易完成时间
transactionTime	timestamp	是	交易时间
transactionZoneUTCTime	timestamp	是	交易时区时间
transactionZoneId	String	是	时区	交易时区例：Asia/Shanghai
timeZoneFlag	Integer	是	时区标识	时区标识：0.标准时间，1.夏令时
externalAdditionalData	String	否	外部附加数据	返回业务方自定义交易参数原值，JSON格式

Object

是

支付单对象

响应Headers数据示例：

signature: FbDbbEXiqx7hQCE1r3FNaezaKSVuNv3AZoJSO05TY9s4mJ9c7rB4TY726vxQ/gvvm5M2T0pCa3vk2qtaZo44JrqiBIkAOQcutNkvq2JOROHiMZQ8kfVYf/IPyWXnbsScW0GPxBuVGUdAvnA0F35RmcVkZHQzJEgg42sl/pN6P6rqa2WsrypKpDjB29I7cY7eNffCel7Ra7PniFfN93607TCVLIQHOayEj871V6vtNGemUBM7C6hk/LFL9tiolDomuNH8K/TeOf4WN6s8BSD7aOofsabkWi2gKnYhWfL97MMwBW2+JMwVu60PhFMylE0YmaJUtcNrl3EuhmTtqiiJwg==
orgCertId: ****************************************
signMethod: RSA-SHA256

响应Body数据示例

{
  "requestId": null,
  "requestTime": null,
  "responseTime": "2025-07-22T08:29:10.125+00:00",
  "respCode": 200,
  "respMsg": "success",
  "busCode": null,
  "busMsg": null,
  "busSubCode": null,
  "busSubMsg": null,
  "data": {
    "transaction": {
      "merchantNo": "**********",
      "merchantSerialNo": "MERCHANT_SERIAL_20250722162845",
      "amount": 1.00,
      "transactionNo": "TKA7277CD02000000844130989211648",
      "originalTransactionNo": "TKCEE01701B100000844121737805824",
      "orderNo": "10820250722000011218",
      "refundAmount": 0.00,
      "tipAmount": 0.00,
      "currency": "HKD",
      "transactionType": "08",
      "paymentWay": "03",
      "status": "00",
      "responseCode": "200",
      "transactionTime": "2025-07-22T08:29:08.000+00:00",
      "transactionZoneUTCTime": "2025-07-22T16:29:08.000+08:00",
      "transactionZoneId": "Asia/Hong_Kong",
      "timeZoneFlag": 0,
      "completionTime": "2025-07-22T08:29:10.000+00:00"
    }
  }
}

2.7 关单

介绍:用于关闭交易订单使用

接口地址: /saas/qrcode

字段名	类型	是否必传	字段名称	说明
interfaceVersion	String	是	版本号	默认值:1.0.0
language	String	否	语言	语言(zh_CN,zh_TW,en_US)默认取值:zh_CN
interfaceName	String	是	接口名称	填写:`close`
businessType	String	是	业务类型	填写:`qrcode`
orgNo	String	是	机构编号
orgCertId	String	是	机构密钥证书序列号
signature	String	是	机构签名
signMethod	String	是	机构签名方法	取值范围:RSA-SHA256,ECDSA-SHA256,HMAC-SHA256

请求参数

字段名

类型

是否必传

字段名称

说明

merchant

字段名	类型	是否必传	字段名称	说明
merchantNo	String	是	商户号

Object

是

商户对象信息

transaction

字段名	类型	是否必传	字段名称	说明
transactionNo	String	选填	支付流水号	与商户流水号二选一
merchantSerialNo	String	选填	商户交易流水号	与支付流水号二选一（调用方根据自身业务规则生成唯一的交易流水号）
externalAdditionalData	String	否	外部附加数据	传入业务方自定义交易参数，JSON格式

Object

是

支付单对象信息

Curl请求示例

curl --location '${PAYMENT_DOMAIN}/saas/qrcode' \
--header 'businessType: qrcode' \
--header 'interfaceName: close' \
--header 'interfaceVersion: 1.0.0' \
--header 'language: zh_CN' \
--header 'orgNo: S**************' \
--header 'orgCertId: ****************************************' \
--header 'signature: FVvyQVXZJCppb1i66UYx/C0f/AYUuuLvJb+Efgv7SCXaXQ0SXpBzyUQjbaEUxSRp9brMFsvREP74yAQ0rjmZZHx/lKg2gsWjkR79+EZs9Tof7hs0du659DSNqXfN0R3CP5uydOO/fkJrXHWWUviya1gRbNT9xeMoXuuX9yvDYIEmXPD9KgXGHUbCG9Y1s+7Rl4XY9xM0GX1vrDVBjQuo6yp00rOjUBsm03ZWURpX4A2g+itiV2q8wdVhf26WtqEOpzSxthD3QGaFjyWDiPJZE/RzSB2K8CLLcXxuRnMLUIUe7CmVJ95oC/7MA8YEQs93XH/+aNCk670dSWsUOwiZqA==' \
--header 'signMethod: RSA-SHA256' \
--header 'Content-Type: application/json' \
--data '{
    "requestId": "S**************_20250722093710965_c4",
    "requestTime": "2025-07-22T09:37:10.965+08:00",
    "nonceStr": "BrPdzYTB2TpYdfaWT4ztw6SSiqjlsNy3",
    "data": {
        "merchant": {
            "merchantNo": "**********"
        },
        "transaction": {
            "transactionNo": "TK0DE23D4A8F00000844266247831552",
            "merchantSerialNo": "MERCHANT_SERIAL_20250722173710"
        }
    }
}'

响应参数

字段名

类型

是否必传

字段名称

说明

transaction

字段名	类型	是否必传	字段名称	说明
transactionNo	String	是	支付流水号
originalTransactionNo	String	否	原支付流水号
merchantSerialNo	String	否	商户交易流水号
amount	decimal	是	支付金额	单位：元
tipAmount	decimal	否	小费金额	单位：元
currency	String	是	币种
status	String	是	支付单状态	参考附录-枚举字典 11 交易状态 TransactionStatus
orderNo	String	是	订单号
externalOrderNo	String	否	外部订单号
refundAmount	decimal	否	退款金额	单位：元
transactionType	String	是	交易类型	参考附录-枚举字典 3 交易类型 TransactionType
paymentWay	String	是	支付方式	参考附录-枚举字典 5 支付方式 PaymentWay
authCode	String	否	授权码
responseCode	String	否	主码
responseMessage	String	否	主码说明
completionTime	timestamp	否	交易完成时间
transactionTime	timestamp	是	交易时间
transactionZoneUTCTime	timestamp	是	交易时区时间
transactionZoneId	String	是	时区	交易时区例：Asia/Shanghai
timeZoneFlag	Integer	是	时区标识	时区标识：0.标准时间，1.夏令时
externalAdditionalData	String	否	外部附加数据	返回业务方自定义交易参数原值，JSON格式

Object

是

支付单对象

响应Headers数据示例：

signature: b214uwouxWWOPKj9BZNG60yotPeENCEQyuYnIafJUVbCg/rjh1Ez/7B1gUctsaNtW+8G901br+1pgi4lRA2+BU5c/IK6yehMCeSfGWY+/5zZxLVNBTF8sUvQ651S2pChivY2Zsg8KLgIFVhzT4D2c1ujbvM8A41QAH2KdgTXd3rrR/g9uVP78J5P0iLCIGpySMtuP2QgiuTAriXG03ABCGF7NyFRDse9YMCqArfjLPSFKaQGv7rvINuQG+lqFRPl6QDobkvvT3ecFo54VMgrj153jgt7WUlh62zAZpMylcddWx6kcn8KQr9deE8zLptKrlbQhUbsJNcKd7qYXJyMyA==
orgCertId: ****************************************
signMethod: RSA-SHA256

响应Body数据示例

{
  "requestId": null,
  "requestTime": null,
  "responseTime": "2025-07-22T09:37:18.654+00:00",
  "respCode": 200,
  "respMsg": "success",
  "busCode": null,
  "busMsg": null,
  "busSubCode": null,
  "busSubMsg": null,
  "data": {
    "transaction": {
      "merchantNo": "**********",
      "merchantSerialNo": "MERCHANT_SERIAL_20250722173640",
      "amount": 1.00,
      "transactionNo": "TK0DE23D4A8F00000844266247831552",
      "orderNo": "10820250722000011226",
      "refundAmount": 0.00,
      "tipAmount": 0.00,
      "currency": "HKD",
      "transactionType": "01",
      "paymentWay": "03",
      "status": "22",
      "responseCode": "200",
      "transactionTime": "2025-07-22T09:36:49.000+00:00",
      "transactionZoneUTCTime": "2025-07-22T17:36:49.000+08:00",
      "transactionZoneId": "Asia/Hong_Kong",
      "timeZoneFlag": 0,
      "completionTime": "2025-07-22T09:37:19.000+00:00"
    }
  }
}

3.交易查询

3.1 支付订单查询

介绍:通过商户号以及外部订单号或平台订单号(二选一)来查询订单详情

接口地址: /saas/query

字段名	类型	是否必传	字段名称	说明
interfaceVersion	String	是	版本号	默认值:1.0.0
language	String	否	语言	语言(zh_CN,zh_TW,en_US)默认取值:zh_CN
interfaceName	String	是	接口名称	填写:`order`
businessType	String	是	业务类型	填写:`query`
orgNo	String	是	机构编号
orgCertId	String	是	机构密钥证书序列号
signature	String	是	机构签名
signMethod	String	是	机构签名方法	取值范围:RSA-SHA256,ECDSA-SHA256,HMAC-SHA256

请求参数

字段名

类型

是否必传

字段名称

说明

merchant

字段名	类型	是否必传	字段名称	说明
merchantNo	String	是	商户号

Object

是

商户对象信息

order

字段名	类型	是否必传	字段名称	说明
externalOrderNo	String	选填	外部订单号	外部订单号和平台订单号二选一（调用方根据自身业务规则生成唯一的订单号）
orderNo	String	选填	平台订单号	外部订单号和平台订单号二选一

Object

是

订单对象信息

Curl请求示例

curl --location '${PAYMENT_DOMAIN}/saas/query' \
--header 'businessType: query' \
--header 'interfaceName: order' \
--header 'interfaceVersion: 1.0.0' \
--header 'language: zh_CN' \
--header 'orgNo: S**************' \
--header 'orgCertId: ****************************************' \
--header 'signature: hzIAxb4OifZZfJjMtmRHlecNhwcpCZ0ladN0+c2o87effZA2vkMVqYpFvS3LnfLRvE3E5BCOZkwsVQzvoTVtDvEFlXrP9RodyhZSbd40NF2JUro+gFw6W1yWnvZwYJNBVcFW1CawgD/Vk3DiweH6oS2+H1Nq0pJGf+FgJl+4mJO4S/V1VHzq66VagC3L/ChhW+iKRpnT1wpXNuFjxe+5JcHY8PnxTQ7uLTk71UDVYUjs0DIWj3FjQdAhUsOFu/Zsx4Gis2+YnYMjHWDL7Wga9LfJ63/EbPALRdpQQZkDGtoRiUKhZhMFiIKtTUfnFySRCwcCwa8GTr/Pm+4YwwBfMQ==' \
--header 'signMethod: RSA-SHA256' \
--header 'Content-Type: application/json' \
--data '{
    "requestId": "S**************_20250722094027781_51",
    "requestTime": "2025-07-22T09:40:27.781+08:00",
    "nonceStr": "hvQvF5lc53d1JkUXQ4BIlAcHRpbMkyoh",
    "data": {
        "merchant": {
            "merchantNo": "**********"
        },
        "order": {
            "externalOrderNo": "",
            "orderNo": "10820250722000011225"
        }
    }
}'

响应参数

字段名

类型

是否必传

字段名称

说明

order

字段名	类型	是否必传	字段名称	说明
externalOrderNo	String	是	外部订单号
orderNo	String	是	平台订单号
amount	decimal	是	金额	单位：元
authorizeAmount	decimal	否	授权金额	单位：元
addAmount	decimal	否	授权追加金额	单位：元
currency	String	是	币种
orderDetails	String	是	订单详情
orderTime	Timestamp	是	订单时间
externalAdditionalData	String	否	外部附加数据	传入业务方自定义订单参数，JSON格式

Object

是

订单对象

transaction

字段名	类型	是否必传	字段名称	说明
transactionNo	String	是	支付流水号
originalTransactionNo	String	否	原支付流水号
orderNo	String	是	订单号
amount	decimal	是	支付金额	单位：元
tipAmount	decimal	否	小费金额	单位：元
refundAmount	decimal	否	退款金额	单位：元
currency	String	是	币种
status	String	是	支付单状态	参考附录-枚举字典 11 交易状态 TransactionStatus
transactionType	String	是	交易类型	参考附录-枚举字典 3 交易类型 TransactionType
paymentWay	String	是	支付方式	参考附录-枚举字典 5 支付方式 PaymentWay
paymentType	String	是	支付类型	参考附录-枚举字典 6 支付类型 PaymentType
paymentSubtype	String	是	支付子类型	参考附录-枚举字典 7 支付子类型 PaymentSubType
cardType	String	否	卡类型	参考附录-枚举字典 8 卡类型 CardType
cardFlag	String	否	卡标识	参考附录-枚举字典 9 卡标识 CardFlag
cardBrand	String	否	卡组织	参考附录-枚举字典 10 卡组织 CardBrand
payerFee	decimal	否	付款方费用	交易手续费明确才返回
payerRefundFee	decimal	否	付款方退款费用	交易手续费明确才返回
payeeFee	decimal	否	收款方费用	交易手续费明确才返回
payeeRefundFee	decimal	否	收款方退款费用	交易手续费明确才返回
authCode	String	否	授权码
refundFlag	String	否	退款标识	00.未处理，01.部分退款，02.全部退款
revokeFlag	String	否	撤销标识	00.未处理，01.已撤销
authCompleteFlag	String	否	完成标识	00.未处理，01.已完成
responseCode	String	否	主码
responseMessage	String	否	主码说明
subCode	String	否	子码
subMessage	String	否	子码说明
completionTime	timestamp	否	交易完成时间
transactionTime	timestamp	是	交易时间
transactionZoneUTCTime	timestamp	是	交易时区时间
transactionZoneId	String	是	时区	交易时区例：Asia/Shanghai
timeZoneFlag	Integer	是	时区标识	时区标识：0.标准时间，1.夏令时
externalAdditionalData	String	否	外部附加数据	返回业务方自定义交易参数原值，JSON格式

Object

是

支付单对象

响应Headers数据示例：

signature: OtnCiCioS0Aiuy2hZ2qjSOCxHcpOnWYPON6vVcv/9LMgrltSOQFvavkRs15uAonY/vhRts+XA4gbA8KgNqLXiItb4UebZ9QuyVEXKriRA9gD2RWkgut99iVNgNVGb3VEFzCWHVXfVZD55dMLR6pCR7w2/Fo+twsuBRqnFv20rHvCdUKSjsE+X7u8EzRSw9/H8XrvlLIuqQuIa4za/YgLn/GBy2rgWf68HIxgh5uMOCSJQ7cgx8rmkwOERAK+h8yiAU38MIOvCEvj325UKt+208ru5CthnDaoGbA3nH4NotLCC0AgICW8PLnbX1riR3zXKRi7eb5E6H2sAq+duP8SqQ==
orgCertId: ****************************************
signMethod: RSA-SHA256

响应Body数据示例

{
  "requestId": null,
  "requestTime": null,
  "responseTime": "2025-07-22T09:41:24.288+00:00",
  "respCode": 200,
  "respMsg": "success",
  "busCode": null,
  "busMsg": null,
  "busSubCode": null,
  "busSubMsg": null,
  "data": {
    "order": {
      "externalOrderNo": null,
      "orderNo": "10820250722000011225",
      "orderDetails": null,
      "amount": "1.00",
      "authorizeAmount": 0.00,
      "addAmount": 0.00,
      "currency": "HKD",
      "orderTime": "2025-07-22T17:00:36.000+00:00",
      "goodsDetails": null,
      "shippingAddress": null,
      "billingAddress": null,
      "externalAdditionalData": null
    },
    "transaction": [
      {
        "transactionNo": "TK0FF43B8FF100000844230640091136",
        "originalTransactionNo": null,
        "orderNo": "10820250722000011225",
        "externalOrderNo": null,
        "amount": 1.00,
        "authorizeAmount": null,
        "addAmount": null,
        "refundAmount": 0.00,
        "payerFee": null,
        "payerRefundFee": 0.00,
        "payeeFee": null,
        "payeeRefundFee": null,
        "tipAmount": 0.00,
        "currency": "HKD",
        "transactionType": "01",
        "paymentWay": "03",
        "authCode": "285247730575324428",
        "status": "02",
        "responseCode": "54505",
        "responseMessage": "渠道响应的信息处理失败！",
        "subCode": null,
        "subMessage": null,
        "transactionTime": "2025-07-22T09:00:36.000+00:00",
        "transactionZoneUTCTime": "2025-07-22T17:00:36.000+08:00",
        "transactionZoneId": "Asia/Hong_Kong",
        "timeZoneFlag": 0,
        "completionTime": null,
        "refundFlag": "00",
        "revokeFlag": "00",
        "authCompleteFlag": "00",
        "paymentType": "04",
        "paymentSubtype": "08",
        "cardType": null,
        "cardFlag": null,
        "cardBrand": null,
        "merchantSerialNo": "MERCHANT_SERIAL_20250722170019",
        "taskId": null,
        "cardNoDigest": null,
        "externalAdditionalData": null
      }
    ]
  }
}

3.2 线上支付交易查询

介绍:依据商户号以及交易流水号或商户交易流水号(二选一)查询交易信息。

接口地址: /saas/query

字段名	类型	是否必传	字段名称	说明
interfaceVersion	String	是	版本号	默认值:1.0.0
language	String	否	语言	语言(zh_CN,zh_TW,en_US)默认取值:zh_CN
interfaceName	String	是	接口名称	填写:`transaction`
businessType	String	是	业务类型	填写:`query`
orgNo	String	是	机构编号
orgCertId	String	是	机构密钥证书序列号
signature	String	是	机构签名
signMethod	String	是	机构签名方法	取值范围:RSA-SHA256,ECDSA-SHA256,HMAC-SHA256

请求参数

字段名

类型

是否必传

字段名称

说明

merchant

字段名	类型	是否必传	字段名称	说明
merchantNo	String	是	商户号

Object

是

商户对象信息

transaction

字段名	类型	是否必传	字段名称	说明
transactionNo	String	选填	交易流水号	与商户交易流水号二选一
merchantSerialNo	String	选填	商户交易流水号	与交易流水号二选一（调用方根据自身业务规则生成唯一的交易流水号）

Object

是

支付单对象信息

Curl请求示例

curl --location '${PAYMENT_DOMAIN}/saas/query' \
--header 'businessType: query' \
--header 'interfaceName: transaction' \
--header 'interfaceVersion: 1.0.0' \
--header 'language: zh_CN' \
--header 'orgNo: S**************' \
--header 'orgCertId: ****************************************' \
--header 'signature: HxIUOoHsOkC+47ZZoO9a5+Pm2r+4aPJ7ygUeSOEp3IFqvC2zKoF20teZtDewwTd4foNd4dIH+QTwk/pkaRqN2gQstv4lgKmi5Muy4Ps+gOAi6Zz4YSYRE/aHtCQUQ5eSlZehCUFcDaPkpUqCi4ypPJNUcTTGDcJDRJKgGrUSTtI1wBdM/uco4I6h5/K0S3T/zWUpQSkUmGmJtdra+Zi/PfmRDA0RiOxjW5Cjj9QmC7T/J2wt1QWwpBrk4QpPcnhIIOsATE+jB6L8UWPwsjPxUzwKc3zzY5o6kvb5YrpkRrooWFFgrS+hJhEhejFXiFNwMDEInZN9/dmvGbU4wIPkTA==' \
--header 'signMethod: RSA-SHA256' \
--header 'Content-Type: application/json' \
--data '{
    "requestId": "S**************_20250722094349984_3e",
    "requestTime": "2025-07-22T09:43:49.984+08:00",
    "nonceStr": "vRW2NygKh6fC1ycsuoTQEowNG2tPIHoB",
    "data": {
        "merchant": {
            "merchantNo": "**********"
        },
        "transaction": {
            "transactionNo": "TK0FF43B8FF100000844230640091136",
            "merchantSerialNo": "MERCHANT_SERIAL_20250722174349"
        }
    }
}'

响应参数

介绍：响应线上支付支付单查询对象的详细数据，如支付流水号、原支付流水号、订单号、支付金额等。

字段名

类型

是否必传

字段名称

说明

transaction

字段名	类型	是否必传	字段名称	说明
transactionNo	String	是	支付流水号
originalTransactionNo	String	否	原支付流水号
orderNo	String	是	订单号
amount	decimal	是	支付金额	单位：元
addAmount	decimal	否	预授权追加金额	单位：元
authorizeAmount	decimal	否	预授权金额	单位：元
tipAmount	decimal	否	小费金额	单位：元
refundAmount	decimal	否	退款金额	单位：元
currency	String	是	币种
status	String	是	支付单状态	参考附录-枚举字典 11 交易状态 TransactionStatus
transactionType	String	是	交易类型	参考附录-枚举字典 3 交易类型 TransactionType
paymentWay	String	是	支付方式	参考附录-枚举字典 5 支付方式 PaymentWay
paymentType	String	是	支付类型	参考附录-枚举字典 6 支付类型 PaymentType
paymentSubtype	String	是	支付子类型	参考附录-枚举字典 7 支付子类型 PaymentSubType
cardType	String	否	卡类型	参考附录-枚举字典 8 卡类型 CardType
cardFlag	String	否	卡标识	参考附录-枚举字典 9 卡标识 CardFlag
cardBrand	String	否	卡组织	参考附录-枚举字典 10 卡组织 CardBrand
payerFee	decimal	否	付款方费用	交易手续费明确才返回
payerRefundFee	decimal	否	付款方退款费用	交易手续费明确才返回
payeeFee	decimal	否	收款方费用	交易手续费明确才返回
payeeRefundFee	decimal	否	收款方退款费用	交易手续费明确才返回
authCode	String	否	授权码
refundFlag	String	否	退款标识	00.未处理，01.部分退款，02.全部退款
revokeFlag	String	否	撤销标识	00.未处理，01.已撤销
authCompleteFlag	String	否	完成标识	00.未处理，01.已完成
responseCode	String	否	主码
responseMessage	String	否	主码说明
subCode	String	否	子码
subMessage	String	否	子码说明
completionTime	timestamp	否	交易完成时间
transactionTime	timestamp	是	交易时间
transactionZoneUTCTime	timestamp	是	交易时区时间
transactionZoneId	String	是	时区	交易时区例：Asia/Shanghai
timeZoneFlag	Integer	是	时区标识	时区标识：0.标准时间，1.夏令时
externalAdditionalData	String	否	外部附加数据	返回业务方自定义交易参数原值，JSON格式
purseOrderNo	String	否	钱包支付单号	微信、支付宝等钱包的订单号
channelTransactionNo	String	否	渠道流水号	微信、支付宝等钱包的订单号

Object

是

支付单对象

响应Headers数据示例：

signature: L1jTmGa/kO9qaMbO8nnJ6q3xHs4v2sPzNtGblFdKGCe/l9I4FN6VwggAVFEp/v2RDe1nQKAWV1+w6wRY6ruT6Yl0juLbzmHretZgV67qHmfhami51hsjBsPBu173elpvpIkw5Eqx7jQkq2MagSWBtl1wO5jRvjm/oHrzUhF1bHCF++PdqFN1fPbClCy/88mVrJLk7MGTnKJ94nYvs9iOYiQalBQEGgIyMiJjp3uo1T2kYborGz3Xj9zb3LW4krIohH/lE/Xt1Q/w6zh0G6JirwHp8ZKj7cYMvsDr36UfJSP8yhiIUUuQmi1PR0TsYh6j3eA18/m75Hh0mJukX+Bzhw==
orgCertId: ****************************************
signMethod: RSA-SHA256

响应Body数据示例

{
  "requestId": null,
  "requestTime": null,
  "responseTime": "2025-07-22T09:44:17.583+00:00",
  "respCode": 200,
  "respMsg": "success",
  "busCode": null,
  "busMsg": null,
  "busSubCode": null,
  "busSubMsg": null,
  "data": {
    "order": null,
    "transaction": {
      "transactionNo": "TK0FF43B8FF100000844230640091136",
      "originalTransactionNo": null,
      "orderNo": "10820250722000011225",
      "externalOrderNo": null,
      "amount": 1.00,
      "authorizeAmount": null,
      "addAmount": null,
      "refundAmount": 0.00,
      "payerFee": 0.00,
      "payerRefundFee": 0.00,
      "payeeFee": 0.00,
      "payeeRefundFee": 0.00,
      "tipAmount": 0.00,
      "currency": "HKD",
      "transactionType": "01",
      "paymentWay": "03",
      "authCode": "285247730575324428",
      "status": "01",
      "responseCode": "54734",
      "responseMessage": "订单已关闭",
      "subCode": null,
      "subMessage": null,
      "transactionTime": "2025-07-22T09:00:36.000+00:00",
      "transactionZoneUTCTime": null,
      "transactionZoneId": "Asia/Hong_Kong",
      "timeZoneFlag": 0,
      "completionTime": "2025-07-22T09:44:18.000+00:00",
      "refundFlag": "00",
      "revokeFlag": "00",
      "authCompleteFlag": "00",
      "paymentType": "04",
      "paymentSubtype": "08",
      "cardType": null,
      "cardFlag": null,
      "cardBrand": null,
      "merchantSerialNo": "MERCHANT_SERIAL_20250722170019",
      "taskId": null,
      "cardNoDigest": null,
      "externalAdditionalData": null
    }
  }
}

4.交易通知

4.1 交易回调业务方

介绍：交易完成后给业务方发送结果通知。注：1.需要接入机构提供回调地址 2.需要提供ip白名单，以上均可联系对接的技术人员配合处理

请求参数

字段名

类型

是否必传

字段名称

说明

transaction

字段名	类型	是否必传	字段名称	说明
merchantNo	String	是	商户编号
terminalSerialNo	String	是	终端序列号
merchantSerialNo	String	是	商户交易流水号
amount	decimal	是	支付金额	单位：元
transactionNo	String	否	交易流水号
originalTransactionNo	String	否	原交易流水号
currency	String	否	币种
status	String	否	交易状态	参考附录-枚举字典 11 交易状态 TransactionStatus
orderNo	String	否	订单号
externalOrderNo	String	否	外部订单号
refundAmount	decimal	否	退款金额	单位：元
transactionType	String	否	交易类型	参考附录-枚举字典 3 交易类型 TransactionType
paymentWay	String	否	支付方式	参考附录-枚举字典 5 支付方式 PaymentWay
authCode	String	否	授权码
responseCode	String	否	主码
responseMessage	String	否	主码说明
subCode	String	否	子码
subMessage	String	否	子码说明
completionTime	timestamp	否	交易完成时间
transactionTime	timestamp	否	交易时间
transactionZoneUTCTime	timestamp	否	交易时区时间
transactionZoneId	String	否	时区	交易时区例：Asia/Shanghai
timeZoneFlag	Integer	否	时区标识	时区标识：0.标准时间，1.夏令时
externalAdditionalData	String	否	外部附加数据	返回业务方自定义交易参数原值，JSON格式

Object

是

交易对象

Curl请求示例

curl --location '${SERVICE_NOTIFY_URL}' \
--header 'Content-Type: application/json' \
--header 'orgNo: S**************' \
--header 'orgCertId: ****************************************' \
--header 'signMethod: RSA-SHA256' \
--header 'signature: gmEnbXHetb0a+iwz2xJwgYXKHHwYd9Yy8fumDlzOevruscS6yawHjgxZGDhW24+hrJDIS2vwDF879dUOk/YL3kGvoUHXe52UM0y/81+JJ9PD2Ic0C8agBOmSXEiG9ROfOjRDmfxz/zYOHhWGBuN7VtNlKxUxopw8l57MR1ouSLt+g3XEEqpNTqMhB3njTZ5CXZ/XZj95dfZUkkXtXdC1mPOtSkE55gNxTSECcfKDT78gmBMcJEgBpZHoaStEt+KEe6TZ7avmBpP43pccKALWDDkjmiCdXqDxl9a3HOpWj5bx9RALg6GuCDheNBBy/D0CRsQeBEljmBKmHTr1/IVbkQ==' \
--data '{
    "requestId": null,
    "requestTime": null,
    "responseTime": "2026-02-06T06:32:23.087+00:00",
    "respCode": 200,
    "respMsg": "success",
    "busCode": null,
    "busMsg": null,
    "busSubCode": null,
    "busSubMsg": null,
    "data": {
        "order": {
            "externalOrderNo": "2019660374626009434",
            "orderNo": "10820260206000044778",
            "amount": "108.00",
            "tipAmount": "0.00",
            "authorizeAmount": 0,
            "currency": "HKD",
            "orderStatus": "03",
            "orderTime": "2026-02-06T14:32:11.551+00:00",
            "merchantNo": "1344000030",
            "productNo": "C201",
            "orderZoneId": "Asia/Hong_Kong",
            "orderDetails": "旺角店"
        },
        "transaction": {
            "merchantNo": "1344000030",
            "productNo": "C201",
            "merchantSerialNo": "2019660374626009434",
            "amount": 108,
            "transactionNo": "TK20B479D73800001125853421453312",
            "orderNo": "10820260206000044778",
            "externalOrderNo": "2019660374626009434",
            "refundAmount": 0,
            "tipAmount": 0,
            "refundTipAmount": 0,
            "currency": "HKD",
            "localTranAmount": 108,
            "localRefundAmount": 0,
            "localTipAmount": 0,
            "localRefundTipAmount": 0,
            "localCurrency": "HKD",
            "localPayeeFee": 1.62,
            "localPayeeRefundFee": 0,
            "localPayeeRefundTotalFee": 0,
            "payeeFee": 1.62,
            "payeeRefundFee": 0,
            "transactionType": "01",
            "paymentWay": "03",
            "status": "00",
            "responseCode": "200",
            "responseMessage": "交易成功",
            "subCode": "0000",
            "transactionTime": "2026-02-06T06:32:11.782+00:00",
            "transactionZoneId": "Asia/Hong_Kong",
            "timeZoneFlag": 0,
            "completionTime": "2026-02-06T06:32:22.861+00:00",
            "externalAdditionalData": "{\"corporationId\":440021082,\"shopId\":403861628,\"paymentId\":2019660374626009434}",
            "purseOrderNo": "4200003001202602061192518957",
            "channelTransactionNo": "2026020613017999"
        }
    }
}'

1. 简介​

2.业务接口​

2.1 预下单​

Header 参数​

请求参数​

响应参数​

2.2 主扫​

Header 参数​

主扫 请求参数​

响应参数​

2.3 被扫​

Header 参数​

请求参数​

响应参数​

2.4 钱包支付​

Header 参数​

请求参数​

响应参数​

2.5 撤销​

Header 参数​

请求参数​

响应参数​

2.6 退款​

Header 参数​

请求参数​

响应参数​

2.7 关单​

Header 参数​

请求参数​

响应参数​

3.交易查询​

3.1 支付订单查询​

Header 参数​

请求参数​

响应参数​

3.2 线上支付 交易查询​

Header 参数​

请求参数​

响应参数​

4.交易通知​

4.1 交易回调业务方​

请求参数​

​

​

1. 简介

2.业务接口

2.1 预下单

Header 参数

请求参数

响应参数

2.2 主扫

Header 参数

主扫请求参数

响应参数

2.3 被扫

Header 参数

请求参数

响应参数

2.4 钱包支付

Header 参数

请求参数

响应参数

2.5 撤销

Header 参数

请求参数

响应参数

2.6 退款

Header 参数

请求参数

响应参数

2.7 关单

Header 参数

请求参数

响应参数

3.交易查询

3.1 支付订单查询

Header 参数

请求参数

响应参数

3.2 线上支付交易查询

Header 参数

请求参数

响应参数

4.交易通知

4.1 交易回调业务方

请求参数