Account Details

Account details are the banking coordinates provisioned by Nuvion for an account. They are what your entities share with counterparties to receive funds — routing numbers and account numbers for USD, IBANs and BICs for EUR, and wallet addresses for stablecoin rails. Each account can have one active set of fiat account details and one per stablecoin chain. Once generated, account details are permanently bound to that account and cannot be reassigned.

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

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
`ZAR`	Account number, branch code

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": "acc_01HXYZ5678EFGH",
  }'

string

required

The ID of the account to generate banking coordinates for.

number

Number of days after which the account details expire. Omit for permanent details. See Expiration.

string

Provider identifier for issuance. Omit to use Nuvion’s default provider.

Fiat account details object

{
  "id": "acd_01HXYZ9012IJKL",
  "entity_id": "ent_01HXYZ1234ABCD",
  "account_id": "acc_01HXYZ5678EFGH",
  "asset_type": "fiat",
  "account_number": "4561237890",
  "issuer": {
    "name": "Lead Bank",
    "code": "021000021"
  },
  "status": "active",
  "created": 1735725600000,
  "updated": 1735725600000
}

{
  "id": "acd_01HXYZ9012IJKL",
  "entity_id": "ent_01HXYZ1234ABCD",
  "account_id": "acc_01HXYZ5678EFGH",
  "account_number": "DE89370400440532013000",
  "issuer": {
    "name": "Nuvion EU",
    "code": "NUVIDEF1"
  },
  "status": "active",
  "created": 1735725600000,
  "updated": 1735725600000
}

{
  "id": "acd_01HXYZ9012IJKL",
  "entity_id": "ent_01HXYZ1234ABCD",
  "account_id": "acc_01HXYZ5678EFGH",
  "account_number": "12345678",
  "issuer": {
    "name": "Nuvion UK",
    "code": "20-00-00"
  },
  "status": "active",
  "created": 1735725600000,
  "updated": 1735725600000
}

string

Unique identifier for the account details. ULID format.

string

The ID of the entity that owns the account.

string

The ID of the account these details belong to.

string

The bank account number or IBAN, depending on the account’s currency.

object

The financial institution that issued the account details.

Show issuer fields

string

Name of the issuing financial institution.

string

Routing number (USD), BIC (EUR), or sort code (GBP).

string

Current status of the account details. active when ready to receive funds.

number

Unix timestamp in milliseconds of when the account details were created.

number

Unix timestamp in milliseconds of the last update.

Account details are persistent. Create them once per account and store them — you don’t need to regenerate them for each transaction.

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 supported 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": "acc_01HXYZ5678EFGH",
    "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.

Stablecoin account details object

{
  "id": "acd_01HXYZ9012MNOP",
  "entity_id": "ent_01HXYZ1234ABCD",
  "account_id": "acc_01HXYZ5678EFGH",
  "chain": "eth",
  "account_number": "0x71C7656EC7ab88b098defB751B7401B5f6d8976F",
  "supported_assets": ["USDC", "USDT"],
  "issuer": {
    "name": "Ethereum Mainnet",
    "code": "eth"
  },
  "status": "pending",
  "created": 1735725600000,
  "updated": 1735725600000
}

{
  "id": "acd_01HXYZ9012MNOP",
  "entity_id": "ent_01HXYZ1234ABCD",
  "account_id": "acc_01HXYZ5678EFGH",
  "chain": "base",
  "account_number": "0x3fC91A3afd70395Cd496C647d5a6CC9D4B2b7FAD",
  "supported_assets": ["USDC", "USDT"],
  "issuer": {
    "name": "Base",
    "code": "base"
  },
  "status": "pending",
  "created": 1735725600000,
  "updated": 1735725600000
}

{
  "id": "acd_01HXYZ9012MNOP",
  "entity_id": "ent_01HXYZ1234ABCD",
  "account_id": "acc_01HXYZ5678EFGH",
  "chain": "matic",
  "account_number": "0x8f3Cf7ad23Cd3CaDbD9735AFf958023239c6A063",
  "supported_assets": ["USDC", "USDT"],
  "issuer": {
    "name": "Polygon",
    "code": "matic"
  },
  "status": "pending",
  "created": 1735725600000,
  "updated": 1735725600000
}

{
  "id": "acd_01HXYZ9012MNOP",
  "entity_id": "ent_01HXYZ1234ABCD",
  "account_id": "acc_01HXYZ5678EFGH",
  "chain": "sol",
  "account_number": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
  "supported_assets": ["USDC", "USDT"],
  "issuer": {
    "name": "Solana Mainnet",
    "code": "sol"
  },
  "status": "pending",
  "created": 1735725600000,
  "updated": 1735725600000
}

Stablecoin account details are initially created with status: pending while the wallet address is being provisioned. Listen for the account_details.activated webhook event to know when the address is ready to receive funds.

string

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

string

The provisioned wallet address. EVM-format (0x...) for eth, base, and matic; Base58 for sol.

array

The stablecoins this address can receive. Always ["USDC", "USDT"].

Expiration

By default, account details are permanent. Pass terminate_after to set an expiry date — the details will deactivate automatically after the specified number of days.

{
  "account_id": "acc_01HXYZ5678EFGH",
  "terminate_after": 30
}

Use cases for expiring account details:

Temporary collection accounts — generate a unique receiving address per transaction that expires after collection
Time-limited links — share banking coordinates that self-deactivate after a campaign or event
Short-lived virtual accounts — provision and expire accounts for one-off payout flows

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": "01K6ZXCNMVA04GM3WQRCKQNCMB",
    "amount": 10000,
    "currency": "USD",
    "unique_reference": "01K6ZX7360026KPNA2SQ6NPNZY-1759504425996",
    "counterparty_id": "acct-01K6ZX7360026KPNA2SQ6NPNZY",
    "account_id": "acc_01HXYZ5678EFGH",
    "entity_id": "ent_01HXYZ1234ABCD",
    "status": "successful",
    "status_reason": "Successful.",
    "narration": "Invoice payment received",
    "type": "inflow",
    "applicable_fee": 0,
    "meta": {},
    "created": 1759860119195,
    "updated": 1759860119195
  }
}

string

Unique identifier for the inflow transaction.

number

Amount received in the smallest currency unit. e.g. 10000 = $100.00 USD.

string

ISO 4217 currency code of the received funds.

string

Idempotency reference for the transaction. Use this to deduplicate webhook deliveries.

string

Identifier for the sender’s account.

string

The ID of the Nuvion account that was credited.

string

The ID of the entity whose account was credited.

string

Always successful for this event.

string

Payment reference provided by the sender.

number

Fee applied to the inflow in the smallest currency unit.

string

Always inflow.

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

Fiat account details

Creating fiat account details

Fiat account details object

Stablecoin account details

Creating stablecoin account details

Stablecoin account details object

Expiration

Webhook: `inflows.completed`

What’s next

Accept a payment

Send a payout

Account Details API reference

​Fiat account details

​Creating fiat account details

​Fiat account details object

​Stablecoin account details

​Creating stablecoin account details

​Stablecoin account details object

​Expiration

​Webhook: inflows.completed

​What’s next

Accept a payment

Send a payout

Account Details API reference

Fiat account details

Creating fiat account details

Fiat account details object

Stablecoin account details

Creating stablecoin account details

Stablecoin account details object

Expiration

Webhook: `inflows.completed`

What’s next