跳转到内容
建设中

本站正在持续完善,沙箱环境即将上线。

本站为独立、非官方的个人技术学习项目,不代表任何银行、金融机构或监管机构。

Webhook 通知

当授权、账户或支付状态发生变化时,平台会向应用配置的回调地址推送事件。

{
"event_id": "evt_01J9Z3K4",
"event_type": "payment.status_changed",
"occurred_at": "2026-10-26T08:30:00Z",
"data": {
"payment_id": "pay_2b7d9f",
"status": "SETTLED"
}
}

每个请求都带有 X-Signature 头,值为请求体与签名密钥的 HMAC-SHA256。必须先校验再处理。

import { createHmac, timingSafeEqual } from 'node:crypto';
function verify(body, signature, secret) {
const expected = createHmac('sha256', secret).update(body).digest('hex');
return (
expected.length === signature.length &&
timingSafeEqual(Buffer.from(expected), Buffer.from(signature))
);
}
  • 未返回 2xx 时按指数退避重试,最多 5 次。
  • 处理逻辑必须幂等,以 event_id 去重。
  • 回调处理应在 5 秒内返回,耗时任务请异步执行。