Skip to content

Webhooks推送通知

Webhook是从 币趣支付 服务器发送到商户服务器的 HTTP POST 消息。

通知介绍

Webhook的主要目的是提醒商户服务器 币趣支付的票据状态己更改。

  • Webhook将发送至商户在创建票据时提供的notificationUrl
  • 币趣支付 发送的推送正文是 JSON 格式的字符串content-Type: application/json

支付通知

发送的即时付款通知(IPN)正文。示例:"status":"completed"

请参阅支付通知文档以获取更多信息

代付通知

发送的代付通知正文。示例:"status":"completed"

请参阅代付通知文档以获取更多信息

商家应如何处理Webhook

1.确保不要依赖将 币趣支付 的发送 IP 地址列入白名单,因为这些 IP 地址如有更改,恕无法另行通知。
2.确保您的notificationURL
3.币趣支付 不会对 Webhook 进行签名,因此不应 完全信任 有效负载中的信息 。
4.支付票据状态为 paid 时并不代表己经付款,商户应仅在相应的 币趣支付 发票达到 completed 状态后才处理订单。了解有关 币趣支付 票据状态的更多信息,请参阅通知代码

WARNING

收到Webhook通知后需要一个正文为空的 HTTP 200 响应,任何其他 HTTP 响应均视为发送失败。
币趣支付 服务器会多次尝试发送 Webhook推送,直到发送成功或 币趣支付 服务器放弃。

故障排除

如果未按预期接收或处理 Webhook,请检查以下内容:

  • 验证您的 Webhook 处理程序 notificationURL 是否可以正确接收 POST
  • 验证您的防火墙没有阻止来自它可能无法识别的服务器的 POST
  • 可以通过发送 POST以及与指定票据关联的指令来重新发送 Webhook 。