Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.relayer.fi/llms.txt

Use this file to discover all available pages before exploring further.

The Payout Kit gives operators regulated fiat rails for moving money between stablecoins and bank accounts. Clients deposit stablecoins to a deposit account and receive fiat at the recipient bank — or deposit fiat and receive stablecoins at a withdrawal address. You manage the full cycle: business onboarding, recipient configuration, account setup, and settlement execution.

Core Concepts

Off-ramp and On-ramp

Two directions, same primitives:
  • Off-ramp — stablecoins in, fiat out. Money flows from a withdrawal address to a recipient’s bank account.
  • On-ramp — fiat in, stablecoins out. Money flows from a deposit account (e.g. a CLABE) to a stablecoin wallet.
Both flows use quote → setup → execute as the canonical lifecycle.

Business Onboarding (KYB)

Before sending or receiving fiat, your workspace must complete KYB. KYB is a one-time setup managed through the Dashboard. Once approved, your workspace can create deposit accounts, withdrawal addresses, and process transfers.

Recipients (Beneficiaries)

A recipient (beneficiary) is the person or business you want to pay — identified by name, address, and one or more bank accounts. Recipients are managed under /v1/payout/recipients. Recipient lifecycle:
  1. Create the recipient record (name, address, owner type)
  2. Generate an invite link — the recipient submits their bank details via a hosted form
  3. Add the bank account to the recipient (registered with the fiat rails partner)
  4. Recipient is ready to receive payouts

Withdrawal Addresses (Off-ramp)

A withdrawal address is a crypto address linked to a recipient’s bank account. When stablecoins are sent to this address, the off-ramp transfer to the linked bank is initiated automatically.
POST /v1/payout/offramp/withdraw-addresses
The call is idempotent.

Deposit Accounts (On-ramp)

A deposit account is a permanent fiat account (e.g. a SPEI CLABE in Mexico) tied to a stablecoin wallet. Your client sends fiat to this account and the funds settle to the linked wallet.
POST /v1/payout/onramp/deposit-accounts
The call is idempotent.

Quotes and Settlement

Before executing a transfer, get a quote to see the rate and fees. Then execute to trigger the actual transfer.
POST /v1/payout/offramp/quote      — Get stablecoin → fiat rate
POST /v1/payout/onramp/quote       — Get fiat → stablecoin rate
POST /v1/payout/accounts/quote     — Get cross-currency rate (e.g. MXN → USD)
POST /v1/payout/accounts/execute   — Trigger settlement

Orders

Every transfer is represented as an order in /v1/orders. Unified across rails — list, get, and cancel are the same regardless of direction.

Endpoint Summary

GroupPrefixPurpose
Accounts/v1/payout/accountsCross-currency quotes and payment execution
On-ramp/v1/payout/onrampFiat → stablecoin: deposit accounts, quotes
Off-ramp/v1/payout/offrampStablecoin → fiat: withdrawal addresses, quotes
Recipients/v1/payout/recipientsBeneficiary CRUD and bank account registration
Orders/v1/ordersUnified order list, status, and cancel

Integration Overview

Next Steps

Flow Guide

Execute an end-to-end payout step by step.

Endpoints

Accounts, on/off-ramp, and recipient endpoint reference.