Creating Accounts

Learn how to create fiat and trading accounts for customers

For each fiat currency that a customer funds, they will need a fiat account. Similarly, for each crypto currency a customer trades, they will need a trading account.

Reminder: Customer state must be "Verified" before creating their accounts. Be sure to complete an identity verification for the customer prior to creating their accounts.

Funding account

As an example, let's create a USD fiat account for the customer:

• Create the account using the POST /api/accounts endpoint
  • Provide the "fiat" value in type parameter
  • Provide the "USD" value in the asset parameter
  • Provide the customer_guid parameter
  • Provide a descriptive value for the name parameter

{
  "type": "fiat",
  "asset": "USD",
  "customer_guid": "<insert customer_guid>",
  "name": "USD funding account"
}

• Once executed, you should receive a success response with the new account details including the account state
• The account state will be "storing" after the executing the above POST request
• The account state will progress to "created" once the account is fully provisioned
• In the sandbox environment the provisioning is instantaneous; however, in the production environment there are additional provisioning steps which may add a short delay between the "storing" and "created" state. When planning production integrations, be sure to engineer for these two possible states.

With a funding account now created, you are ready to generate a quote and create a funding deposit transfer.

Multiple funding accounts

Please contact support to request the ability to create multiple fiat accounts on a customer basis. This is applied to both bank and customer level accounts. There must be a maximum number of accounts.

You may see this error if you need to be configured to handle multiple fiat accounts:

{
  "status": 409,
  "error_message": "Account(s) for asset already exists",
  "message_code": "data_exists"
}

Trading account

• Create the account using the POST /api/quotes endpoint
  • Provide the "trading" value in type parameter
  • Provide the "BTC" value in the asset parameter
  • Provide the customer_guid parameter
  • Provide a descriptive value for the name parameter

{
  "type": "trading",
  "asset": "BTC",
 "customer_guid": "<insert customer_guid>",
  "name": "BTC trading account"
}

• Once executed, you should receive a success response with the new account details including the account state
• As above, the account state will initially be "storing" and progress to "created"

With a trading account now created, you are ready to generate a quote and create a crypto buy trade.