Create a Wallet (New)

post

https://api-wallet-sandbox.vertofx.com/{companyId}/wallets

Create a currency-specific wallet, understand the core request fields, and store the returned wallet ID for receive, FX, transfer, and payout flows.

📘
Check your base URL
Each Verto service has its own host. Use the base URL shown in the endpoint definition on this page — do not reuse a host from another service.
Sandbox hosts end in -sandbox.vertofx.com; the matching production host replaces sandbox with beta. Sending a request to the wrong environment returns 403.
See URLs (Sandbox vs Production) for the full service-by-service list.

Path Params

companyId

string

required

Specifies the unique identifier assigned to a company within the system.
Get the companyId in the response path [response.body.companyId] of the POST /users/login API.

Body Params

currency

string

enum

required

length between 3 and 3

3-character ISO 4217 currency code used to denote a specific currency. It serves as a universal identifier for the type of money involved in a wallet transaction.

type

string

enum

required

Indicates the type of wallet.

STANDARD: Most common type of wallet used for everyday transactions.
FX_BALANCE: Specifically focuses on foreign exchange (FX) transactions.

Allowed:

customReferenceLabel

string

length ≤ 75

Indicates the custom label provided to a wallet by the customer.
If a custom label is not provided by the customer, system itself will create a label in the below format based on the currency selected.

Responses

200New wallet creation

400Bad Request

401Unauthorized

403Forbidden

404Not Found

500Internal Server Error