Get Funding Instructions

Returns the deposit (funding) instructions for an account — how to fund each of its currencies. Each entry is either fiat bank transfer details (NGN, USD, …) or a crypto deposit address. Any USD account still being provisioned by the provider is surfaced under pending. A client can hold several USD accounts, one per reference — each appears as its own entry, carrying the reference and label it was issued with, so you can hand the right details to the right source. Both are null on the client’s primary account.

Deposit accounts are provisioned once an account’s application is approved. Issue them with Issue Bank Account; they then appear here. You can also receive an account.virtual_account.created webhook when one is added.

Example Request

curl -X GET "https://api.rolla.xyz/api/v1/external/accounts/eec3cbed-79d8-4370-87a0-b6be9e287337/funding-instructions" \
  -H "X-API-Key: your_api_key_here"

Example Response

{
  "success": true,
  "message": "Funding instructions retrieved successfully",
  "data": {
    "fundingInstructions": [
      {
        "currency": "NGN",
        "method": "bank_transfer",
        "status": "active",
        "provider": "rolla",
        "bankName": "Guaranty Trust Bank",
        "accountNumber": "1234567890",
        "accountName": "Beta Logistics LLC",
        "routingNumber": null,
        "swiftCode": null,
        "bankAddress": null,
        "reference": null,
        "label": null,
        "instructions": "Transfer NGN to the bank account below. Deposits are credited to the account's NGN wallet automatically."
      },
      {
        "currency": "USD",
        "method": "bank_transfer",
        "status": "active",
        "provider": "rolla",
        "bankName": "Lead Bank",
        "accountNumber": "8823410077",
        "accountName": "Beta Logistics LLC",
        "routingNumber": "021000021",
        "swiftCode": "LEADUS33",
        "bankAddress": null,
        "reference": "store-amazon-uk",
        "label": "Amazon UK",
        "instructions": "Transfer USD to the bank account below. Deposits are credited to the account's USD wallet automatically."
      },
      {
        "currency": "USDC",
        "method": "crypto",
        "status": "active",
        "provider": "rolla",
        "walletAddress": "0xAbC1234dEf5678901234567890aBcDeF12345678",
        "network": "base",
        "instructions": "Send USDC on the base network to the wallet address below. Deposits are credited to the account automatically after network confirmation."
      }
    ],
    "pending": [
      {
        "currency": "USD",
        "provider": "rolla",
        "state": "client_submitted",
        "message": "A USD deposit account is being provisioned. Funding details become available once the provider approves."
      }
    ]
  }
}

Query Parameters

Parameter	Type	Required	Description
`currency`	string	No	Scope to a single currency (e.g. `NGN`, `USD`, `USDC`). Omit to return every funded currency.

Overview

Banks

Account Lookup

Transactions

Wallet

Beneficiaries

Teams

Account Onboarding

Webhooks

Get Funding Instructions

Example Request

Example Response

Query Parameters

​Example Request

​Example Response

​Query Parameters

Example Request

Example Response

Query Parameters