{
"event_type": "payin_refunded",
"refund_id": "6f1a2b3c-4d5e-4f6a-8b9c-0d1e2f3a4b5c",
"payin_id": "d0135ed5-8e9c-4f8b-a522-8ec100470426",
"account_id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
"kind": "refund",
"status": "completed",
"currency": "USD",
"local_amount": "150.00",
"usdt_debited": "150.000000",
"balance_after": "850.000000",
"requested_by": "account",
"idempotency_key": "refund-order-8842",
"receipt_url": "https://api.qbank.cl/platform/v1/payin-refunds/6f1a2b3c-4d5e-4f6a-8b9c-0d1e2f3a4b5c/receipt",
"created_at": "2026-07-25T13:10:00Z",
"updated_at": "2026-07-25T13:10:03Z"
}收款已退款
一笔卡收款的退款已到达最终状态，或发卡机构发起了拒付。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 次，采用递增退避。
WEBHOOK
payin_refunded
{
"event_type": "payin_refunded",
"refund_id": "6f1a2b3c-4d5e-4f6a-8b9c-0d1e2f3a4b5c",
"payin_id": "d0135ed5-8e9c-4f8b-a522-8ec100470426",
"account_id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
"kind": "refund",
"status": "completed",
"currency": "USD",
"local_amount": "150.00",
"usdt_debited": "150.000000",
"balance_after": "850.000000",
"requested_by": "account",
"idempotency_key": "refund-order-8842",
"receipt_url": "https://api.qbank.cl/platform/v1/payin-refunds/6f1a2b3c-4d5e-4f6a-8b9c-0d1e2f3a4b5c/receipt",
"created_at": "2026-07-25T13:10:00Z",
"updated_at": "2026-07-25T13:10:03Z"
}授权
会话 JWT(来自注册/登录)或 API key(pk_...)。
也接受 X-API-Key: <token> 作为替代请求头。
请求体
application/json
chargeback 由发卡机构强制发起 —— 会自动记账，并可能使余额变为负数。
可用选项:
refund, void, chargeback 可用选项:
pending, completed, failed 原始收款的货币。
从 USDT 余额中扣除的金额。原收款的手续费与汇率点差不予退还。
可用选项:
account, admin, issuer 当 status 为 failed 时出现 —— 扣款已全额冲回。
退款处于 pending 期间出现 —— 结果由对账流程解决，绝不会重新下发。
出现在 payin_refunded webhook 中 —— 该笔变动后的 USDT 余额（拒付时可能为负）。
响应
200
返回任意 2xx 以确认投递。