Account Details

Entities can receive funds directly into their Nuvion account using provisioned banking coordinates or a stablecoin wallet address. No hosted checkout or payment session is required: share the details with your payer, and Nuvion notifies you via webhook when funds arrive.

Step 1: Provision account details

Use POST /account-details. For a fiat account, pass just account_id; for a stablecoin account, also pass chain. See Create account details for the full request and response field reference, and Account Details for which identifiers are returned per currency and chain.

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

{
  "status": "success",
  "message": "Account detail created successfully",
  "data": {
    "account_details": {
      "id": "01HXYZ7001ABCDEFGHJKMNPQRS",
      "entity_id": "01HXYZ1234ABCDEFGHJKMNPQRS",
      "account_id": "01HXYZ5678ABCDEFGHJKMNPQRS",
      "issuer": {
        "name": "NUV",
        "short_name": "NUV",
        "code": "NUV"
      },
      "config": {
        "outflow_enabled": true,
        "inflow_enabled": true,
        "outflow_allowed_counterparties": [],
        "inflow_allowed_counterparties": []
      },
      "status": "pending",
      "asset_type": "fiat",
      "beneficiary_name": "Jane Smith",
      "currency": "GBP",
      "created": 1787951000000,
      "updated": 1787951000000,
      "deleted": 0,
      "name": "Jane Smith"
    }
  }
}

Details are provisioned asynchronously: status starts at pending and moves to active once ready. Listen for account_details.updated to know when to share the coordinates. See Account Details for the full identifier set once active (account number, sort code, IBAN, or wallet address, depending on currency).

Once status is active, share the returned banking coordinates or wallet address with your payer through your own product. The payer sends funds directly to those coordinates from their own bank or wallet; no further action is required on your side until funds arrive.

Step 3: Listen for the inflow

Nuvion credits the account and fires inflows.completed once the transfer settles.

{
  "event": "inflows.completed",
  "data": {
    "id": "01HXYZ7002ABCDEFGHJKMNPQRS",
    "amount": 10000,
    "currency": "GBP",
    "unique_reference": "01HXYZ7002ABCDEFGHJKMNPQRS-1787951000000",
    "counterparty_id": "01HXYZ7003ABCDEFGHJKMNPQRS",
    "account_id": "01HXYZ5678ABCDEFGHJKMNPQRS",
    "entity_id": "01HXYZ1234ABCDEFGHJKMNPQRS",
    "status": "successful",
    "status_reason": "Successful.",
    "narration": "Invoice payment received",
    "type": "inflow",
    "applicable_fee": 0,
    "meta": {},
    "created": 1787951500000,
    "updated": 1787951500000
  }
}

See Event types for the full payload schema.

Verify the transfer’s status with GET /transfers/{transfer_id} (using the webhook’s data.id) before treating the payment as received, rather than relying on the webhook payload alone. See Verifying webhook signatures to confirm the event itself is genuine.

What’s next

Account Details

Fiat and stablecoin identifier tables and the full account details object schema.

Account Details API reference

Full endpoint documentation for creating and managing account details.

Event types

Full payload schema for inflows.completed and every other webhook event.

Get Started

Core Concepts

Webhooks

Guides

Account Details

Step 1: Provision account details

Step 3: Listen for the inflow

What’s next

Account Details

Account Details API reference

Event types

​Step 1: Provision account details

​Step 2: Share the coordinates with your payer

​Step 3: Listen for the inflow

​What’s next

Account Details

Account Details API reference

Event types

Step 1: Provision account details

Step 2: Share the coordinates with your payer

Step 3: Listen for the inflow

What’s next