Virtual Account Service makes receiving payments from your customer seamless.
Merchants will have to submit KYC upon registration to product@payvantage.com.ng which the Support team will review before getting the client-id and authorization key.
Request made without the authorization key will fail with a 401 (Service Not Authorize) response code.
Create Static Virtual Account
This allows you to create a virtual account for merchants/agents.
The merchant super-agent can create a virtual account with this endpoint.
Headers
Name
Type
Description
authorization*
String
secret-key
client-id*
String
Merchant Id
Content-Type*
String
application/json
Request Body
Name
Type
Description
address*
String
customer address
customer_identifier*
String
customer's unique identifier
dob*
Date
customer date of birth (dd/mm/yyyy)
email*
String
customer email address
first_name*
String
customer first name
last_name*
String
customer last name
mobile_num*
String
customer's moblie number
gender*
String
customer gender ("1" - MALE, "2" -FEMALE )
bvn*
String
customer's bvn
Create POS Terminal
This allows you to create terminals for different businesses. The terminal is location-based and each location has an Id that you must include.
Endpoint for merchant to create terminal
POST{{baseUrl}}/pip/softpos/create-terminal
Headers
Name
Type
Description
Content-Type*
String
application/json
authorization*
String
secret-key
client-id*
String
Merchant ID
Request Body
Name
Type
Description
name*
String
Name on terminal
email*
String
Email
phone*
String
Phone number on terminal
location_id*
String
The Id of the terminal location
merchantId*
String
The merchant Id
Initiate Payment Service
This is a service which can be use to recieve payment using card, ussd and transfer. In order to SignUp for this service, the client will provide a wehbook to recieve a payment notification as part of the onboarding process.
