支付通知回调（Webhook）

POST

https://pay.cnyepay.com/webhooks/payment/notification

当订单支付成功时，粤收付支付网关会向商户系统发起回调通知。如果商户系统没有正确返回，粤收付支付网关会延迟再次通知（通知频率为0/30/60/90/120/150秒）。

注意: 这是由粤收付支付网关主动调用商户系统的接口，商户需要在自己的系统中实现此接口，并在统一下单时通过 notifyUrl 参数提供接口地址。

Content-Type: 使用 application/json 格式传输数据

请求参数

Body 参数application/json

示例

{
    "payOrderId": "P12021022311124442600",
    "mchNo": "M1755581016",
    "appId": "68a40a59e4b0bf61830a5687",
    "mchOrderNo": "P1957679439693283330",
    "ifCode": "wxpay",
    "wayCode": "WEB_CASHIER",
    "amount": 100,
    "currency": "CNY",
    "state": 0,
    "clientIp": "175.0.227.20",
    "subject": "支付网关地址商品标题测试",
    "body": "支付网关地址商品描述测试",
    "channelOrderNo": "P1957679439693283330",
    "errCode": "1002",
    "errMsg": "134586944573118714",
    "extParam": "134586944573118714",
    "successTime": 1622016572190,
    "createdAt": 1622016572190,
    "reqTime": "1622016572190",
    "sign": "C380BEC2BFD727A4B6845133519F3AD6",
    "storeId": 0,
    "lng": "string",
    "lat": "string",
    "qrcId": 0,
    "wayCodeType": "string",
    "mchFeeRate": "string",
    "mchFeeAmount": 0,
    "channelUser": "string",
    "divisionMode": 0,
    "buyerRemark": "string",
    "sellerRemark": "string",
    "expiredTime": 0,
    "platformOrderNo": "string",
    "platformMchOrderNo": "string"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://pay.cnyepay.com/webhooks/payment/notification' \
--header 'Content-Type: application/json' \
--data-raw '{
    "payOrderId": "P12021022311124442600",
    "mchNo": "M1755581016",
    "appId": "68a40a59e4b0bf61830a5687",
    "mchOrderNo": "P1957679439693283330",
    "ifCode": "wxpay",
    "wayCode": "WEB_CASHIER",
    "amount": 100,
    "currency": "CNY",
    "state": 0,
    "clientIp": "175.0.227.20",
    "subject": "支付网关地址商品标题测试",
    "body": "支付网关地址商品描述测试",
    "channelOrderNo": "P1957679439693283330",
    "errCode": "1002",
    "errMsg": "134586944573118714",
    "extParam": "134586944573118714",
    "successTime": 1622016572190,
    "createdAt": 1622016572190,
    "reqTime": "1622016572190",
    "sign": "C380BEC2BFD727A4B6845133519F3AD6",
    "storeId": 0,
    "lng": "string",
    "lat": "string",
    "qrcId": 0,
    "wayCodeType": "string",
    "mchFeeRate": "string",
    "mchFeeAmount": 0,
    "channelUser": "string",
    "divisionMode": 0,
    "buyerRemark": "string",
    "sellerRemark": "string",
    "expiredTime": 0,
    "platformOrderNo": "string",
    "platformMchOrderNo": "string"
}'

返回响应

🟢200成功

text/plain

成功接收通知

Body

示例

"success"

修改于 2025-10-27 11:42:51

关闭订单

查询支付订单