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
Name | Type | Description |
---|---|---|
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