支付结果异步通知

POST

/pay/gateway/v1/notify/pay

支付成功后，平台 POST 通知商户下单时传入的 notifyUrl。
商户需：① 验签（sign）；
② 幂等处理同一 merOrderId 的重复通知；
③ 返回 {"code":"0000"} 视为成功，否则平台按 2/4/8...分钟间隔重发，最多 7 次。
实际 URL 以商户下单时传入的 notifyUrl 为准。

请求参数

Header 参数

Body 参数application/json

示例

{
    "deviceNo": "E0000576",
    "merNo": "666391156556DF2",
    "paywayCode": "QR_ALIPAY_BARPAY",
    "orderId": "202107091734110547686993",
    "merOrderId": "1864CA71882720190523203750",
    "orderTime": "2021-07-09 17:35:19",
    "orderAmt": "0.01",
    "orderStatus": "1",
    "tradeNo": "21420210709173523670105",
    "tradeTime": "2021-07-09 17:35:26",
    "orderTitle": "测试订单",
    "fee": "0.001",
    "actAmt": "0.009",
    "buyerId": "oXXXXXX",
    "tradeTopNo": "4200001234202107091234567890",
    "cardType": "U",
    "sign": "581268B9181B478078AE5B6B1FAAE34A"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/pay/gateway/v1/notify/pay' \
--header 'Sign-Algorithm: RSA' \
--header 'Content-Type: application/json' \
--data '{
    "deviceNo": "E0000576",
    "merNo": "666391156556DF2",
    "paywayCode": "QR_ALIPAY_BARPAY",
    "orderId": "202107091734110547686993",
    "merOrderId": "1864CA71882720190523203750",
    "orderTime": "2021-07-09 17:35:19",
    "orderAmt": "0.01",
    "orderStatus": "1",
    "tradeNo": "21420210709173523670105",
    "tradeTime": "2021-07-09 17:35:26",
    "orderTitle": "测试订单",
    "fee": "0.001",
    "actAmt": "0.009",
    "buyerId": "oXXXXXX",
    "tradeTopNo": "4200001234202107091234567890",
    "cardType": "U",
    "sign": "581268B9181B478078AE5B6B1FAAE34A"
}'

返回响应

🟢200

application/json

商户应答

Bodyapplication/json

示例

{
    "code": "0000"
}

修改于 2026-10-27 07:18:00

授权码获取微信 openid

退款结果异步通知