ADOPAY 开发者平台

外观

Webhook 规范 ​

支付 / 退款 / 代付 / 换汇通知的公共规则。

公共规则 ​

规则要求
传输HTTPS 回调地址
超时3 秒内完成响应
失败处理超时或非成功响应视为投递失败
幂等必须可安全处理重复投递
验签按平台规则校验签名 / Digest

推荐 Envelope ​

json
{
  "eventId": "evt_xxx",
  "eventType": "PAYMENT.SUCCEEDED",
  "createdAt": "2026-08-08T12:00:00Z",
  "data": {}
}

Partner Webhook Envelope ​

json
{
  "eventId": "evt_xxx",
  "eventType": "PAYMENT.SUCCEEDED",
  "partnerId": "P10001",
  "merchantId": "M20001",
  "data": {
    "paymentId": "PAY10001",
    "merchantOrderNo": "ORDER10001",
    "amount": 100.00,
    "currency": "BRL",
    "status": "SUCCEEDED"
  }
}

Partner 平台应按 merchantId 将事件路由给下游商户。

具体事件页仍挂在 Merchant API 的 Collection / Payout / Exchange 下。