Skip to main content
To create a bank account for fiat transaction you need to do the following:
  • Create an Entity and complete onboarding
  • Set up account
The rest of this guide will focus on create an entity, setting up an account, and finally generating a bank account details.

​
Create Entity and Complete Onboarding

Entities represent organizations or individuals with their own legal identity. To create an entity and complete onboarding, follow the steps below:
  1. Click this onboarding link. Fill the form and click on the Create Account button.
  2. Supply the required documents
  3. Wait for a few seconds for account to be approved
  4. You’ll be automatically taken to your entity dashboard

​
Setup Account

After your entity has been created and approved, the next step is to set up an account for your entity. This account keeps all financial records for your entity. It helps you hold, send or receive fiat. To set up an account: Create API Key from the developer secton of your entity dashboard
Make sure you update the Authorization header with your API key
Specify the type, currency, and display_name. You can also add optional metadata and config setting for the account. Run the request below: Set up account 
curl POST --location --globoff 'https://{baseURL}/accounts' \
--header 'Authorization: Bearer {{NUVION_API_KEY}}' \
--header 'Content-Type: application/json' \
--data '{
    {
        "type": "debit",
        "currency": "NGN",
        "display_name": "Frank",
        "meta": {
        "purpose": "Personal expenses",
        "category": "primary"
        },
        "config": {
            "is_overdraftable": false,
            "overdraft_limit": 0
        }
    }
}'
With the steps above, you have an account set up to hold, send, and receive funds.

​
Get Bank Accout Details

The next step is to get the bank account details.
Make sure you update the Authorization header with your API key
 Run the request below: Generate account details
Example
curl POST --location --globoff 'https://{baseURL}/account-details' \
--header 'Authorization: Bearer {{NUVION_API_KEY}}' \
--header 'Content-Type: application/json' \
--data '{
      "account_id": "01HJ5G6R7MXW5ZK2QD6YA8N9F5",
    "config": {
        "outflow_enabled": true,
        "inflow_enabled": true,
        "outflow_allowed_counterparties": [
            "01HJ5G6R7MXW5ZK2QD6YA8N9F6"
        ],
        "inflow_allowed_counterparties": [
            "01HJ5G6R7MXW5ZK2QD6YA8N9F7"
        ]
    },
    "terminate_after": 365,
}'
Specify the account_id. It is the only required parameter to get account details. However, you can as well optionally pass in the following parameters:
  • config: This specify the configuration setting for the account details [outflow_enabled, inflow_enabled, outflow_allowed_counterparties, inflow_allowed_counterparties]
  • asset_type: Specify fiat
Congratulations! You have successfully completed onboarding, set up an account, account details and amde transfer from your for your entity.