This add-on is part of our Subscription plan.
Subscribe once — enjoy all add-ons without limits.
Add-on for CS-Cart that adds Yandex Pay and Yandex Split as payment methods, displays storefront widgets and badges, and sends the buyer's fiscal contact to Yandex when the payment link is created.
Purpose
- Enable Yandex Pay and Yandex Split in Payment methods.
- Display the payment widget on the product page (extended or compact) and on checkout.
- Show the «Yandex Pay» badge on the storefront.
- Map payment outcomes to order statuses (successful / unsuccessful) in addon settings.
- Send
fiscalContactin the order creation request: buyer e-mail first, otherwise phone number.
Main features
- Payment link creation for Yandex Pay / Split based on a CS-Cart order.
- Automatic fiscal contact transfer for an external fiscalization service.
- Merchant ID and order status mapping in addon settings.
- Flexible widget display: extended or compact on the product page, checkout placement, JSON-based widget configuration.
- Badge options: position, catalog visibility, additional badge display.
- Theme support: Responsive, UniTheme2, Nova.
How the add-on works
The customer places an order and chooses Yandex Pay / Split as the payment method. The add-on builds the /orders request, creates the payment link and redirects the customer to the payment page. If contact details are present in the order, the add-on sends them in fiscalContact for further fiscalization.
Location in admin
Add-on settings: Add-ons → Downloaded add-ons → Yandex Pay and Split.
Payment methods: Add-ons → Payment methods → Add payment method.
Configuration
- General: Merchant ID, order status mapping.
- Widget: widget display on the product page and checkout, widget type and JSON configuration.
- Badge: catalog visibility, position and additional display options.
Have questions about the add-on?
- Store Builder
- Store Builder Ultimate
- Multi-Vendor
- Multi-Vendor Plus
- Multi-Vendor Ultimate
- Buyers
- Owners
- Vendors
- English
- Русский
- 4.19.X
- 4.18.X
- 4.17.X
Screenshots below show the Russian admin interface; menu names may differ in your language.
1. Finding the addon
The Yandex Pay and Split addon is listed under Add-ons → Downloaded add-ons. Use the search box and type «yandex» to filter the list. The addon is by developer make shop; after installation its status is «On» (enabled).
2. Installation
Install the addon via Add-ons → Manage add-ons (upload package or update from repository). After installation, enable the addon and open its settings (gear icon next to the addon name or click the name).
3. Addon settings
3.1. General (tab «General»)
In the addon settings, open the General → General tab:
- Seller ID (Merchant ID) — enter your Merchant ID from the Yandex Pay dashboard (e.g.
5d69c8fa-894c-44c5-b9fa-...). - Order status mapping — set which order status to use for successful payment («Successful:» — e.g. «Completed») and for failed payment («Unsuccessful:» — e.g. «Cancelled»).
Click Save when done.
3.2. Widget (tab «Settings» → «Widget»)
On Settings → Widget you configure how the payment widget is shown:
- Widget display on product card: extended view, compact view, or «Do not display».
- Display payment method widget: choose «Yandex Pay and Yandex Split» or the option you need.
- Widget configuration — JSON with widget options (theme, border radius, size, etc.). You can build the config in Yandex's interactive demo and paste it here (link to the demo is below the field).
Click Save after changes.
3.3. Badge
Under Settings → Badge you set how the «Yandex Pay» badge appears on the storefront (position, visibility). Save after editing.
3.4. Fiscalization contact
When creating the payment link, the add-on automatically sends fiscalContact to Yandex if the order contains buyer contact data.
- If the buyer has an e-mail, the add-on sends the e-mail in
fiscalContact. - If the e-mail is empty, the add-on sends the phone number.
- If no contact data is filled in, the
fiscalContactfield is not added to the request.
For correct fiscalization, make sure the customer enters at least one contact on checkout: e-mail or phone number.
4. Adding a payment method
To let customers pay with Yandex Pay or Split, add a payment method:
- Go to Add-ons → Payment methods (or Administration → Payment methods, depending on your CS-Cart version).
- Click + Add payment method.
- Select processor MS: Yandex Pay (or the Yandex Pay / Split option shown in your list).
- Fill in the name, description; optionally limit storefronts and shipping methods.
- In the payment method parameters, enter the data provided by Yandex if required.
- Enable the payment method and save.
The list will show e.g. «MS: Yandex Pay» with an On/Off switch.
5. Verification
- Open a product page on the storefront — the Yandex Pay/Split widget should appear if enabled.
- Add a product to cart and go to checkout — select Yandex Pay as payment method and confirm the widget appears and payment works (use test mode first if available).
- If you use an external fiscalization service, verify that the
/ordersrequest containsfiscalContact: e-mail first, otherwise phone number.
6. Maintenance
- Updating: via Add-ons → Manage add-ons (when an update is available) or by installing a new version from the repository.
- Uninstall: in the addon list, disable and remove the addon. Before that, disable or remove related payment methods under Payment methods so orders are not left without a payment option.
Changelog
v1.6.0
30.04.2026
New features and improvements:
- The add-on now sends the customer contact for fiscalization when creating a payment.
Changes and improvements:
- If the order has no e-mail, the customer phone number is used for fiscalization.
- Updated the built-in add-on description.
Fixes and changes:
- Refined customer contact selection from order data.
v1.5.1
17.03.2026
Changes and improvements:
- Add-on settings are now detected more reliably on the storefront with multiple storefronts.
Fixes and changes:
- Fixed payment status mapping saving.
- Payment notifications now use the order company to choose add-on settings.
v1.5.0
04.03.2026
New features and improvements:
- Added a setting for widget display on the checkout page.
- Added checkout block display options: collapsed, expanded, or plain.
- Added a collapsible checkout widget block with a title and animation.
- Added badge display on pages, in blog posts, and in promotions.
Changes and improvements:
- Updated the add-on to the current project template.
- Moved checkout widget output to a separate block.
- Moved add-on documentation to the HTML format in the info section.
v1.4.0
19.01.2026
New features and improvements:
- Added label display in AB smart recommendation blocks.
Fixes and changes:
- Fixed payment method block behavior on checkout.
v1.3.1
12.12.2025
Fixes and changes:
- Fixed order creation from the admin panel.
v1.3.0
09.12.2025
New features and improvements:
- Added configurable widget and badge appearance.
- Added badge position selection.
Changes and improvements:
- Brought the add-on in line with project standards.
- Updated the widget appearance with an option to use the previous version.
- Added CS-Cart Nova theme support.
- Optimized widget display on checkout.
Fixes and changes:
- Fixed add-on settings display in the dark theme.
- Fixed badge alignment.
v1.2.2
10.11.2025
Changes and improvements:
- Updated widget styles.
- Switched the payment session to production mode.
Fixes and changes:
- Fixed duplicated widgets when product tabs contain products.
v1.2.1
03.11.2025
New features and improvements:
- Added an option to hide the widget on checkout.
Changes and improvements:
- Changed widget position and size on the product page.
- Removed an extra checkout button from the cart page.
- Changed the widget bottom spacing.
Fixes and changes:
- Fixed duplicated widgets in the popup.
- Fixed widget display when switching to a Yandex payment method.
- Fixed Split widget display when card payment through Yandex is selected.
v1.2.0
30.10.2025
New features and improvements:
- Added widget selection on the product page.
- Added widget display on checkout.
v1.1.1
30.07.2025
Changes and improvements:
- Brought the add-on in line with project standards.
v1.1.0
06.11.2023
New features and improvements:
- Added Yandex Split widget output.
v1.0.2
28.10.2023
Fixes and changes:
- Fixed production API key detection.
v1.0.1
28.10.2023
New features and improvements:
- Added English translations.
Fixes and changes:
- Fixed API URL detection.
v1.0.0
16.10.2023
New features and improvements:
- Initial add-on release.
Here you can share your opinion and evaluate our work.
Your feedback helps us become better and offer you even better service.