Account Details

Account details are the banking coordinates Nuvion provisions for an account: routing and account numbers, IBANs, or wallet addresses that your entities share with payers to receive funds. Each account holds one set of account details, permanently bound once generated; receiving on more than one blockchain requires a separate stablecoin account per chain.

An account must exist before account details can be created for it. See Accounts for how to create an account.

Account details are often provisioned asynchronously. The create response returns status: pending; listen for the account_details.updated webhook to know when the details are ready.

The Account Details object

{
  "status": "success",
  "message": "Account detail retrieved successfully",
  "data": {
    "account_detail": {
      "id": "01HXYZ0050ABCDEFGHJKMNPQRS",
      "entity_id": "01HXYZ1234ABCDEFGHJKMNPQRS",
      "account_id": "01HXYZ0051ABCDEFGHJKMNPQRS",
      "issuer": {
        "name": "Thornbury Bank",
        "code": "040004",
        "scheme": "sort_code",
        "meta": {
          "parent_account_id": "00000000-0000-0000-0000-000000000004",
          "virtual_account_id": "00000000-0000-0000-0000-000000000005",
          "bban": "THRN04000400000001",
          "bank_address": "1 Example Street, London, England EC1N 8DX",
          "swift_code": "THRNGB22XXX"
        },
        "id": "000000000000000000000004"
      },
      "config": {
        "outflow_enabled": true,
        "inflow_enabled": true,
        "outflow_allowed_counterparties": [],
        "inflow_allowed_counterparties": []
      },
      "status": "active",
      "asset_type": "fiat",
      "beneficiary_name": "John Doe",
      "currency": "GBP",
      "created": 1787230804905,
      "updated": 1787230806170,
      "deleted": 0,
      "account_number": "00000001",
      "iban": "GB00THRN04000400000001",
      "status_reason": "Account request approved"
    }
  }
}

See The Account Details object for the full field-by-field schema, including issuer, config, and pending/active examples.

Fiat account details

Fiat account details provision real banking coordinates. The identifiers returned depend on the account’s currency:

Currency	Identifiers provided
`USD`	Account number, routing number, SWIFT code
`EUR`	IBAN, BIC
`GBP`	Account number, sort code
`CAD`	Account number, institution number, transit number
`AED`	Account number, IBAN
`NGN`	Account number
`GHS`	Account number, bank code
`MXN`	CLABE

Creating fiat account details

curl -X POST https://api.nuvion.dev/account-details \
  -H "Authorization: Bearer $NUVION_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "01HXYZ5678ABCDEFGHJKMNPQRS"
  }'

string

required

The ID of the account to generate banking coordinates for.

Returns the account details object, with asset_type: "fiat".

Stablecoin account details

Stablecoin account details provision a wallet address on a supported blockchain. The entity uses this address to receive stablecoin transfers. USDC and USDT are each available on all chains.

Chain	Network	Address format
`eth`	Ethereum Mainnet	`0x...`
`base`	Base	`0x...`
`matic`	Polygon	`0x...`
`sol`	Solana Mainnet	Base58

Creating stablecoin account details

curl -X POST https://api.nuvion.dev/account-details \
  -H "Authorization: Bearer $NUVION_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "01HXYZ6001ABCDEFGHJKMNPQRS",
    "chain": "eth"
  }'

string

required

The ID of the account to generate a wallet address for.

string

required

The blockchain to provision the wallet address on. One of eth, base, matic, sol.

Returns the account details object, with asset_type: "stablecoin" and one additional field:

string

The blockchain network the wallet address is on. One of eth, base, matic, sol.

{
  "status": "success",
  "message": "Account detail created successfully",
  "data": {
    "account_details": {
      "id": "01HXYZ8001ABCDEFGHJKMNPQRS",
      "entity_id": "01HXYZ1234ABCDEFGHJKMNPQRS",
      "account_id": "01HXYZ6001ABCDEFGHJKMNPQRS",
      "account_number": "0x111111111111111111111111111111111111AAAA",
      "issuer": {
        "code": "ETH_MAINNET",
        "name": "ETH_MAINNET",
        "short_name": "ETH_MAINNET"
      },
      "config": {
        "outflow_enabled": true,
        "inflow_enabled": true,
        "outflow_allowed_counterparties": [],
        "inflow_allowed_counterparties": []
      },
      "status": "pending",
      "asset_type": "stablecoin",
      "chain": "eth",
      "beneficiary_name": "Jane Smith",
      "currency": "USC",
      "created": 1787741665405,
      "updated": 1787741665405,
      "deleted": 0,
      "name": "Jane Smith",
      "meta": {}
    }
  }
}

{
  "status": "success",
  "message": "Account detail created successfully",
  "data": {
    "account_details": {
      "id": "01HXYZ8002ABCDEFGHJKMNPQRS",
      "entity_id": "01HXYZ1234ABCDEFGHJKMNPQRS",
      "account_id": "01HXYZ6002ABCDEFGHJKMNPQRS",
      "account_number": "0x222222222222222222222222222222222222BBBB",
      "issuer": {
        "code": "BASE_MAINNET",
        "name": "BASE_MAINNET",
        "short_name": "BASE_MAINNET"
      },
      "config": {
        "outflow_enabled": true,
        "inflow_enabled": true,
        "outflow_allowed_counterparties": [],
        "inflow_allowed_counterparties": []
      },
      "status": "pending",
      "asset_type": "stablecoin",
      "chain": "base",
      "currency": "UST",
      "beneficiary_name": "Jane Smith",
      "created": 1787758601261,
      "updated": 1787758601261,
      "deleted": 0,
      "name": "Jane Smith",
      "meta": {}
    }
  }
}

{
  "status": "success",
  "message": "Account detail created successfully",
  "data": {
    "account_details": {
      "id": "01HXYZ8003ABCDEFGHJKMNPQRS",
      "entity_id": "01HXYZ1234ABCDEFGHJKMNPQRS",
      "account_id": "01HXYZ6003ABCDEFGHJKMNPQRS",
      "account_number": "0x333333333333333333333333333333333333CCCC",
      "issuer": {
        "code": "POLYGON_MAINNET",
        "name": "POLYGON_MAINNET",
        "short_name": "POLYGON_MAINNET"
      },
      "config": {
        "outflow_enabled": true,
        "inflow_enabled": true,
        "outflow_allowed_counterparties": [],
        "inflow_allowed_counterparties": []
      },
      "status": "pending",
      "asset_type": "stablecoin",
      "chain": "matic",
      "currency": "USC",
      "beneficiary_name": "Jane Smith",
      "created": 1787758601261,
      "updated": 1787758601261,
      "deleted": 0,
      "name": "Jane Smith",
      "meta": {}
    }
  }
}

{
  "status": "success",
  "message": "Account detail created successfully",
  "data": {
    "account_details": {
      "id": "01HXYZ8004ABCDEFGHJKMNPQRS",
      "entity_id": "01HXYZ1234ABCDEFGHJKMNPQRS",
      "account_id": "01HXYZ6004ABCDEFGHJKMNPQRS",
      "account_number": "1111111111111111111111111111111111111111SoLA",
      "issuer": {
        "code": "SOLANA_MAINNET",
        "name": "SOLANA_MAINNET",
        "short_name": "SOLANA_MAINNET"
      },
      "config": {
        "outflow_enabled": true,
        "inflow_enabled": true,
        "outflow_allowed_counterparties": [],
        "inflow_allowed_counterparties": []
      },
      "status": "pending",
      "asset_type": "stablecoin",
      "chain": "sol",
      "currency": "UST",
      "beneficiary_name": "Jane Smith",
      "created": 1787758601261,
      "updated": 1787758601261,
      "deleted": 0,
      "name": "Jane Smith",
      "meta": {}
    }
  }
}

For stablecoin account details, pending means the wallet address is still being confirmed on-chain.

Webhook: `inflows.completed`

Listen for inflows.completed to be notified when funds arrive. This is the authoritative signal that the account has been credited.

{
  "event": "inflows.completed",
  "data": {
    "id": "01HXYZ0052ABCDEFGHJKMNPQRS",
    "amount": 10000,
    "currency": "USD",
    "unique_reference": "01HXYZ0053ABCDEFGHJKMNPQRS-1759504425996",
    "counterparty_id": "01HXYZ4021ABCDEFGHJKMNPQRS",
    "account_id": "01HXYZ5678ABCDEFGHJKMNPQRS",
    "entity_id": "01HXYZ1234ABCDEFGHJKMNPQRS",
    "status": "successful",
    "status_reason": "Successful.",
    "narration": "Invoice payment received",
    "type": "inflow",
    "payment_type": "bank-transfer",
    "applicable_fee": 0,
    "meta": {},
    "account": {
      "id": "01HXYZ5678ABCDEFGHJKMNPQRS",
      "display_name": "Primary USD Account"
    },
    "created": 1759860119195,
    "updated": 1759860119195
  }
}

See Event types for the full payload schema.

What’s next

Accept a payment

Use account details to receive a bank transfer or stablecoin deposit into an account.

Send a payout

Send funds from an account to any bank account globally.

Account Details API reference

Full endpoint documentation for creating and managing account details.

Get Started

Core Concepts

Webhooks

Guides

Account Details

The Account Details object

Fiat account details

Creating fiat account details

Stablecoin account details

Creating stablecoin account details

Webhook: `inflows.completed`

What’s next

Accept a payment

Send a payout

Account Details API reference

​The Account Details object

​Fiat account details

​Creating fiat account details

​Stablecoin account details

​Creating stablecoin account details

​Webhook: inflows.completed

​What’s next

Accept a payment

Send a payout

Account Details API reference

The Account Details object

Fiat account details

Creating fiat account details

Stablecoin account details

Creating stablecoin account details

Webhook: `inflows.completed`

What’s next