Event Name:
payout_approvedEvery approval step is complete, so the payout leaves
PENDING_APPROVAL and continues to processing.payout_completed or payout_failed.
If you fixed the amount the recipient receives, the payout is requoted when it is approved, so
debitedAmount, fees and fx can differ from the values at creation. Always reconcile against the amounts in this payload, not the ones from payout_approval_required.Event Payload
The webhook payload contains the following structure:{
"eventId": "c41d7e92-6a3b-4f8e-b2d5-9e1a7c3f5b28",
"eventType": "payout_approved",
"timestamp": "2026-10-21T09:15:00.000Z",
"data": {
"status": "PROCESSING",
"payoutType": "bankPayout",
"orderId": "00c32e47-245d-45f0-94f1-3f77eda656be",
"ownReference": "Merchant internal reference for reconciliation",
"source": {
"type": "account",
"debitedAccountId": "a5a03fd6-eacc-48ee-b8f6-67267b4095ab",
"debitedUserId": "15c5277a-8c8c-41d2-9f42-66f82f6f113d"
},
"destination": {
"type": "bankAccount",
"routingType": "SWIFT",
"accountNumber": "1234567890",
"bankWireRef": "TX1751382490165317",
"swift": "CHASUS33XXX",
"beneficiary": {
"type": "BUSINESS",
"name": "John",
"surname": "Doe",
"relation": "MYSELF",
"document": {
"type": "PASSPORT",
"number": "X12345678"
},
"contact": {
"email": "john@mail.com",
"phone": "+12125551234"
},
"address": {
"line1": "350 Fifth Avenue",
"postalCode": "10118",
"province": "NY",
"city": "New York",
"country": "US"
}
}
},
"amounts": {
"debitedAmount": {
"amount": 10000,
"currency": "EUR"
},
"fees": {
"currency": "EUR",
"total": 100,
"breakdown": {
"systemFee": 60,
"merchantFee": 40
}
},
"amountAfterFees": {
"amount": 9900,
"currency": "EUR"
},
"fx": {
"pair": "EUR/USD",
"rate": "1.0909090909"
},
"creditedAmount": {
"amount": 10800,
"currency": "USD"
}
},
"approval": {
"expiresAt": "2026-10-27T10:30:00Z",
"progress": {
"approvedSteps": 2,
"steps": 2
},
"steps": [
{
"number": 1,
"approved": true,
"approvedAt": "2026-10-20T16:02:00Z"
},
{
"number": 2,
"approved": true,
"approvedAt": "2026-10-21T09:15:00Z"
}
],
"rejection": null
}
}
}
{
"eventId": "9a5e3c17-2b8d-4f4a-a6c1-7d3e9b1f5c64",
"eventType": "payout_approved",
"timestamp": "2026-10-20T11:05:00.000Z",
"data": {
"status": "PROCESSING",
"payoutType": "cryptoPayout",
"orderId": "6fc5042e-1984-43e7-a2d3-2f0215dba030",
"ownReference": "Merchant internal reference for reconciliation",
"source": {
"type": "account",
"debitedAccountId": "8befb505-7f8c-4a72-85a5-e7cbc9719ba8",
"debitedUserId": "15c5277a-8c8c-41d2-9f42-66f82f6f113d"
},
"destination": {
"type": "cryptoAccount",
"address": "5xoBq7f7CDgZwqHrDBdRWM84ExRetg4gZq3jX1xhk2yz",
"network": "SOLANA"
},
"amounts": {
"debitedAmount": {
"amount": 10000,
"currency": "EUR"
},
"fees": {
"currency": "EUR",
"total": 100,
"breakdown": {
"systemFee": 60,
"merchantFee": 40
}
},
"amountAfterFees": {
"amount": 9900,
"currency": "EUR"
},
"fx": {
"pair": "EUR/USDC",
"rate": "1.0909090909"
},
"creditedAmount": {
"amount": 10800,
"currency": "USDC"
}
},
"approval": {
"expiresAt": "2026-10-27T10:32:00Z",
"progress": {
"approvedSteps": 1,
"steps": 1
},
"steps": [
{
"number": 1,
"approved": true,
"approvedAt": "2026-10-20T11:05:00Z"
}
],
"rejection": null
}
}
}