payout.created

{
  "id": "evt_1a2b3c4d5e6f7g8h",
  "type": "payout.created",
  "created_at": "2026-04-27T12:00:00.000000+00:00",
  "organization_id": "acct_7KpQ2mNv4XbR9dLc",
  "data": {
    "withdrawal_id": "pay_4Xr9dLc0mNv7Kq2B",
    "reference": "payout_9876",
    "status": "pending",
    "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.created",
  "created_at": "2026-04-27T12:00:00.000000+00:00",
  "organization_id": "acct_7KpQ2mNv4XbR9dLc",
  "data": {
    "withdrawal_id": "pay_4Xr9dLc0mNv7Kq2B",
    "reference": "payout_9876",
    "status": "pending",
    "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 you initiate a payout. Use it to track the payout from request to settlement.

{
  "id": "evt_1a2b3c4d5e6f7g8h",
  "type": "payout.created",
  "created_at": "2026-04-27T12:00:00.000000+00:00",
  "organization_id": "acct_7KpQ2mNv4XbR9dLc",
  "data": {
    "withdrawal_id": "pay_4Xr9dLc0mNv7Kq2B",
    "reference": "payout_9876",
    "status": "pending",
    "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.created.

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, pending 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.created

Event fields

​Event fields

Event fields