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.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||