Payments via PaySys.uz

Instructions for Payments via PaySys.uz

What the add-on does

The add-on adds the PaySys.uz payment processor to CS-Cart — PaySys.uz is a universal payment acceptance system in Uzbekistan. The customer places an order in the store, selects this payment method, and completes the payment on the PaySys.uz side.

The add-on works as an external redirect processor: it collects the order data, signs the request, and redirects the customer to the payment system payment page. The add-on code has no handler that receives notifications from PaySys.uz and changes the order status automatically after payment. Refunds, hold/capture, and fiscalization are not implemented in the add-on either.

Where to find the add-on

All settings are collected in the payment method card:

1. Open Administration → Payment methods.

2. Create a new payment method or open the existing PaySys.uz payment method.

3. Select PaySys.uz as the processor — in the processor list it is shown under the MakeShop.pro group.

4. Fill in the processor parameters and save the changes.

Access credentials

The payment method card contains the fields whose values you receive from PaySys.uz.

Merchant ID (Store ID, VENDOR_ID) — the main store identifier (merchant ID) in the payment system. The add-on sends it with every payment in the VENDOR_ID field. Without a correct Merchant ID the payment system cannot tell which store the payment belongs to, and the payment will not go through.

Client ID — this add-on has no separate Client ID field. The store is identified by a single identifier, the Merchant ID (called VENDOR_ID in the code), so no separate Client ID value is entered in the payment method card or used by the add-on. If PaySys.uz issued you a Client ID, it is used on the payment system side only, not for this payment method.

API token (API key) — the secret value used to sign the payment request. The add-on builds the SIGN_STRING signature as MD5 over the API token, Merchant ID, order number, amount, currency, and signature time. The payment system verifies this signature, so the API token must match the one issued in the settings exactly, and it should not be changed on a live store without need.

Test mode — switches the payment page URL: production https://agr.uz/pay or test https://agr.uz/sandbox. In test mode use the credentials issued by PaySys.uz for the sandbox.

Payment flow

1. The customer places an order and selects PaySys.uz as the payment method.

2. CS-Cart creates the order.

3. The add-on reads the order data and the payment method settings.

4. The add-on sends the Merchant ID (VENDOR_ID), order number, amount, currency sum, payment method name, customer return URL, signature time, and the SIGN_STRING signature to the payment system.

5. Before redirecting the customer, the order is moved to the Open status and the customer cart is cleared.

6. The customer goes to the PaySys.uz page and completes the payment there.

7. After payment the customer returns to the store order completion page.

Statuses, callback, and webhook

The add-on has no webhook/callback URL setting and no handler that receives a PaySys.uz notification and changes the order status on its own. The order is moved to the Open status before the customer goes to the payment page, and the order keeps that status after the customer returns to the store.

If payment reconciliation is required by PaySys.uz rules, it must be arranged on the store side: check the payment against the payment system data and move the order to the paid status manually.

Refunds, hold/capture, and cancellations

The add-on does not implement refund, cancellation, hold, capture, or void operations from the CS-Cart order page. If such operations are available, they are performed outside the add-on — in the PaySys.uz account or according to the payment provider procedures.

Receipts and fiscalization

The add-on has no dedicated settings for 54-FZ, DigitalKassa, fiscal receipts, or sending order item details to a fiscal service. Only the parameters required for the customer to go to the payment page are sent to the payment system — no receipt data.

How to check the result

1. Enable Test mode in the payment method card.

2. Enter the test Merchant ID and API token provided by PaySys.uz.

3. Create a test order on the storefront and select PaySys.uz payment.

4. Make sure the order is created in CS-Cart and gets the Open status.

5. Check that the customer goes to the test page https://agr.uz/sandbox.

6. After a successful check, disable test mode and replace the credentials with production ones.