Accounts

1. How should a platform consume Decentro's virtual account API to build a frontend?

The workflow for building a frontend on virtual account API is as follows:

1. When the platform onboards a user on its mobile or web app, it should execute Decentro's create consumer API by passing the details collected during the user's onboarding journey. This will generate a unique consumer reference number. The platforms should mandatorily collect the following information in onboarding to create consumers:
   1. Full name
   2. Email address
   3. Country code
2. Once consumer creation is done, platforms can display the create virtual account screen, as shown below. The name can be pre-filled with the details collected in the previous step:

3. Once the virtual account is created, platforms can display virtual account details as shown below.

4. The same screen can be used as the "View virtual account details" screen on the platform's mobile or web app.
5. When the user clicks on the "deposit funds" CTA, they will be shown the details they must use on their mobile or net banking to initiate a deposit. Please note that here, the account name will be the name of the licensed entity, i.e., Airwallex Pvt. Ltd.

2. How should a platform map virtual and currency accounts with the customer ledger it maintains at its end?

Platforms can refer to the diagrams below to build the ledger flows as their end -

3. What are the account details required to make a deposit to a virtual account?

The details required to make a deposit to a virtual account depends upon the currency of deposit. Below are the details required for making a deposit to each supported currency:

1. USD
   1. Account Name
   2. Account Number
   3. ABA code
   4. SWIFT code (only if payment method is SWIFT)
2. AUD
   1. Account Name
   2. Account Number
   3. BSB code
   4. SWIFT code (only if payment method is SWIFT)
3. SGD
   1. Account Name
   2. Account Number
   3. Branch Code
   4. Bank Code
   5. SWIFT Code
4. CAD
   1. Account Name
   2. Account Number
   3. Transit Number
   4. Institution Number
   5. SWIFT Code
5. EUR
   1. Account Name
   2. IBAN
   3. Account Number (Only required in specific European Union zones)
   4. SWIFT Code
6. GBP
   1. Account Name
   2. IBAN
   3. Account Number
   4. Sort Code
   5. SWIFT Code