Virtual Account
Virtual accounts are generated nigerian account details (account number and bank) that allow Poggah merchants to receive payments from customers via bank transfer.
POST {{BASE_URL}} /v1/account/create-virtual-account
Parameters
RequestReference
string
A unique reference for this specific API call.
True
RequestType
string
This will be either Live (for real Transaction) or Sandbox (for testing purpose)
True
Amount
decimal
The amount the customer is required to pay.
True
NameOnAccount
string
Name
True
FirstName
string
Customer first name
True
LastName
string
Customer last name
True
string
Customer email address
True
Reference
string
Unique Customer Identifier (this will be used for getting customers details)
True
PhoneNumber
string
Customers phone number
True
Bvn
string
Customers BVN
True
Request
{
'Authorization': 'Bearer dcf9e6f376c422d3ca925457b7927793a6d1713034426ccf2c07ae956e39',
'Content-Type': 'application/json',
}{
"RequestReference": "REQ-1267654490",
"RequestType": "Live",
"Data": {
"Amount": 0,
"Customer": {
"FirstName": "Joseph",
"LastName": "Ebenezer",
"Email": "[email protected]",
"Reference": "54c4fbb9-fc3f-4209-b7ad-128293f55431",
"PhoneNumber": "+2349032348559",
"Bvn": "3234570175"
}
}
}{
"status": "Successful",
"message": "Virtual accounts created successfully",
"data": {
"reference": "PGC-098789091189",
"date": "2025-01-02",
"amount": 0,
"customer": {
"firstName": "Joseph",
"lastName": "Ebenezer",
"email": "[email protected]",
"reference": "PGC-095101323489",
"phoneNumber": "+2349032390515"
},
"account": [
{
"bankName": "Poggah Gatway",
"accountNumber": "4564321781",
"accountName": "Joseph Ebenezer",
"bankCode": "000"
}
]
}
}Last updated