Developer

Integrating Cuepay to your website or application can be achieved using the "Create Invoice" option for custom integration; the "Payment Button" option for easy integration and the "Plug-in" option for popular Content Management Systems like WordPress. When using the "Create Invoice" option, the status of each transaction must be queried - see the "Transdaction Status" tab.

Create an invoice for payment by submiting your parameters directly to our secure end point using an HTML Form.

The Form should be submitted to

https://cuepay.com/secure/?pay=invoice

HTML Form & Parameters

<form method="POST" action="https://cuepay.com/secure/?pay=invoice">

	<input type="hidden" name="merchant"  value="0000000">
	<input type="hidden" name="reference" value="">
	<input type="hidden" name="customer"  value="">
	<input type="hidden" name="narration" value="">
	<input type="hidden" name="redirect"  value="">

	<input type="text" name="amount" value="100" >

	<button type="submit">Pay</button>

</form>

Note: "reference", "customer", "narration" and "redirect" are optional parameters

To query a transaction, you would need the "reference" you provided for the transaction. This reference number is also submitted via the POST method to the "redirect" and "callback" URL after a transaction.

The callback URL is notified only on successful transactions; and the status of every transaction must be queried for security reasons.

This is the base URL to perform transaction queries:

https://cuepay.com/secure/query/

Parameters: Examples: PHP


These are the parameters required to query the status of a transaction. Submit using POST | GET.  The value, [ secret ] should be retrieved from your account settings in the application dashboard
--

1.   merchant   =  Merchant account ID ( See dashboard )

2.   reference   =  Transaction reference

3.   token          =  Sha512 [merchant][reference][secret]

4.   amount     =  Transaction amount ( optional )

--
Disclaimer - We strongly recommend comparing the transaction amount provided by Cuepay with what you have in your database to ensure that your own version of the amount has not been compromised. If you store the amount and would prefer this check is done for you, simply include the "amount" parameter in your request; and if the amount is different, we would respond with the code "F3" and "status" In-doubt.


Example:

If    :::::   [merchant] = 10000000, [reference ] = 83ac964a6ca349039088eefe05fb4538, [secret] = father, then [token] = Sha512 ['1000000083ac964a6ca349039088eefe05fb4538father']

https://cuepay.com/secure/query/?merchant=10000000&reference=83ac964a6ca349039088eefe05fb4538&token=5f450172d94243d1a05aed240b0ea9efc4c6a709361f390fb3cef290ae5565d8c20bc6dd0476cee0b83c5283f944961982953e8b47fac70901afad8e6bdc668e

Response:

{"status":"success","code":"00","amount":"50.25","total":"51.00","customer":"Guest","narration":"Payment","invoice":"10000000","reference":"a4d29a4385bc3dc4485108504cb7a7c0","data":null,"created":"2017-06-13 10:02:01","receipt":null}
--
Response Codes: 00 – Successful,  01 – Invoice,  02 – Pending,  F1 – Declined,  F2 – Cancelled,  F3 – In-doubt

Integrating the cuepay button into your website and application is pretty simple and requires a minimum of just 2 steps.

Step 1. Paste the code below just after </body>

<script src="https://cuepay.com/secure/button.min.js"></script>

Step 2. Paste the button code where required

<div class="cuepay-button" data-group="10" data-merchant="0000000" data-amount="" data-customer="guest">

	<input data-group="10" type="text" placeholder="0.00" min="100" max="500000" autofocus >
	<input data-group="10" type="button" value="Pay">

</div>

Woocommerce

This Payment Gateway modules allow you to integrate cuepay with the WHMCS platform.

Download here: https://github.com/cuepay/woocommerce

Gateway Module for WHMCS

This Payment Gateway modules allow you to integrate cuepay with the WHMCS platform.

Download here: https://github.com/cuepay/whmcs