Initiate a stablecoin → fiat payout via LINK’s OTC desk. You provide the core transaction details plus your settlement banking details (the account you want to receive fiat into).Documentation Index
Fetch the complete documentation index at: https://docs.linkio.world/llms.txt
Use this file to discover all available pages before exploring further.
Endpoint
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
customer_id | string | ✓ | Your platform’s customer ID for this transaction. |
currency | string | ✓ | Fiat currency to receive (e.g., NGN, USD, EUR). See Supported Currencies. |
amount | string | ✓ | Stablecoin amount being sent. |
stables | string | ✓ | Stablecoin being sent: USDC or USDT. |
wallet_address | string | ✓ | Wallet address sending the stablecoin. |
network | string | ✓ | Blockchain network (e.g., solana, polygon). |
paymentDetails | object | ✓ | Your settlement banking details — the account you want to receive fiat into. Required fields depend on your currency’s payment method (see table below). |
Payment Method & paymentDetails Fields
Call GET /otc/rate_quote?currency={currency}&amount={amount}&trx_type=offramp first — the response includes a paymentMethod field that tells you which method applies to your currency.
| Payment Method | Currencies | Required fields in paymentDetails |
|---|---|---|
| **NIP ** | NGN | accountNumber, accountName, bankName |
| GIP | GHS | accountNumber, accountName, bankName |
| ACH | USD | accountNumber, routingNumber, accountName |
| SEPA | EUR | iban, beneficiaryName, bankName |
| PIX | BRL | pixKey, accountHolder |
| CNAPS | CNY | accountNumber, accountName, bankName, cnapsCode |
| PESONet | PHP | accountNumber, accountName, bankName |
| Mobile Money | EGP, SLE, SSP, TZS, UGX, XAF, XOF | provider, phoneNumber, accountName |
| SWIFT | AED, AOA, CAD, CDF, DZD, GBP, HKD, IDR, LYD, MAD, MWK, MZN, SGD, TRY | accountName, bankName, accountNumber, swiftCode |
JSON Request Examples
Response (201)
What Happens Next
- Send stablecoin — Transfer the stablecoin from
wallet_addressto the LINK-provided address. - Status updates — LINK fires a
transaction_status_updatedwebhook as we process the payout:
transaction_status values:
| Value | Meaning | Internal status |
|---|---|---|
pending | Awaiting partner action | pending |
processing | Partner is processing the payout | processing |
rfi | Partner needs additional information | processing |
completed | Fiat payout delivered to your account | completed |
failed | Payout could not be completed | failed |
OTC Onramp Webhooks

