Platform Accounts

This guide will help you understand different types of platform accounts, like how to set up fiat and trading accounts at the bank level, so you can confidently apply them to your implementation.

For each fiat currency, partners can create (at least) one platform fiat account. Similarly, for each cryptocurrency, partners can create (at least) one platform trading account at the bank level.

Creating a Platform Funding Account

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

• Create the account using the POST /api/accounts endpoint
  • Provide the "fiat" value in "type" parameter
  • Provide the "USD" value in the "asset" parameter
  • Leave the "customer_guid" parameter empty to create the account at the bank-level
  • Provide a descriptive value for the "name" parameter

{
  "type": "fiat",
  "asset": "USD",
  "name": "USD funding account for the bank"
}

• 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

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 bank 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

As an example, let's create a BTC trading account for the bank.

• Create the account using the POST /api/accounts endpoint
  • Provide the "trading" value in "type" parameter
  • Provide the "BTC" value in the "asset" parameter
  • Leave the "customer_guid" parameter empty to create the account at the bank-level
  • Provide a descriptive value for the "name" parameter

{
  "type": "trading",
  "asset": "BTC",
  "name": "BTC trading account for the bank"
}

• 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.