Payout links
Pay someone without ever handling their bank details.
Your server creates a single-use link and sends the URL to the recipient by SMS, email or your app. They enter their own bank details on a page Avvio hosts, and the payout is sent from your balance.
How it works
Section titled “How it works”- Create the link from your backend with the amount, the destination
currency and your end user. The response carries a
urland anexpiresAt(60 minutes by default, up to 7 days). - Send the URL to the recipient.
- Collect. The hosted page shows your organization’s display name, the amount, a rate preview and the fields the corridor needs, plus any accounts the end user saved before.
- Pay. On submit the page registers the bank details, prices the payout and sends it from your balance.
- Track it like any other payout, through webhooks and the event feed.
Coverage
Section titled “Coverage”A payout link can pay the currencies your organization can pay out to. For a
USD link the hosted form asks for your USD corridor’s fields, which depend on
your routing: a domestic US account or an international bank’s SWIFT details.
See
Countries and currencies and read
GET /recipients/{orgId}/corridors for your routing.
Key features
Section titled “Key features”Bank details stay off your systems
Section titled “Bank details stay off your systems”Account and routing numbers never touch your servers, so they stay outside your compliance and security surface. The recipient’s browser holds a single-use signed token, never your API key.
A form that follows the corridor
Section titled “A form that follows the corridor”When a corridor changes its required fields, the hosted form changes with it. Your code does not.
One payout per link
Section titled “One payout per link”Your Idempotency-Key is stored on the link, and a second submit returns the
original payout with status: "already_submitted". Creating the link twice,
or a double tap on a flaky mobile connection, cannot produce two payouts.
A regulatory receipt on every payout
Section titled “A regulatory receipt on every payout”A hosted link payout is a remittance transfer under Regulation E (12 CFR 1005
subpart B). On submit, the sender is emailed a receipt with the transfer amount,
fees, total, exchange rate, what the recipient receives, the transaction id and
time, the provider’s contact details, and how to dispute an error. The submit
response returns the same figures as disclosure for the page to show.
Delivery (address, time, message id) is recorded on the link as evidence.
The receipt states no cancellation right. A link payout is debited from your balance when it is accepted (the fee on top of the link’s amount), and the sender cannot recall it. On a routing where you fund each payout yourself, nothing moves until you fund it.
Integration guides
Section titled “Integration guides”- Send a payout link: create the link and handle the hosted flow.
- Track status & failures: what happens after the payout is sent.
- The in-app flow for React Native is
@avvio/payouts-react-native.
Was this page helpful?