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 。