# POS INTEGRATION

<figure><img src="https://673841404-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBX9Dt5twx8iF8Eehr16a%2Fuploads%2FoMt2ilNHy5tEA7BmD0kK%2Fdefault-page-cover.a2ccd7e9.svg?alt=media&#x26;token=472f1e31-6902-45b3-88fb-0bac018747b8" alt=""><figcaption></figcaption></figure>

## POS Request

The PR API allows you to create and Re-query payment request.

{% hint style="success" %}
Get all your pos integration in one go..
{% endhint %}

#### The Request Object <a href="#the-address-object" id="the-address-object"></a>

This section describes the different attributes available during PR's.

| Name                | Type     | Description                                                                 |
| ------------------- | -------- | --------------------------------------------------------------------------- |
| reference           | string   | Unique reference for transaction provided by you / by KPAY if not provided. |
| accountNumber       | string   | Unique IBAN Identifier                                                      |
| metaData            | string   | Any custom information                                                      |
| paymentMethod       | string   | Payment channel used.                                                       |
| status              | string   | Final direction for the PR                                                  |
| paymentRequestRefId | string   | Unique ref from KPAY                                                        |
| transactionDate     | Date     | Date of Transaction                                                         |
| transactionTime     | TimeSpan | Time of Transaction                                                         |
| responseCode        | string   | API Request status from clients                                             |
| amount              | string   | Total amount for transaction in kobo                                        |

### Architectural Flowchart

<figure><img src="https://673841404-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBX9Dt5twx8iF8Eehr16a%2Fuploads%2FphWD9ZpXkovjUvNi7Wmp%2FScreenshot%202025-03-24%20at%2012.08.42.png?alt=media&#x26;token=d7841da5-fba8-44a3-99f6-e4c8d1c30168" alt=""><figcaption></figcaption></figure>