代收代付回调请求示例

POST

/notifyUrl

代收代付订单状态变化回调通知商户的请求示例
平台会发送http请求商户创建订单传的notifyUrl，商户处理成功需要返回success字样，如果没有检测到成功，系统后面会在一定次数内重复通知商户

回调参数 " 除sign外，都需要参数签名 "，不同情况有些参数会没有或者多一些参数，请做好签名参数校验

如果接收到重复回调或者无需处理的回调，请返回success字样

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Basic 之后拼接空格，以及经过 Base64 编码的 username:password

示例：

Authorization: Basic *****************

Body 参数application/json

示例

{
    "amount": "5000",
    "code": 200,
    "createTimeL": 1680334544698,
    "endToEndId": "e00360305202304010736c2009ae8cdd",
    "fee": "150",
    "merchantOrderId": "164774677175285280-6-WVDVe",
    "msg": "PAID",
    "orderId": "S110202304011642068212621467648",
    "payType": "110",
    "payUrl": "https://pay2.mtbtop1.com/s3/checkout-page/v3.html?cid=expireAt%202023-04-01T05:35:44.725466&sid=S110202304011642068212621467648&amount=50&qrcode=00020101021226790014br.gov.bcb.pix2557brcode.starkinfra.com/v2/92cde06bbe9e4a15a349756d2d24a6325204000053039865802BR5925Wudi%20pay%20Correspondente%20d6009Sao%20Paulo62070503***63045AE8",
    "realPayAmount": "5000",
    "sign": "674e8a79f04939a44fda447d4b13ca8c",
    "status": "01",
    "traceId": "i200,i200401ec75e3c58a5a40cdb874d30bedabcb5c"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/notifyUrl' \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '{
    "amount": "5000",
    "code": 200,
    "createTimeL": 1680334544698,
    "endToEndId": "e00360305202304010736c2009ae8cdd",
    "fee": "150",
    "merchantOrderId": "164774677175285280-6-WVDVe",
    "msg": "PAID",
    "orderId": "S110202304011642068212621467648",
    "payType": "110",
    "payUrl": "https://pay2.mtbtop1.com/s3/checkout-page/v3.html?cid=expireAt%202023-04-01T05:35:44.725466&sid=S110202304011642068212621467648&amount=50&qrcode=00020101021226790014br.gov.bcb.pix2557brcode.starkinfra.com/v2/92cde06bbe9e4a15a349756d2d24a6325204000053039865802BR5925Wudi%20pay%20Correspondente%20d6009Sao%20Paulo62070503***63045AE8",
    "realPayAmount": "5000",
    "sign": "674e8a79f04939a44fda447d4b13ca8c",
    "status": "01",
    "traceId": "i200,i200401ec75e3c58a5a40cdb874d30bedabcb5c"
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

成功示例异常示例

success

修改于 2025-08-13 12:16:56

创建代收订单

商户查询余额