Virtual Account Payment
Virtual Bank transfer
Initiate Dynamic Virtual Account Transaction
This API allows you to generate a Dynamic Virtual Account to be assigned to a customer. This is used to initiate a transaction.
Request Endpoint
Request Body
{
"bankCode": "035"
}
Response
Response Codes
200: Success
400: Bad Request
Response Body Example
{
"requestSuccessful": true,
"responseData": {
"bankName": "Pelpay | Chams ltd",
"bankCode": "035",
"bankAccount": "8388485453",
"paymentReference": "0866ac2d-dadc-40b0-a56f-a2eb7a1cc878",
"status": "Processing",
"message": "Processing",
"amount": 6000,
"amountPaid": 0,
"callBackUrl": "https://your_callback_url.com/?adviceReference=ffe1a559-5d9e-47fe-85t7-042316478040&paymentReference=0866ac2d-dadc-40b0-a56f-a2rt7a1cc869",
"customerName": "Chams Switch"
},
"message": "Successful",
"responseCode": "00"
}
Simulate Payment Endpoint
To Simulate payment, ensure you pass the bearer token retrieved from the authentication login endpoint as the Authorization header to authenticate and authorize the request.
Request Headers:
Authorization: Bearer {token}
This API allows you to push test transactions. Please note that this API is to be used only on the sandbox environment.
Endpoint:
Request Body:
{
"virtualAccountNumber": "8388485453",
"amount": "6000"
}
Response:
{
"requestSuccessful": true,
"responseData": {
"bankName": "Pelpay | Chams ltd",
"bankCode": "035",
"bankAccount": "8388485453",
"paymentReference": "c2ea27cbd3cf46f0af99395e0f25wtrs",
"status": "Successful",
"message": "Successful",
"amount": 6000.00,
"amountPaid": 6000,
"callBackUrl": "https://your_callback_url.com?adviceReference=fe7b2373-e3c8-488b-a45b-94511a3e2120&paymentReference=c2ea27cbd3cf46f0af99395e0f25caed",
"customerName": "Chams Switch"
},
"message": "Successful",
"responseCode": "00"
}
Last updated