Instructions for Payments via PaySys.uz

What the add-on does

The add-on adds a PaySys.uz payment processor to CS-Cart. The customer places an order, selects the PaySys.uz payment method, and is redirected to the PaySys.uz page to complete the payment.

The add-on works as an external redirect processor: it builds a request to the PaySys.uz payment page, signs it with the API key, and sends the order parameters. The add-on code does not include a dedicated callback/webhook handler for automatic payment confirmation, refunds, hold/capture operations, or fiscalization.

Where to find the add-on

The main setup is performed in the payment method:

1. Open Administration → Payment methods.

2. Create or open a 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.

Payment method parameters

Store ID is the VENDOR_ID issued by PaySys.uz for the store. The add-on sends this value to the payment system when creating the payment.

API key is used to build the request signature. The signature is generated from the API key, store ID, order number, amount, currency, and signature time.

Test mode switches the payment request URL: production https://agr.uz/pay or test https://agr.uz/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 payment method settings.

4. The add-on sends the store ID, order number, amount, currency sum, payment method name, return URL, signature time, and MD5 request signature to PaySys.uz.

5. Before redirecting the customer, the add-on changes the order status to Open.

6. The customer is redirected to PaySys.uz and completes the payment there.

7. After the external payment scenario, the customer returns to the order completion page in the store.

Statuses, callback, and webhook

The add-on has no separate webhook/callback URL setting and no handler that receives a PaySys.uz notification to automatically change the CS-Cart order status after successful payment.

The order is changed to the Open status before the customer is redirected to PaySys.uz. If the PaySys.uz process requires payment reconciliation, it should be handled according to the payment system rules and the store’s internal procedures.

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 on the PaySys.uz side or according to the payment provider’s procedures.

Receipts and fiscalization

The add-on code has no dedicated settings for 54-FZ, DigitalKassa, fiscal receipts, or sending order item details to a fiscal service. The add-on sends only the payment parameters required to redirect the customer.

How to check the setup

1. Enable test mode in the payment method.

2. Enter the test VENDOR_ID and API key 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 receives the Open status.

5. Check that the customer is redirected to https://agr.uz/sandbox.

6. After testing, disable test mode and replace the credentials with production ones.