Skip to main content
POST
Create wallet (merchant or customer)
Creates a new wallet for either merchant or customer.

Key Features:

  • Supports both STABLECOIN (with network) and FIAT wallets
  • customer_id is optional (null for merchant wallets)
  • Automatic network validation based on currency type
  • Returns complete wallet details with addresses (for crypto)

Request Body:

Customer STABLECOIN Wallet:
Customer FIAT Wallet:
Merchant STABLECOIN Wallet:
Merchant FIAT Wallet:

Headers

x-api-key
string
required

Body

application/json
currency
enum<string>
required

Currency code

Available options:
USDC,
ZAR
Example:

"USDC"

description
string
required

Optional description (Recommended)

Maximum string length: 255
Example:

"My wallet"

customer_id
string<uuid> | null

Required for customer wallets, omit for merchant wallets

Example:

"85b148ab-3f6b-4d55-917f-3c8de668a48e"

network
enum<string> | null

Required for STABLECOIN only

Available options:
erc20,
polygon
Example:

"erc20"

Response

Wallet created successfully

status
string
Example:

"success"

data
object