Skip to content

API reference

Avvio Partner Payouts

Base URL https://api.avvio.xyz/business/api/v1. A key you enter here stays in this tab and is never saved.

Pay people in their local currency from your funded USD balance. Your end users never onboard with Avvio: the money leaves your balance, and the recipient is your counterparty.

Send your API key as x-api-key on every request. A test key (avvio_test_…) runs the same calls against your sandbox on the same base URL. To try a call here, authorize with your complete test key and enter your organization id as orgId. The two /payout-links/{token} operations take no key: the link token is their credential.

Retry a timed-out write with the same Idempotency-Key and you get the original result. A new key pays twice. Idempotency lists which operations require the header.

The fields a recipient needs depend on how your organization is routed, and routing can change, so build your form from GET /recipients/{orgId}/corridors.

Generate a client in any language from this file (openapi-generator-cli generate -i partner-payouts.openapi.yaml -g java -o ./avvio), or use @avvio/payments for Node.