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

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 Stablecoin Account

After your entity has been created and approved, the next step is to set up an account for your entity. This account is a digital wallet that helps you hold, send or receive stablecoin. 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": "checking",
        "currency": "USD",
        "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.

Generat Wallet Address

The next step is to get the wallet address.
Make sure you update the Authorization header with your API key
Run the request below: Generate account details
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,
    "asset_type": "stablecoin",
    "chain": "eth"
}'
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 stablecoin
  • chain: Specify eth, sol, base, matic for Ethereum, Solana or Polygon wallets when asset_type is stablecoin.
Congratulations! You have successfully completed onboarding, set up an account and wallet address for your entity.