1. 异步通知
Merchant API Documentation
  • 引言
  • 签名&加密算法
  • 信用测试卡
  • 开启正式模式
  • 本地付测试
  • 客户
    • 创建客户
      POST
    • 更新客户
      PUT
    • 查询客户
      GET
    • 查询客户列表
      GET
    • 查询客户列表【完整地址】
      GET
    • 删除客户
      DELETE
  • 收款(代收)
    • 创建收款订单(收银台)
      POST
    • 创建收款订单(本地支付直连)
      POST
    • 查询收款订单
      GET
  • 退款
    • 发起退款
      POST
    • 查询退款订单
      GET
  • 代付
    • 创建代付订单
      POST
    • 查询代付订单
      GET
    • 取消代付订单
      POST
  • 账户
    • 查询账户余额
      GET
  • 异步通知
    • 交易结果通知(V2,加密)
    • 收款结果通知(V1)
    • 代付结果通知(V1)
  • 订阅
    • 创建订阅(待发布)
    • 检索订阅(待发布)
    • 取消订阅(待发布)
  • 重复性支付
    • 首次重复性支付(直连)(待发布)
    • 首次重复性支付【收银台】(待发布)
    • 首次重复性支付【SDK】(待发布)
    • 后续重复性支付(待发布)
  • 数据模型
    • 代收模型
      • 信用卡信息
        • CARD
      • 代收请求体
      • 设备信息
      • 代收响应体
      • option配置项
      • option配置项
    • 资金模型
      • 资金响应体
    • 客户模型
      • 客户请求体
      • 客户响应体
      • 收货地址 shipping
      • 产品/服务信息 product
    • 退款模型
      • 退款请求体
      • 退款响应体
    • 代付模型
      • 代付请求体
      • 代付响应体
      • 代付取消请求体
    • 订阅模型
      • 订阅请求体
      • 订阅响应体
      • 订阅计划请求体
      • 订阅计划响应体
      • 其他订阅请求体
    • 响应体基本模型
    • 请求头
  1. 异步通知

代付结果通知(V1)

异步回调#

收到回调后返回状态码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-08-19 03:22:34
上一页
收款结果通知(V1)
下一页
创建订阅(待发布)
Built with