Create a client wallet

This POST endpoint creates a new wallet for your own client account, in the requested currency.
To use this endpoint, you need to provide the currency_code as a JSON parameter in the Request Body. It must be an ISO 4217 currency code, such as USD, EUR or MXN.
A client can hold at most one wallet per currency, so the operation is idempotent: if you already have a wallet in the requested currency, that existing wallet is returned unchanged with a 200 status code instead of 201, and its balance reflects the current balance.
Newly created wallets start with a zero balance and can be funded through top-ups, pay-ins or wallet transfers. Client wallets are listed by the GET operation on /payout/account/balance.
A client wallet in a currency you have not funded payouts from before may need to be linked to a liquidity provider by MassPay before it can fund payouts; contact your account manager after creating one.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Client wallet creation request parameters

Request body for creating a wallet for your own client account.

string
required
length between 3 and 3

Currency the wallet is denominated in, using the ISO 4217 format. Case-insensitive.

Headers
string

Unique key to prevent duplicate processing

Responses

Language
Credentials
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json