Skip to main content
Sent when a payout destination is approved and can receive money. That covers one the system approved the moment it was registered, one approved by a reviewer, and one approved again after an edit. A destination that is still waiting for review sends nothing. Like other events on an account, a platform on event_source connect receives it for the accounts it owns, and the account itself receives it on account. See Connect events.

Event fields

string
The event’s unique identifier, prefixed evt_. Use it to deduplicate deliveries.
string
Always payout_destination.approved.
string
When the event occurred, in UTC.
string
The account that owns the destination.
string
The owning account’s id, repeated at the top level. Present only when the account has a parent. This is how a platform tells which of its accounts the event concerns.
string
The destination’s id, prefixed pd_. The same id the payout destinations endpoints return.
string
bank_account, mobile_money or crypto_wallet.
string
The destination’s currency, as an ISO 4217 code.
string
approved.
string | null
The reviewer’s note when there is one. Null when the destination was approved without a note.
boolean
True when the destination is approved and active, so a payout to it will be accepted.
boolean
Whether it is the account’s default destination for its currency.
string | null
When a person reviewed it, in UTC. Null when the system decided on its own.
No account number, bank detail or wallet address is sent. Fetch the destination to read those.

What to do on receipt

Match data.destination_id against the destination you registered and mark it ready. You can now create withdrawals to it.