Skip to main content

Key Features

FeatureDescription
Payment RoutingAutomatically forward all incoming collections to your main merchant account.
No Fund StorageDynamic accounts do not hold or store money independently—it’s immediately routed.
Simplified SetupNo lengthy verification (like BVN) is required during the creation process.
API-DrivenAll dynamic account operations are performed seamlessly through API endpoints.
Expiry Time LimitAccounts have a default maximum expiry of 30 minutes, but you can set your own time limit via the API during creation.

Key Features

Dynamic 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

ActionEndpointKey Detail
Create AccountDynamic Account Creation APISpecify parameters (name, currency), returns a unique dynamic account number. No BVN needed for creation.
Fetch DataFetch Dynamic Account by ID EndpointRetrieve individual account information and access its status.
List AllList Dynamic Accounts EndpointRetrieve all accounts (test or live). Supports filtering and provides efficient, paginated responses.

Webhook Notifications

You will receive webhook and email notifications when a dynamic 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.