Work is underway — an FX exchange in flight, a chain broadcast pending, or a gift card requested from the brand.
This event fires for both payout types
payout.processingis emitted for crypto sends and gift cards, and the two bodies are structurally different. Branch onpayout_typebefore touching the body. This is one of three shared event names, alongsidepayout.failedandpayout.cancelled.
Triggered when work has started on a payout but has not finished. What that means depends on the payout type.
payout_type | Meaning |
|---|---|
crypto | An FX exchange is in flight, or the chain broadcast is pending. Maps from the provider's processing or confirming. |
gift_cards | A gift card has been requested from the brand and is not yet issued. |
Neither is terminal.
Crypto
The crypto body, with the data shape documented on payout.quote_created.
{
"event": "payout.processing",
"payout_type": "crypto",
"data": {
"id": 354,
"status": "confirming",
"input_amount": "100.0",
"sending_amount": "0.049422",
"blockchain_transactions": [],
"requires_2fa_confirmation": false
}
}data.status holds the provider's raw string. A "confirming" here maps to GIFQ's processing.
What to do
- Funds are moving but nothing is confirmed. Do not credit.
blockchain_transactionsmay still be empty, and populates once the broadcast lands.- Expect
payout.completed,payout.failed,payout.expired, orpayout.cancelled.
Gift cards
The GIFQ envelope plus the gift-card payout keys. subject_type is "payout" and status is "processing".
{
"event": "payout.processing",
"payout_order_uuid": "11111111-2222-3333-4444-555555555555",
"recipient_email": "[email protected]",
"recipient_uuid": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
"recipient_name": "Alice Doe",
"subject_type": "payout",
"status": "processing",
"updated_at": "2026-05-21T10:04:50Z",
"payout_type": "gift_cards",
"currency": "GBP",
"sent_at": "2026-05-20T09:00:00Z",
"viewed_at": "2026-05-21T10:00:00Z",
"expires_at": "2026-08-20T09:00:00Z",
"payout_uuid": "99999999-8888-7777-6666-555555555555",
"brand_uuid": "77777777-6666-5555-4444-333333333333",
"brand_name": "Amazon UK",
"amount": 25.0
}What to do
- The recipient's balance is already reserved against this card, but the card does not exist yet.
- Key on
payout_uuid, since this is one card among possibly several for the recipient. - Expect
payout.fulfilledorpayout.failedfor this samepayout_uuid. - Do not tell your end user they have a card yet.