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.
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.