Dynamic Virtual Accounts - Spotflow Documentation

Key Features

Feature	Description
Payment Routing	Automatically forward all incoming collections to your main account.
No Fund Storage	Dynamic virtual accounts do not hold or store money independently — it is immediately routed.
Simplified Setup	No lengthy verification (like BVN) is required during the creation process.
API-Driven	All Dynamic virtual account operations are performed seamlessly through API endpoints.
Expiry Time Limit	Dynamic virtual accounts have a default maximum expiry of 30 minutes, but you can set your own time limit via the API during creation.

Key Features

Dynamic virtual accounts are collection-focused, meaning they come with strict restrictions:

No Outgoing Payments: They cannot be used to process outbound transfers or payments (they’re strictly a one-way street).
No Terminal Support: They cannot be linked to payment terminals or POS devices.
Routing Only: Their function is exclusively as payment collection points.

API Operations

Action	Endpoint	Key Detail
Create Dynamic Virtual Account	Dynamic Virtual Account Creation API	Specify parameters (name, currency), returns a unique dynamic virtual account number. No BVN needed for creation.
Fetch Account Data	Fetch Dynamic Virtual Account by ID Endpoint	Retrieve individual dynamic virtual account information and access its status.
List All	List Dynamic Virtual Accounts Endpoint	Retrieve all dynamic virtual accounts (test or live). Supports filtering and provides efficient, paginated responses.

Webhook Notifications

You will receive webhook and email notifications when a dynamic virtual account is funded.

Action Item: Ensure you configure your system to receive these payment status updates. Set or update your Webhook URL on the merchant dashboard under Settings → API & Webhooks → URLs.