Payout failed

{ "object": "event", "id": "evt_6TnKwRb9XZmVcHpL4qjDs", "type": "payouts", "eventType": "payments.payout.failed", "createdAt": "2026-06-04T10:31:45.000Z", "data": { "object": "payout", "id": "pyt_RqMgQG8izePfqqah6hTLaF", "financialAccountId": "finacc_AmKC5dMVXUbiAW8VzKBfqz", "receiver": { "accountId": "acc_BMY3UenpGBn8ZQ8hio4BgE", "payoutAddressId": "pytadd_PbDQ126YUAbkNrNX6XbGL" }, "rail": "SEPA", "sendAmount": "1087.000000", "sendCurrency": "USD", "receiveAmount": "995.40", "receiveCurrency": "EUR", "fees": { "totalAmount": "5.000000", "currency": "USD", "components": [ { "type": "NETWORK_FEE", "amount": "5.000000", "currency": "USD" } ] }, "fixedSide": "SEND", "fxRates": { "client": "1.08700", "convertedAmount": "1082.000000", "expiresAt": "2026-06-04T10:33:00.000Z" }, "status": "FAILED", "settlementTraceId": { "status": "AVAILABLE", "key": "END_TO_END_IDENTIFIER", "value": "OFX-2026-0604-0001" }, "confirmations": [ { "type": "QUOTE" }, { "type": "ACCOUNT_HOLDER_NAME", "mode": "SEPA_VOP", "result": "MATCH", "createdAt": "2026-06-04T10:30:04.000Z", "verifiedAt": "2026-06-04T10:30:05.000Z", "expiresAt": null } ], "failure": { "code": "PAYOUT_INSUFFICIENT_FUNDS", "message": "Insufficient funds in the financial account to cover the payout's debit." }, "return": null, "createdAt": "2026-06-04T10:30:05.000Z", "updatedAt": "2026-06-04T10:31:45.000Z", "processedAt": null, "previousStatus": "ACCEPTED" } }

Headers

X-OpenFX-Signature

string

required

t=<unix-timestamp>,v1=<hex-hmac>: a hex-encoded HMAC-SHA256 signature computed over {timestamp}.{raw_body} (the exact bytes sent, not a re-serialized copy) using your organization's signing secret for that environment. Reject if t is more than 300 seconds from now, then verify v1 with a constant-time compare. See Webhook authentication. Dedup on the delivered event's id, not on this header.

Example:

"t=1735689600,v1=5257a869e7bfbe00e0be2007c1b7be16bb2ba57ee233b0d0c4de5d83b3f5e01d"

Body

application/json

A payout reached FAILED, before any funds were sent. Read data.previousStatus for the origin: REQUIRES_CONFIRMATION when it failed before it was ever accepted, or ACCEPTED when settlement failed after confirm. A payout born FAILED at create carries no transition here; it arrives on payments.payout.created with data.status already FAILED.

No funds were sent, and data.failure carries the FailureCode for the cause.

object

string

required

The type of object represented, a fixed discriminator. Always "event" for this resource, and identical across every object of the type.

Allowed value: "event"

Example:

"event"

string

required

Event identifier, the client's dedup key for this delivery.

Pattern: ^evt_[1-9A-HJ-NP-Za-km-z]{21,22}$

Example:

"evt_5EdynMEiYSyiWAH9GpcbHp"

type

string

required

Resource noun this event is about, the plural of the resource segment in eventType. Route coarsely on this; switch on eventType for the specific transition.

Allowed value: "payouts"

Example:

"payouts"

eventType

string

required

Product-namespaced lowercase {product}.{resource}.{action} event type, the product segment mirroring the resource's URL, the one lowercase-enum exception on this platform (every other enum is SCREAMING_SNAKE).

Allowed value: "payments.payout.failed"

Example:

"payments.payout.failed"

createdAt

string<date-time>

required

Event timestamp.

Pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?Z$

Example:

"2026-06-04T10:30:00.000Z"

data

object

required

The Payout resource plus event-only context, embedded as data on every payments.payout.* webhook/event.

Delivered as the payout reads over the API, except that a name-bearing confirmation entry carries no name strings.

Show child attributes

Response

200

Return any 2xx to acknowledge receipt of the event.

Core concepts

Endpoints

Webhooks

Headers

Body

Response