Skip to main content
POST
Generate Dynamic Virtual Account
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

Request Body

Example Response

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