S2S Virtual account (NGN)
This feature is a white labeled solution that helps merchants get all the necessary details for a virtual account transaction and get notified once payments are received.
Initiate S2S
Content-Type
Set value to application/json
Query Params
Set Key to provider
Set Value to providus
or baines
Post a request to the URL below, where the base URL is determined by the environment you are in.
POST {{baseurl}}/transaction/initialize-s2s
Here's a sample request below
{
"amount": 300000,
"currency": "NGN",
"email": "test-pms@customer.com"
}
Here's a sample response
{
"success": true,
"message": "VA initiated",
"data": {
"accountNumber": 8200244923,
"reference": "7d19bfxxxxxx",
"expiryTime": "2024-01-30T13:08:11.179Z",
"bankName": "BAINES CREDIT MICROFINACE BANK",
"accountName": "Checkout Earth/SB"
}
Mock transfer
To simulate a transfer being made by your customer on our sandbox environment; use the request body below.
POST {{baseurl}}/transaction/mock-va-collection
Here's a sample request below
{
"amount": 300000,
"accountNumber": "8200244923",
"reference": "7d19bfxxxxxx"
}
Here's a sample response below
{
"success": true,
"message": "success",
"data": "Transaction verified successfully"
}
Once payment has been made a webhook is sent and merchants can get the transaction status at anytime.
Last updated