Sign in

v4

latestOpenAPI 3.1.0Proprietaryraw.githubusercontent.com2026-04-277127123.7 KB
Wallets

Create wallet

Creates a new wallet for a customer or the authenticated account.

post/wallets

Request body

currencystring required

ISO 4217 currency code.

customer_idinteger

Customer ID to assign the wallet to. Required unless customer_type is source.

customer_type'source' | 'user'

Pass source to create a wallet for the authenticated account. Pass user for a customer wallet (use with customer_id).

type'CURRENCYCLOUD' | 'CLEARJUNCTION'

Optional wallet provider type.

tagstring
metadataobject

Example request

{
  "customer_type": "user",
  "customer_id": 7485,
  "currency": "EUR",
  "tag": "bills"
}

Response

Wallet created

idinteger
selfstring
uuidstring
typestring nullable

Wallet provider type (e.g. CLEARJUNCTION, CURRENCYCLOUD). Null for standard wallets.

balancenumber float
currencystring
tagstring nullable
metadataobject nullable
created_atstring date-time nullable
connectionsConnections

Hypermedia links to related resources.

Example response

{
  "balance": 250,
  "currency": "EUR"
}