{
"event_type": "payin_settlement_scheduled",
"payin_id": "8b3e1c2d-4f5a-6b7c-8d9e-0f1a2b3c4d5e",
"account_id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
"country": "US",
"currency": "USD",
"local_amount": "498.75",
"fx_rate": "1.010202",
"usdt_gross": "493.811881",
"fee": "27.159654",
"usdt_net": "466.652227",
"status": "credited",
"settle_at": "2026-08-12T14:08:33Z",
"idempotency_key": "order-10042",
"receipt_url": "https://api.qbank.cl/platform/v1/payins/8b3e1c2d-4f5a-6b7c-8d9e-0f1a2b3c4d5e/receipt"
}收款结算已计划
一笔以银行卡支付的收款——直接银行卡收款或以卡支付的收银台/POS 收款——已支付,且因贵组织在 payin_card 服务上配置了结算延迟 (settlement_hours),其余额被安排到未来的 settle_at。该事件在支付确认时恰好发出一次 (幂等——同一确认的重试不会重复发送)。status 从一开始就是 credited:收款已确认, payin_credited 会立即发出——等待到 settle_at 的只是余额。usdt_net 是到期将入账的金额(总额 − 手续费); 对于没有总额/手续费的历史记录,金额字段可能为空("")。到达 settle_at 时,结算 worker 会释放余额(此后该收款携带 settled_at,不再有 settlement_pending)。
每次交付都包含 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_settlement_scheduled
{
"event_type": "payin_settlement_scheduled",
"payin_id": "8b3e1c2d-4f5a-6b7c-8d9e-0f1a2b3c4d5e",
"account_id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
"country": "US",
"currency": "USD",
"local_amount": "498.75",
"fx_rate": "1.010202",
"usdt_gross": "493.811881",
"fee": "27.159654",
"usdt_net": "466.652227",
"status": "credited",
"settle_at": "2026-08-12T14:08:33Z",
"idempotency_key": "order-10042",
"receipt_url": "https://api.qbank.cl/platform/v1/payins/8b3e1c2d-4f5a-6b7c-8d9e-0f1a2b3c4d5e/receipt"
}授权
会话 JWT(来自注册/登录)或 API key(pk_...)。
也接受 X-API-Key: <token> 作为替代请求头。
响应
200
返回任意 2xx 以确认投递。