收款已退款
一笔卡收款的退款已到达最终状态,或发卡机构发起了拒付。status: completed 表示资金已退回持卡人, 扣款已在你的余额上完成结算;status: failed 表示处理方拒绝了该退款,扣款已全额冲回。kind: chargeback 会自动记账,并可能使 balance_after 为负(与未来入账相抵的欠款)。
每次投递都包含 X-Webhook-Event、X-Webhook-Event-ID、X-Webhook-Delivery-ID、X-Webhook-Timestamp 和 X-Webhook-Signature = hex(HMAC-SHA256(secret, timestamp + "." + body))。请返回 2xx; 最多重试 5 次,采用递增退避。
授权
会话 JWT(来自注册/登录)或 API key(pk_...)。
也接受 X-API-Key: <token> 作为替代请求头。
请求体
chargeback 由发卡机构强制发起 —— 会自动记账,并可能使余额变为负数。
refund, void, chargeback pending, completed, failed 原始收款的货币。
从 USDT 余额中扣除的金额。原收款的手续费与汇率点差不予退还。
account, admin, issuer 当 status 为 failed 时出现 —— 扣款已全额冲回。
退款处于 pending 期间出现 —— 结果由对账流程解决,绝不会重新下发。
出现在 payin_refunded webhook 中 —— 该笔变动后的 USDT 余额(拒付时可能为负)。
响应
返回任意 2xx 以确认投递。