Joys Digital Payments
This add-on is part of our Subscription plan.
Subscribe once — enjoy all add-ons without limits.
The add-on adds Joys Digital as a payment method in CS-Cart. Customers pay on the payment service side, while the store receives the payment result and updates the order in the admin panel.
It is useful for stores that need a separate payment gateway with POS terminal settings, RSA keys, order statuses, transaction status checks, and refunds.
What it is for
The add-on helps connect Joys Digital as a CS-Cart payment processor without modifying the CS-Cart core. The administrator configures the payment method once, and customers can select it during checkout.
Key features
- Adds the Joys Digital payment processor to CS-Cart payment methods.
- Lets the administrator enter the POS terminal ID and private RSA key.
- Shows the callback URL used by Joys Digital to send payment statuses.
- Shows the CSS file URL for styling the Joys Digital payment page.
- Lets the administrator select order statuses for successful payments, errors, and refunds.
- Creates a payment and redirects the customer to the Joys Digital payment page.
- Receives payment result notifications and updates the order.
- Saves the external transaction ID in the order payment information.
- Adds order actions for refreshing the transaction status and processing refunds.
- Can generate an RSA key pair directly in the payment method settings.
How it works
The administrator creates a Joys Digital payment method and enters the terminal data. RSA keys can be generated in the settings: the private key is stored in CS-Cart, and the public key should be added or sent to Joys Digital.
During checkout, the add-on sends Joys Digital the order amount, order number, and cart contents. If the payment service returns a payment URL, the customer is redirected to Joys Digital and completes the payment there.
After the payment, Joys Digital sends a notification to the store. The add-on checks the order, saves transaction data, and moves the order to the configured status. If the payment fails, the order receives the error status.
On the order page, the administrator can request the latest transaction status or process a refund when the payment has already been completed.
Have questions about the add-on?
- Русский
- 4.18.X
Instructions for Joys Digital Payments
What the add-on does
The add-on adds Joys Digital as a payment method in CS-Cart. It creates a payment for the order, redirects the customer to the payment page, receives the payment result notification, and saves transaction data in the order.
The add-on uses one-step payments. It does not provide hold/capture settings or a separate API token field: the connection uses the POS terminal ID and RSA keys.
Where to find the add-on
- Add-on page: Add-ons → Manage add-ons → Joys Digital Payments.
- Payment setup: Administration → Payment methods, then create or edit a payment method with the Joys Digital processor.
- Transaction actions: the order page in the admin panel.
What to prepare in Joys Digital
- Create or receive a POS terminal in the Joys Digital account.
- Find the POS terminal ID. You will need it for the POS terminal ID field.
- Add the store public RSA key to Joys Digital. You can generate it in the payment method settings.
- Copy the callback URL from the payment method settings and add it to Joys Digital as the payment status notification URL.
- If fiscalization is enabled in Joys Digital, configure it in the payment service account. The add-on sends order items in the payment request, but it does not add separate fiscalization settings in CS-Cart.
How to configure the payment method
- Open Administration → Payment methods.
- Create a new payment method or open an existing one.
- Select Joys Digital as the processor.
- Enter the POS terminal ID received from Joys Digital.
- Click Generate keys if you do not already have an RSA key pair.
- Copy the public key from the dialog and add it in the Joys Digital account.
- Make sure the private key appears in the Private key field. Do not publish it or share it with customers.
- Copy the POST request URL for payment status notifications and add it to Joys Digital notification settings.
- Check the CSS file URL for the payment page. You can use it in Joys Digital if the service allows an external payment page stylesheet.
- Select order statuses for successful payments, errors, and refunds.
- Save the payment method and make sure it is active for the required storefront and user groups.
How to check the result
- Place a test order on the storefront and select Joys Digital as the payment method.
- After order confirmation, the store should redirect the customer to the Joys Digital payment page.
- Complete the test payment on the Joys Digital side.
- Return to the admin panel and open the order.
- Check that the order received the status selected for successful payments.
- Check the order payment information: it should contain the Joys Digital transaction ID.
- If the status was not updated automatically, use the transaction status refresh action on the order page.
Refunds
If the order was paid successfully and the external transaction ID is saved, the order page shows an action for processing a refund. After a successful refund, the add-on changes the order to the status selected in the Refund order status setting.
Before testing refunds, make sure refunds are enabled and configured in Joys Digital for your terminal.
Troubleshooting
- The customer is not redirected to the payment page. Check the POS terminal ID, private key, and Joys Digital availability.
- Joys Digital reports a signature error. Compare the private key in CS-Cart with the public key in the Joys Digital account.
- The order status is not updated. Check the callback URL in Joys Digital and make sure the storefront is reachable from outside.
- The refund does not work. Check that the order has a Joys Digital transaction ID and that refunds are enabled for the terminal.
- Fiscalization is required. Check receipt and fiscalization settings on the Joys Digital side.
Changelog
v1.3.0
13.05.2026
Changes and improvements:
- The add-on has been refreshed according to the current presentation and quality rules.
- Full Russian and English description, instructions, and changelog have been added.
- The add-on name has been cleaned up, and outdated files have been removed.
v1.2.6
02.07.2021
Changes and improvements:
- Added a payment URL check before redirecting the customer.
- Improved handling when Joys Digital does not return a payment URL.
- Fixed key generation when several payment methods are configured.
- Added a notification when the store cannot send a request to Joys Digital.
v1.2.5
05.06.2021
Changes and improvements:
- Fixed signature generation for the transaction status request.
- Order payment information is saved before the customer is redirected to the payment page.
- Added an admin notification when a manual transaction status refresh changes the order status.
- Adjusted the condition for showing the transaction status refresh action on the order page.
- Restored logging for failed callback notifications from Joys Digital.
v1.2.3
18.05.2021
Changes and improvements:
- Improved the markup of the public RSA key dialog in payment method settings.
- Cleaned up the order page and processor settings templates.
v1.2.2
22.04.2021
Fixes:
- Fixed parameter order in the signed transaction status request URL.
v1.2.1
22.04.2021
New features and improvements:
- Added transaction status refresh from the order page.
- Added processing of Joys Digital responses when the payment status is refreshed manually.
- Payment information is saved when payment creation fails.
- Improved storage of the internal transaction identifier for later payment actions.
v1.1.6
06.04.2021
Fixes:
- Fixed generation of the store URL and payment page CSS URL according to the current storefront domain.
- The refund action is now shown only for paid orders with a saved external transaction ID.
v1.1.5
05.04.2021
New features and improvements:
- Added refund requests to Joys Digital.
- Refunds now use the settings of the exact payment method used for the order.
- Customer redirection to the payment page now uses the HTTP Location header.
- If the payment URL is not received, the order is moved to the error status.
- Fixed the CSS file URL display and the refund notification text.
v1.1.0
24.03.2021
New features and improvements:
- Added configurable order statuses for successful payments, payment errors, and refunds.
- Added RSA private key preparation before signing requests.
- The external Joys Digital transaction ID is now saved in order payment information.
- Added the first refund actions on the order page.
- Added language variables for statuses, refunds, and payment information.
v1.0.5
21.03.2021
New features and improvements:
- Expanded payment method settings: callback URL, store URL, CSS file URL, order statuses, and private RSA key.
- Added RSA key pair generation from payment method settings.
- Joys Digital callback notifications are now checked against the order payment script.
- Payment results are saved through standard CS-Cart routines: payment completion, payment information, and order status.
- Added readable Joys Digital API error messages by HTTP code.
- Removed the temporary test payment log file.
v1.0.2
02.03.2021
Changes and improvements:
- Payment creation was moved to the Joys Digital API with a JSON body and RSA signature.
- Order cart contents are now sent in the payment request: product name, price, and ID.
- Added a unique payment sequence based on the order number.
- Callback handling is limited to Joys Digital payment processor notifications.
- Removed unused controllers and hidden settings fields.
v1.0.1
07.08.2023
Service update:
- Added the standard Make Shop update center integration.
- Added service files for add-on license checks and configuration.
- Updated the add-on icon in the admin panel.
- Added a short legacy markdown changelog.
v1.0.0
02.03.2021
New features and improvements:
- Initial release.
- Added the Joys Digital payment processor for CS-Cart.
- Added POS terminal and RSA key settings.
- Added payment creation, customer redirection to the payment page, and payment result notification handling.
Here you can share your opinion and evaluate our work.
Your feedback helps us become better and offer you even better service.