payout.failed

{
  "id": "evt_1a2b3c4d5e6f7g8h",
  "type": "payout.failed",
  "created_at": "2026-04-27T12:00:00.000000+00:00",
  "organization_id": "acct_7KpQ2mNv4XbR9dLc",
  "data": {
    "withdrawal_id": "pay_4Xr9dLc0mNv7Kq2B",
    "reference": "payout_9876",
    "status": "failed",
    "amount": "500.00",
    "currency": "USD",
    "from_currency": "USD",
    "to_currency": "NGN",
    "exchange_rate": "1650.00",
    "to_amount": "825000.00",
    "withdrawal_fee": "2.50",
    "net_from_amount": "497.50"
  }
}

{
  "id": "evt_1a2b3c4d5e6f7g8h",
  "type": "payout.failed",
  "created_at": "2026-04-27T12:00:00.000000+00:00",
  "organization_id": "acct_7KpQ2mNv4XbR9dLc",
  "data": {
    "withdrawal_id": "pay_4Xr9dLc0mNv7Kq2B",
    "reference": "payout_9876",
    "status": "failed",
    "amount": "500.00",
    "currency": "USD",
    "from_currency": "USD",
    "to_currency": "NGN",
    "exchange_rate": "1650.00",
    "to_amount": "825000.00",
    "withdrawal_fee": "2.50",
    "net_from_amount": "497.50"
  }
}

Sent when a payout fails. Use it to notify your team and retry or correct the destination.

{
  "id": "evt_1a2b3c4d5e6f7g8h",
  "type": "payout.failed",
  "created_at": "2026-04-27T12:00:00.000000+00:00",
  "organization_id": "acct_7KpQ2mNv4XbR9dLc",
  "data": {
    "withdrawal_id": "pay_4Xr9dLc0mNv7Kq2B",
    "reference": "payout_9876",
    "status": "failed",
    "amount": "500.00",
    "currency": "USD",
    "from_currency": "USD",
    "to_currency": "NGN",
    "exchange_rate": "1650.00",
    "to_amount": "825000.00",
    "withdrawal_fee": "2.50",
    "net_from_amount": "497.50"
  }
}

Event fields

string

The event’s unique identifier, prefixed evt_. Use it to deduplicate deliveries.

string

Always payout.failed.

string

When the event occurred, in UTC.

string

Your account’s ID.

string

The payout’s ID.

string | null

The reference you set when you created the payout. null if you set none.

string

Payout status, always failed on this event.

string

The payout amount in data.currency.

string

The source currency, as an ISO 4217 code.

string | null

The currency debited from your balance.

string | null

The currency delivered to the destination.

string | null

The FX rate applied, when a conversion occurred.

string | null

The amount delivered in data.to_currency.

string | null

The payout fee, when applicable.

string | null

The net amount debited after fees.

Concepts

Events

Endpoint API

payout.failed

Event fields

​Event fields

Event fields