Offramp

The offramp flow lets your users send crypto (USDT, USDC, BTC, ETH) and receive local currency (NGN, GHS, KES) in their bank account or mobile money wallet. Partna handles the crypto receipt, conversion, and local currency payout. If you want full control over the experience, use this API flow. If you would rather redirect users to a Partna payout flow, use the Offramp Widget instead.

How it works

Create a user account

Resolve the destination bank account

Verify the user’s bank account details using Resolve Bank. This confirms the account number and returns the account holder’s name.

curl --request POST \
  --url https://api.getpartna.com/v4/kyc/resolve-account \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'x-api-user: YOUR_USERNAME' \
  --data '{
    "accountNumber": "0123456789",
    "bankCode": "044",
    "currency": "NGN"
  }'

Response:

{
  "data": {
    "accountName": "JANE DOE",
    "accountNumber": "0123456789"
  },
  "message": "success"
}

Fetch a rate

Call Get Rate with fromCurrency=USDT and toCurrency=NGN. Save the rate key.

curl --request GET \
  --url 'https://api.getpartna.com/v4/rate?fromCurrency=USDT&toCurrency=NGN&fromAmount=100' \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'x-api-user: YOUR_USERNAME'

Initiate the offramp

Call Onramp and Offramp with type: "cryptoToFiat". Include the rate key, the user’s bank details, and the crypto amount.

curl --request POST \
  --url https://api.getpartna.com/v4/ramp \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'x-api-user: YOUR_USERNAME' \
  --data '{
    "type": "cryptoToFiat",
    "fromCurrency": "USDT",
    "fromNetwork": "tron",
    "fromAmount": 100,
    "toCurrency": "NGN",
    "toNetwork": "naira",
    "accountName": "JANE DOE",
    "accountNumber": "0123456789",
    "bankCode": "044",
    "rateKey": "RATE_KEY_FROM_STEP_4",
    "rampReference": "your-unique-reference-id"
  }'

The response includes a crypto wallet address where the user should send their USDT.

User sends crypto

The user sends the specified crypto amount to the wallet address returned in step 5.

Partna converts and pays out

Once Partna confirms the crypto deposit, the equivalent local currency is sent to the user’s bank account. A webhook event is dispatched to your endpoint.

Key parameters

Parameter	Description
`type`	Must be `cryptoToFiat` for offramp
`fromCurrency`	The crypto being sent (e.g., `USDT`, `USDC`, `BTC`)
`fromNetwork`	The blockchain network (e.g., `tron`, `ethereum`, `solana`)
`toCurrency`	The local currency for payout (e.g., `NGN`)
`toNetwork`	The payout network (e.g., `naira`, `mobileMoney`, `mpesa`)
`accountName`	The bank account holder’s name (from Resolve Bank)
`accountNumber`	The destination bank account number
`bankCode`	The bank code (from Get Banks)
`rateKey`	The rate key from Get Rate
`rampReference`	Your unique reference for this transaction

Custom payout amounts

By default, Partna pays the full converted amount to the user’s bank account. If you want to pay a different amount (e.g., to build in a margin), you can adjust the payout using the Withdraw endpoint after the crypto deposit is confirmed. This requires sufficient funds in your payout balance.

Getting bank codes

Use Get Banks to fetch the list of supported banks and their codes for a given currency:

curl --request GET \
  --url 'https://api.getpartna.com/v4/bank?currency=NGN' \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'x-api-user: YOUR_USERNAME'

Getting Started

Core Concepts

Guides

How it works

Key parameters

Custom payout amounts

Getting bank codes

​How it works

​Key parameters

​Custom payout amounts

​Getting bank codes

How it works

Key parameters

Custom payout amounts

Getting bank codes