Skip to main content
PUT
Set a refund destination

Authorizations

X-API-Key
string
header
required

Headers

Idempotency-Key
string<uuid>
required

Unique idempotency token per logical write (UUID v4). Re-send the same value on safe retries.

Example:

"a1b2c3d4-e5f6-47a8-b9c0-d1e2f3a4b5c6"

Body

application/json
currency
string
required

Settlement currency: 'NGN' or 'USDT'

Example:

"USDT"

type
enum<string>
required
Available options:
BANK_ACCOUNT,
CRYPTO_ADDRESS
Example:

"CRYPTO_ADDRESS"

bank_code
string

Required for BANK_ACCOUNT

Example:

"058"

account_number
string

Required for BANK_ACCOUNT — 10-digit NUBAN

Example:

"0123456789"

bank_name
string
Example:

"Guaranty Trust Bank"

network
enum<string>

Required for CRYPTO_ADDRESS — TRON or BSC only

Available options:
TRON,
BSC
address
string

Required for CRYPTO_ADDRESS

Example:

"TXyz1234abcd..."

tag
string

Destination tag/memo, where the chain uses one

Example:

null

Response

Destination saved

id
string
required
currency
string
required
Example:

"USDT"

type
enum<string>
required
Available options:
BANK_ACCOUNT,
CRYPTO_ADDRESS
bank_name
object | null
required
Example:

"Guaranty Trust Bank"

bank_code
object | null
required
Example:

"058"

account_number_masked
object | null
required

Masked — last 4 digits only

Example:

"******6789"

account_name
object | null
required

Bank-confirmed name

Example:

"ACME LTD"

network
enum<string> | null
required
Available options:
TRON,
BSC
address_masked
object | null
required

Masked — first 6 / last 4

Example:

"TXyz...abcd"

is_verified
boolean
required

Bank accounts only — crypto addresses cannot be verified

Example:

true

is_active
boolean
required
created_at
string
required
updated_at
string
required