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
<form action="https://pay.qoop.ng/payexpress" method="post" >
<input type="hidden" name="amount" value="2500.00" />
<input type="hidden" name="site_redirect_url" value="https://storeurl/wc-api/wc_plugin_qpay_Gateway/" />
<input type="hidden" name="txn_ref" value="5af4392212b9b" />
<input type="hidden" name="hash" value="d8f8f0d4d12350a4b52d9716" />
<input type="hidden" name="cust_name" value="Simon Kolawole" />
<input type="hidden" name="partner_id" value="hofstede" />
<input type="hidden" name="live_api_key" value="D2Q0KWkIE332Xx39FyB3bv" />
<input type="hidden" name="order_id" value="15665" />
</form>
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
{
"ResponseCode": "00",
"Amount": 20000,
"ResponseDescription": "Success"
}Other response codes are Other
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