Posting Transaction
Create an HTML form wherever you would like your ‘Pay’ button to appear and then set the form’s method to POST and the action attribute to https://pay.qoop.ng/payexpress
Create a submit button in the form and a few hidden fields through which you would assign transaction values you wish to post. See Fields and values for the required fields and a few optional ones.
Field
Description
Type
amount
Transaction amount E.g., 2500.00 for 2,500.00
float
site_redirect_url
URL of the page on your web site/portal user is to be redirected to after payment. Ensure you it has either http:// or https://
URL
txn_ref
Transaction Reference Number. This Reference Number must be generated by your web site/portal and a unique value must be sent for each transaction
string
hash
A Hashed value of selected combined parameters.
string
cust_name
Customer's fullname
partner_id
This is your username on the QOOP Dashboard
live_api_key
This key can be found in your QOOP Dashboard profile.
string
order_id
The unique ID for the order/transaction being sent. This must be visible to the customer on the merchant website
integer
Sample request
How to process the response
The following are the parameters returned by QOOP for real-time transactions. Note that QOOP will perform a GET
request to the site_redirect_url provided in the request to QOOP.
https://site_redirect_url/?
txnRef=5af4392212b9b
&PaymentReference=238477494594
&Amount=2500.00
&err=false
&ResponseCode=00
&ResponseDescription=Success
Param
Description
Type
txnRef
The transaction Reference initially generated & sent by the merchant site will be sent back with this variable.
string
PaymentReference
A reference number that uniquely identifies all transactions that go through the QOOP payment gateway.
string
Amount
Transaction amount E.g., 2500.00 for 2,500.00
float
err
Default: false. If the PayExpress experienced error, it will return true
boolean
ResponseCode
00 = payment successful
10 = payment failed: insufficient amount in wallet 11 = payment failed: other
string
ResponseDescription
success or fail
string
How to validate a transaction
Get Transaction
GET
https://pay.qoop.ng/gettransaction
This endpoint is to validate/get a transaction
Query Parameters
live_api_key
string
This key can be found in your QOOP Dashboard
order_id
string
Order ID initially used to generate transaction
Other response codes are:
Response Code
Response Description
02
More than one transaction with same Order ID #XXXX.
03
Transaction #XXXX does not exist.
04
Invalid API Key.
05
Missing API Key.
06
Order ID unknown.
Last updated