# Introduction

QOOPay is a simple page that can be called from any website seeking to offer visitors the facility to pay for goods or services using their QOOP Wallet.

![](https://2160086753-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LeMHTEOsqEaNX51Zwlo%2F-LmPWun000Nh--HkJvrB%2F-LmPcMUxAEJyjCCwibCX%2Fpayexpress.JPG?alt=media\&token=1b28338a-b673-4b22-811d-cef84e9c1ed9)

### Recommendations

1. You must have the QOOP logo on your site to differentiate our payment services from the other ones you might have.
2. The customer must be aware of the total amount he/she will be debited before loading the payment page. Always inform the customer duly.
3. You must communicate user’s transaction reference numbers to them before they make payment so that they will have a reference value in case they have issues with their transactions. The recommended ways of communicating these details are Email, SMS or Display it boldly on the website and ask them to take note of it.
4. Confirm that the amount displayed on the payment page is the same amount that was displayed to the customer before redirecting to the payment page.
5. After a transaction had been processed, certain information needs to be displayed to the customer. They include the following:\
   a. The transaction status in a very friendly way. For example, *“Your transaction was not successful. Reason: Insufficient Funds”.* This is more descriptive. \
   b. The transaction reference number which you sent to QOOP for that transaction. \
   c. The payment reference which is generated and returned by QOOP.
6. There are various response codes that can be returned by QOOP along with their different descriptions. The objective here is to ensure that the customer gets the same description as sent by QOOP. The website should NEVER customize QOOP responses displayed to the customer.
7. After a transaction has been completed successfully, you should send a mail containing the transaction details to the customer.
8. You must have a table that logs ALL transaction attempts on your website (both Successful and Failed) as this would enable you to update transactions with responses received and ensure you can track pending transactions as well as provide customer service to your customers. Find below our recommendations on the fields that must be captured to provide optimum support: \
   a. Transaction Date and Time \
   b. Transaction Reference Number \
   c. Approved Amount \
   d. Response Description \
   e. Response Code \
   f. Transaction amount (what is to be approved. This could be optional) \
   g. Customer name and ID (Optional)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.qoop.ng/master.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.