Intro

eCommerce Integration

Definition of Terms

• Integrator: Provider of POS systems.

Test Environment Base URL: https://gateway.dev.keepz.me/ecommerce-service

Real Environment Base URL: https://gateway.keepz.me/ecommerce-service

The Integrator has the capability to integrate the Keepz payments system into their own system. Keepz offers following method to achieve this:

1. The Integrator must create and register an order in the Keepz system.
2. After creating order integrator can generate QR which is unique per order or just use static QR provided by Keepz representative which is unique per beneficiary. (Integrator can use only one of these ways and it must be agreed in advance which way integrator is going to use to register properly in Keepz system).
3. After scanning one of the QRs user will view the order created by the Integrator, indicating the requested amount.
4. The user can either pay or cancel the order.
5. The final status will be communicated by the Keepz system to the Integrator system through the Callback URL. (Optional).
6. Additionally, the Integrator can check the status of a specific order.

All information exchange between the Integrator and the Keepz system occurs in a cryptographically encrypted format. In the initial phase, the Integrator is provided with a public key for encrypting information and a private key for decrypting received information.