粤收付开放平台
  1. 支付接口
粤收付开放平台
  • 粤收付加签验签规则
  • 支持的支付方式
  • 支付接口
    • 统一下单
      POST
    • 关闭订单
      POST
    • 支付通知回调(Webhook)
      POST
  • 查询接口
    • 查询支付订单
      POST
    • 查询退款订单
      POST
    • 查询转账订单
      POST
    • 查询转账可用余额
      POST
    • 订单分账查询
      POST
    • 查询分账用户的可用余额
      POST
    • 余额查询
      POST
    • 查询提现详情
      POST
  • 退款接口
    • 统一退款
      POST
  • 转账接口
    • 发起转账
      POST
  • 分账接口
    • 绑定分账用户
      POST
    • 发起订单分账
      POST
    • 对分账用户的余额发起提现
      POST
  • 提现接口
    • 手动提现
      POST
  • 工具接口
    • 条码换取openId
      POST
    • 获取渠道用户ID
      GET
  1. 支付接口

支付通知回调(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
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
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
上一页
关闭订单
下一页
查询支付订单
Built with