1. 异步通知
Merchant API Documentation
  • 引言
  • 签名算法
  • 信用测试卡
  • 开启正式模式
  • 本地付测试
  • 代付
    • 代付申请接口_ PAY_PAL
      POST
    • 代付申请接口_ ACH_DEBIT
      POST
    • 代付申请接口_CASHAPP
      POST
    • 检索代付交易接口
      GET
    • 代付取消申请接口
      POST
  • 客户
    • 创建客户
      POST
    • 更新客户
      PUT
    • 检索客户
      GET
    • 删除客户
      DELETE
    • 列出所有客户
      GET
  • 代收(收款)
    • 收银台
      POST
    • 本地支付(直连)
      POST
    • 信用卡支付(直连)【PCI】
      POST
    • Web SDK-V2
      POST
    • 检索代收交易接口
      GET
    • Google Pay SDK
      POST
  • 退款申请
    • 退款申请接口
      POST
    • 检索退款接口
      GET
  • 余额查询
    • 检索余额接口
  • 异步通知
    • 代收异步通知
    • 代付异步通知
  • 订阅
    • 创建订阅
    • 检索订阅
    • 取消订阅
  • 重复性支付
    • 首次重复性支付(直连)
    • 首次重复性支付【收银台】
    • 首次重复性支付【SDK】
    • 后续重复性支付
  • 数据模型
    • 代收模型
      • 信用卡信息
        • CARD
        • 设备信息
      • 代收请求体
      • 代收响应体
      • option配置项
      • option配置项
    • 资金模型
      • 资金响应体
    • 客户模型
      • 客户请求体
      • 客户响应体
      • 收货地址 shipping
      • 产品/服务信息 product
    • 退款模型
      • 退款请求体
      • 退款响应体
    • 代付模型
      • 代付请求体
      • 代付响应体
      • 代付取消请求体
    • 订阅模型
      • 订阅请求体
      • 订阅响应体
      • 订阅计划请求体
      • 订阅计划响应体
      • 其他订阅请求体
    • 响应体基本模型
    • 请求头
  1. 异步通知

代付异步通知

异步回调#

收到回调后返回状态码200即是收到。
成功立即回调,失败10分钟内回调。
GET回调 Content-Type: application/x-www-form-urlencoded
请求头

代付响应体

示例#

GET {notifyUrl}?amount=12.34&orderNo=asd60102&code=succeeded&tradeNo=pay_uPg7EbJzqOa1LfqEa8uE&currency=USD&remark=Good&completionDate=1728641594235&message=succeeded&status=2

验证签名#

1
从请求头提取时间戳和签名
t对应时间戳,signature 对应签名。大小写根据实际得到的为主。您可以丢弃所有其他元素。
2
准备签名字符串
字符串是通过连接以下内容创建的:
t + tradeNo + currency + amount + status + code + message
例如上面示例连接后的结果:
1728641570974payout_zsg7EbJzqOa1LfqEa8uEUSD12.342succeededsucceeded
3
确定期望的签名
用SHA256算法加密签名字符串,例如加密第2步准备的字符串后的字符串为:
618adc65704c596fe5afeb918d100cb436703488815013f53878e30929e1643d
4
对比签名
将头内的签名与期望的签名进行比较。为进行相等匹配,应计算当前时间戳和收到的时间戳之间的差异,然后确定它是否在您的容差范围内。
为了防止定时攻击,请用恒定时间字符串比较方式将期望的签名与收到的每个签名进行比较。
修改于 2026-06-16 07:26:34
上一页
代收异步通知
下一页
创建订阅
Built with