Skip to main content
POST
/
offramp
Initiate Offramp
curl --request POST \
  --url https://api.linkio.world/transactions/v2/offramp \
  --header 'Content-Type: application/json' \
  --header 'ngnc-sec-key: <api-key>' \
  --data '
{
  "stables": "USDC",
  "amount": "20",
  "currency": "NGN",
  "bank_name": "<string>",
  "account_number": "<string>",
  "account_name": "<string>",
  "wallet_address": "<string>",
  "network": "<string>",
  "routing_number": "<string>",
  "account_type": "checkings",
  "chargeFeeOnRequest": true
}
'
"{\n    \"status\": \"success\",\n    \"message\": \"Transaction Request successful\",\n    \"transaction\": {\n        \"transaction_id\": \"645c31fdedd472fb04b3be53\",\n        \"business\": {\n            \"business_id\": \"0123456789\"\n        },\n        \"type\": \"Sell\",\n        \"reference\": \"64125118694\",\n        \"amount\": 102094,\n        \"account_name\": \"Tansi Jones\",\n        \"account_number\": \"9480948372\",\n        \"bank_name\": \"Wema bank\",\n        \"link_tag\": \"Link_eng\",\n        \"date_created\": \"May 11, 2023\"\n    }\n}"

Authorizations

​
ngnc-sec-key
string
header
default:""
required

Body

application/json
​
stables
enum<string>
required

Stable coin in which user wants to off-ramp in. (USDC, USDT)

Available options:
USDC,
USDT
​
amount
string
default:20
required

Amount in (USDC/USDT) that the users wishes to offramp into a USD or NGN bank account. (Min ~ 20 USDT / USDC).

​
currency
enum<string>
default:NGN
required

Currency in which user wants to receive funds. (NGN,USD)

Available options:
NGN,
USD
​
bank_name
string

Use the "fetch Payment banks" ENDPOINT to fetch the list of supported payment banks. Only the name needs to be passed

​
account_number
string

Customer's bank account number for where funds should be sent to.

​
account_name
string

Bank name associated with bank account number provided above.

​
wallet_address
string

Origin wallet address where funds would be sent from.

​
network
string

Wallet address network. Our supported networks are (Arbitrum, Avalanche, Stellar, Base, Polygon, Solana, Stellar, Tron, XRPL)

​
routing_number
string

Please provide routing number for USD request.

​
account_type
string
default:checkings

Please select either checkings or savings for USD request.

​
chargeFeeOnRequest
boolean
default:true

Setting this option to true, allows users see what amount they receive after the fee has been deducted. Currently available for payout to NGN accounts only.

Response

200

​
status
string
Example:

"success"

​
message
string
Example:

"Transaction Request successful"

​
transaction
object