{
"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"
}Cobro devuelto
Una devolución de un cobro con tarjeta alcanzó su estado final, o el emisor impuso un contracargo. status: completed significa que la plata volvió al tarjetahabiente y el débito quedó liquidado en tu saldo; status: failed significa que el procesador la rechazó y el débito se revirtió completo. Un kind: chargeback se asienta automático y puede dejar balance_after negativo (deuda que se netea contra abonos futuros).
Cada entrega incluye X-Webhook-Event, X-Webhook-Event-ID, X-Webhook-Delivery-ID, X-Webhook-Timestamp y X-Webhook-Signature = hex(HMAC-SHA256(secreto, timestamp + "." + cuerpo)). Responde 2xx; hasta 5 intentos con backoff incremental.
{
"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"
}Autorizaciones
JWT de sesión (de register/login) o llave de API (pk_...).
X-API-Key: <token> se acepta como header alternativo.
Cuerpo
chargeback lo impone el emisor de la tarjeta — se asienta automático y puede dejar el saldo negativo.
refund, void, chargeback pending, completed, failed Moneda del payin original.
Monto debitado del saldo USDT. La comisión y el spread FX del payin original NO se devuelven.
account, admin, issuer Presente cuando status es failed — el débito se revirtió completo.
Presente mientras la devolución está pending — el resultado lo resuelve la conciliación y jamás se re-despacha.
Presente en el webhook payin_refunded — el saldo USDT después del movimiento (puede ser negativo en un contracargo).
Respuesta
Devuelve cualquier 2xx para confirmar la entrega.