Virtual Account Creation
Last updated
Last updated
Create Virtual Accounts on demands, receive funds from customers via Virtual Account Number and get notification on Virtual Accounts usage.
Dedicated Virtual Accounts (DVAs) is a service that lets you create Nigerian virtual accounts for your customers. These accounts allow your customers to receive payment from their customers.
When you create a Dedicated Virtual Account (DVA) for a customer, all bank transfers to that account will automatically be recorded as transactions from that customer.
NGN
You can generate a VA and start receiving money in 3 easy steps:
Prepare payload (payload includes: first name, last name, BVN, and email)
Initiate VA creation (encrypting payload)
Get instant response
to the Postman collection
Find your keys on the Klasha Dashboard → Settings → Generate API Keys ()
Klasha Dashboard, Generate API Keys page
POST
{{env_url}}/wallet/virtual/v3/business/create/account
Encrypt the plain request body using the encryption algorithm specified above. Set the encrypted data to the message as shown below. You are required to set the x-auth-token and Authorization in the headers.
x-auth-token
Your merchant public key
Authorization
Bearer <token here>
Request Body (encrypted)
The result of the encryption of the payload that we specified has to be used with the Create virtual account endpoint as shown below:
firstName*
String
John
lastName*
String
Doe
bvn*
22222222222
email*
String
test@klasha.com
When a VA creation is initiated, processing could take a few seconds. These are sample responses you will get below:
GET
{{env_url}}
/wallet/virtual/v2/account/
{{email}}
In case of network downtime or failures during VA creation, the virtual account can be re-queried with the user’s email. This can be fetched using the Requery with email API on the Postman collection.
Authorization
Bearer <token here>
POST
{{env_url}}/nucleus/tnx/collection/status
To know the status of a transaction, you can fetch the transaction using the Transaction Status API on the Postman collection. Make use of the session id received from the bank. See an example below:
gateRef*
String
10043599483902847574821