Skip to main content
POST
/
wallet
/
virtual-accounts
/
generate
/
dynamic
Generate Dynamic Virtual Account
curl --request POST \
  --url https://api.rolla.xyz/api/v1/external/wallet/virtual-accounts/generate/dynamic \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "amount": 500000
}
'
{
  "status": 201,
  "success": true,
  "message": "Dynamic virtual account generated successfully",
  "virtualAccount": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "status": "active",
    "virtual_account_type": "dynamic",
    "currency_type": "fiat",
    "bank_name": "VFD MFB",
    "account_number": "1234567890",
    "account_name": "Rolla / Your Business Name",
    "expires_at": "2023-11-07T05:31:56Z"
  }
}
Generate a dynamic (one-time) NGN virtual account for your business. If an active dynamic account already exists and hasn’t expired, it will be returned instead of creating a new one.

​
Example Request

curl -X POST "https://api.rolla.xyz/api/v1/external/wallet/virtual-accounts/generate/dynamic" \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "amount": 500000 }'

​
Request Body

ParameterTypeRequiredDescription
amountnumberNoExpected deposit amount in kobo. Recommended for amount-specific accounts.

​
Example Response

{
  "status": 201,
  "success": true,
  "message": "Dynamic virtual account generated successfully",
  "data": {
    "virtualAccount": {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "status": "active",
      "virtual_account_type": "dynamic",
      "currency_type": "fiat",
      "bank_name": "VFD MFB",
      "account_number": "1234567890",
      "account_name": "Rolla / Your Business Name",
      "expires_at": "2024-01-16T10:30:00.000Z"
    }
  }
}
Dynamic virtual accounts expire after a set period. Always check expires_at and generate a new one if the account has expired. Passing an amount pre-configures the account for that exact deposit.
Only NGN is currently supported for dynamic virtual account generation.

Authorizations

​
X-API-Key
string
header
required

Your Rolla API key

Body

application/json
​
amount
number

Expected deposit amount in kobo. Recommended for amount-specific accounts.

Example:

500000

Response

Dynamic virtual account generated successfully

​
status
integer
Example:

201

​
success
boolean
Example:

true

​
message
string
Example:

"Dynamic virtual account generated successfully"

​
virtualAccount
object