📘
If you have just arrived at our website, we recommend starting at the Welcome page.

Welcome to Payretailer's API Reference!

The API Reference section provides comprehensive information on utilizing our API, enabling you to begin processing your first transactions and payouts. Additionally, it includes valuable resources for troubleshooting and resolving any issues you may encounter.

If the documentation does not address your needs, please refer to the Discussion section to see if your question has already been asked and answered.
You can also reach out to the appropriate support team through our Help & Support page for further assistance.

API Conventions

🚧
BASE ENDPOINT
The base endpoint for our API is https://api-sandbox.payretailers.com/payments/v2
The Ocp-Apim-Subscription-Key must be included in the HTTP header for authentication with every API request.
For our Sandbox the key is: 1aa4e605bd5b405fba6061b55e52f4cd

The Subscription Key is merchant-specific and can only be utilized from the whitelisted IP addresses associated with that merchant.
Requests are encoded as JSON and sent as HTTP POST or GET requests to the appropriate endpoint.

For the system to process these requests, they must:

In the header, the shopId and secret key can be sent using HTTP Basic authentication or encoded in Base64.
Include the headers Content-Type: application/json and Accept: application/json
if it is a POST request.
Utilize SSL connection with 128-bit (or stronger) encryption.
Ensure the request is UTF-8 encoded.

API Flow Overview

Here’s an overview of a typical POST call to our API for generating a Payin/Payout: