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

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

{
  "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