👨‍🔬Create Account

Reserve a virtual account

POST https://api.billstack.co/v2/thirdparty/generateVirtualAccount/

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Body

Name	Type	Description
reference	string	Reference for the reserved account
email	string	Customer Email
phone	string	Customer Phone
firstName	string	Customer First Name
lastName	string	Customer Last Name
bank	9PSB, SAFEHAVEN, PROVIDUS, BANKLY or PALMPAY	supply the bank you want to generate. (NOTE) You can only generate a single bank at a time. 9PSB to generate 9PSB Bank. SAFEHAVEN to generate Safehaven MFB Bank. PROVIDUS to generate Providus Bank. BANKLY to generate Bankly (Ampersand) Bank. PALMPAY to generate Palmpay Bank.

Payload

//Payload Sample

{
 "email":"[e-mail]",
 "reference":"sna1234",
 "firstName":"SNA",
 "lastName":"SNA",
 "phone":"09012345678",
 "bank":"PALMPAY"
 }

Response

200

{
   "status":true,
   "message":"Account reserved",
   "data":{
      "reference":"R-XXXXXXXXXXX",
      "account":[
         {
            "account_number":"0000000000",
            "account_name":"Alias-Ahmad Naziru",
            "bank_name":"9PSB Bank",
            "bank_id":"9PSB",
            "created_at":"2024-04-02 05:47:42"
         }
      ],
      "meta":{
         "firstName":"Ahmad",
         "lastName":"Naziru",
         "email":"[e-mail]"
      }
   }
}

400

{
   "status":false,
   "message":"Cannot reserve account at the moment."
}