{
"payout_id": "7d5c2f0a-1e9b-4a6d-8f3c-0b2a1d9e8c7f",
"account_id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
"country": "MX",
"currency": "MXN",
"local_amount": "1500.00",
"usdt_amount": "85.714286",
"total_debit": "86.014286",
"status": "completed",
"status_code": "",
"status_message": "",
"bank_reference": "00761123456",
"funds_debited": true,
"compliance_pending": false,
"predebit_failure": false,
"idempotency_key": "payroll-2026-07-001"
}Payout status changed
A payout reached a new state (processing, completed or failed).
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.
WEBHOOK
payout_status_changed
{
"payout_id": "7d5c2f0a-1e9b-4a6d-8f3c-0b2a1d9e8c7f",
"account_id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
"country": "MX",
"currency": "MXN",
"local_amount": "1500.00",
"usdt_amount": "85.714286",
"total_debit": "86.014286",
"status": "completed",
"status_code": "",
"status_message": "",
"bank_reference": "00761123456",
"funds_debited": true,
"compliance_pending": false,
"predebit_failure": false,
"idempotency_key": "payroll-2026-07-001"
}Authorizations
Session JWT (from register/login) or API key (pk_...).
X-API-Key: <token> is accepted as an alternative header.
Body
application/json
Response
200
Return any 2xx to acknowledge the delivery.