Set a refund destination

NGN routes to a Nigerian bank account (verified by name enquiry before saving); USDT routes to a crypto address on TRON or BSC. One destination per currency — setting it again replaces it. Required before payouts can be created.

PUT /v1/refund-destinations

Set a refund destination

cURL

curl --request PUT \
  --url https://api.spendin.app/v1/refund-destinations \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "currency": "USDT",
  "type": "CRYPTO_ADDRESS",
  "bank_code": "058",
  "account_number": "0123456789",
  "bank_name": "Guaranty Trust Bank",
  "address": "TXyz1234abcd...",
  "tag": null
}
'

200

{
  "id": "<string>",
  "currency": "USDT",
  "bank_name": "Guaranty Trust Bank",
  "bank_code": "058",
  "account_number_masked": "******6789",
  "account_name": "ACME LTD",
  "address_masked": "TXyz...abcd",
  "is_verified": true,
  "is_active": true,
  "created_at": "<string>",
  "updated_at": "<string>"
}

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

200

application/json

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