Payin refunded
A refund of a card payin reached a final state, or the issuer imposed a chargeback. status: completed means the money went back to the cardholder and the debit is settled on your balance; status: failed means the processor declined it and the debit was reversed in full. A kind: chargeback is booked automatically and can leave balance_after negative (a debt netted against future credits).
Every delivery includes X-Webhook-Event, X-Webhook-Event-ID, X-Webhook-Delivery-ID, X-Webhook-Timestamp and X-Webhook-Signature = hex(HMAC-SHA256(secret, timestamp + "." + body)). Respond 2xx; up to 5 attempts with incremental backoff.
Authorizations
Session JWT (from register/login) or API key (pk_...).
X-API-Key: <token> is accepted as an alternative header.
Body
chargeback is imposed by the issuer — it is booked automatically and may leave the balance negative.
refund, void, chargeback pending, completed, failed Currency of the original payin.
Amount debited from the USDT balance. The fee and the FX spread of the original payin are NOT refunded.
account, admin, issuer Present when status is failed — the debit was reversed in full.
Present while the refund is pending — the outcome is resolved by reconciliation and is never re-dispatched.
Present in the payin_refunded webhook — the USDT balance after the movement (can be negative on a chargeback).
Response
Return any 2xx to acknowledge the delivery.