Skip to main content
POST
Generate Static Virtual Account
Generate a permanent static NGN virtual account for your business. Unlike dynamic accounts, static accounts don’t expire and are intended for regular incoming payments.

Example Request

Request Body

No request body required.

Example Response

Only one static virtual account can exist per business on a given provider. If one already exists the call returns 400 with a message naming the provider, for example "NOMBA virtual account already exists for this business". Use the List Virtual Accounts endpoint to check first.
Your business KYB must be approved before a static virtual account can be generated: an unapproved business gets 400 "KYB application is not yet approved or still pending review". Account details are automatically derived from your KYB application.

Authorizations

X-API-Key
string
header
required

Your Rolla API key

Response

Static virtual account generated successfully

status
integer
required
Example:

201

message
string
required
Example:

"Static virtual account generated successfully"

success
boolean
required
Example:

true

data
object
required