Send money anywhere — customers, partners, suppliers, or external accounts.
Choose payout type
Create a payout
Track status
amount
, currency
, and destination
.
The destination can be a previous orderId
for closed-loop payouts or a financialAddress
for open-loop payouts. Set the orderId
field in the destination
object to send a closed-loop payout, i.e. a payout to a customer who has previously paid in money using Ivy Instant Bank Payments.
Status | Description |
---|---|
paid | The payout has been successfully initiated and funds have left the Ivy sending account. |
failed | The payout could not be initiated. Can be caused by insufficient funds, a technical error, an invalid beneficiary, or bank rejection |
canceled | The payout flow was cancelled before being attempted. Can be caused by invalid requests, account issues, or manual cancellation by merchant admins. |
Event | Description |
---|---|
payout.initiated | Sent when a payout is created and processing begins |
payout.paid | Sent when the status reaches paid. Initiation succeeded and funds have been sent |
payout.failed | Sent when the status reaches failed |