KosTeams Payments for Yandex Pay and Yandex Split for WooCommerce
| 开发者 |
KosTeams
pro100kostia |
|---|---|
| 更新时间 | 2026年3月6日 05:21 |
| PHP版本: | 8.0.0 及以上 |
| WordPress版本: | 6.9 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
This plugin adds popular Yandex payment methods to your WooCommerce store:
- Yandex Pay: Instant card payment without entering card details.
- Yandex Split: Interest-free installments for up to 6 months.
- Combined payment: Pay part by card and the rest in installments.
- Full WooCommerce Block Editor support — the plugin works with both classic and block checkout
- Gutenberg compatible — integration with modern WordPress themes
- React components — modern architecture for fast performance For advanced features (installment badges, widgets in cart and catalog), the Pro version is available.
安装:
- Install the plugin through the WordPress admin panel.
- Activate it in the "Plugins" section.
- Go to WooCommerce → Settings → Payments → Yandex Pay and Yandex Split.
- Enter your Merchant ID and API key (obtained through a partner agreement with Yandex).
- Enable the desired payment methods and save changes.
- Important: Set up payment fiscalization in accordance with 54-FZ.
常见问题:
Why is the payment not going through?
Check whether your store has passed moderation in the Yandex Pay dashboard (it should show a green status). If the status is gray, payments will only work in test mode.
Is a contract with Yandex required?
Yes, the plugin requires a connection to Yandex Pay through a partner agreement.
Why is the payment method not displayed on the checkout page?
The payment method will only be displayed if it is enabled in WooCommerce settings and meets the conditions (e.g., currency, country, or shipping method). Check:
- Whether the method is enabled in WooCommerce → Settings → Payments.
- Whether the availability conditions are correctly configured.
- Whether there are conflicts with other plugins or the theme.
How does Split work for the buyer?
The buyer places an order, makes the first payment, and receives the product immediately. The remaining payments are charged on schedule. The store receives the full amount immediately, just like a regular purchase.
How do I add installment badges to product pages?
This feature is available in the Pro version, which allows you to customize the design, positioning, and display conditions of elements.
Why are widgets not displayed in the cart?
Cart and checkout integration is supported in the Pro version. The free version focuses on basic payment implementation.
How do I test in sandbox mode?
Use the test data provided by Yandex. Real money will not be charged.
How do I ensure payment fiscalization?
Yandex Pay does not send fiscal receipts automatically. Recommended solutions: Ready-made solution (recommended):
- KosTeams ATOL Receipts — a specialized plugin that automatically sends receipts for all Yandex Pay and Split payments Alternative options:
- Connect an online cash register (ATOL, Evotor, etc.) and set up API integration
- Use other fiscalization plugins
- Develop your own OFD integration
- Consult your cash register service provider
What are the penalties for not having fiscalization?
According to 54-FZ, fines for non-use of cash register equipment start from 10,000 rubles for individual entrepreneurs and from 30,000 rubles for legal entities per violation.
更新日志:
2.0.6 (2026-03-05)
Fiscalization
- Cloud cash register support for Yandex Pay:
receiptdata transmission (VAT, payment method type, payment subject type, unit of measurement) - Auto-detection of VAT rate from WooCommerce or forced "No VAT" mode
-
Filter
kosteams_payments_for_yandex_item_receiptfor customization Wallet plugin compatibility -
Negative fees (wallet, certificates) are skipped, item
totalvalues are proportionally recalculated - Removed
externalAmount— works without special API permissions - Full compatibility with TeraWallet, WooCommerce Wallet, and others Bug fixes
-
JWT webhook: uses the full JWKS key set (
JWK::parseKeySet) instead of just the last key - Refund: targetCart includes VAT, correct orderId for CARD_SPLIT
- Fixed PHP Notice for
$existing_payment_urlon 409 error - Webhook registered once (static flag)
- API logging info only when debug_mode is enabled, errors are always logged Improvements
- API key is hidden (type=password)
- Removed Yandex Pay SDK loading from the base plugin (handled by Pro)
- Removed unused: class-validator.php, duplicate
get_order_info(), duplicate validation increate_payment() - CSS version tied to plugin version
- i18n for refund order notes
- Synchronized YPS_KOSTEAMS_VERSION constant with plugin header
- Code audit for compliance with WooCommerce Payment Gateway API documentation
- Code audit for compliance with Yandex Pay Web SDK documentation
- Updated plugin page links
- Updated firebase/php-jwt library to v6.11.1
- With VAT enabled in WooCommerce, amount mismatch occurred:
- Order total in WooCommerce (with VAT): e.g., 1200 RUB
- Amount sent to Yandex Pay API (without VAT): e.g., 1000 RUB
- Result: ERROR — payment was not created due to amount mismatch CAUSE:
-
$item->get_total()returns the amount WITHOUT taxes $order->get_total()returns the amount WITH taxes-
When calculating
calculated_total, taxes were not included, causing a mismatch withwoocommerce_totalFIXED inincludes/class-gateway.php: - Products (line 794):
- WAS:
$line_total = round((float)$item->get_total(), 2); - NOW:
$line_total = round((float)$item->get_total() + (float)$item->get_total_tax(), 2); - Shipping (line 820):
- WAS:
$shipping_cost = round((float)$shipping_item->get_total(), 2); - NOW:
$shipping_cost = round((float)$shipping_item->get_total() + (float)$shipping_item->get_total_tax(), 2); - Fees (line 836):
- WAS:
$fee_amount = round((float)$fee_item->get_total(), 2); - NOW:
$fee_amount = round((float)$fee_item->get_total() + (float)$fee_item->get_total_tax(), 2);
- Full amount WITH VAT is now sent to Yandex Pay API
- WooCommerce order total = Yandex Pay total (100% match)
- No discrepancies between the dashboard and the payment system
- Customer pays the correct amount shown in the cart IMPORTANT: This is a critical fix for all stores using taxes/VAT in WooCommerce. Immediate update is recommended.
- Completely rewritten data calculation logic for Yandex API
- Fixed amount mismatch between WooCommerce and data sent to Yandex
- Now uses native WooCommerce methods to get item totals Fixed:
- ISSUE: Plugin manually calculated and distributed discounts across all items proportionally, leading to incorrect distribution (coupons applied to all items even when configured for specific items only)
- FIXED: Now uses
$item->get_total()— WooCommerce correctly calculates the final amount including all discounts - ISSUE: Items with quantity > 1 were split into separate line items with quantity = 1, causing rounding issues
- FIXED: Items are now sent with their actual quantity
- ISSUE: When totals didn't match, the last item was adjusted, masking logic errors
- FIXED: No more adjustments, amounts match exactly
- ISSUE: Unnecessary fields (
unitPrice,discountedUnitPrice,subtotal) were sent, which are not needed for Yandex Split -
FIXED: Only
totalwith the exact final amount is sent Result: - Yandex data = WooCommerce data (100% match)
- Code reduced from ~270 lines to ~70 lines (4x simplification)
- No manual calculations or adjustments
- All discounts (coupons, promo codes, loyalty programs) applied correctly Technical:
-
Simplified
cart.items[]data structure: - Required fields:
productId,title,quantity.count,total - Optional fields:
description - Removed:
unitPrice,discountedUnitPrice,subtotal(not required by API) - Removed bonus discount calculation block (lines 782-817)
- Removed discount distribution logic (lines 826-877)
- Removed item splitting logic (lines 898-937)
- Removed last item adjustment (lines 1023-1051)
- Product descriptions are now stripped of HTML tags before being sent to external systems
- Fixed critical block initialization error in WP Cron context
- Fixed "Call to a member function get_cart_contents() on null" error during cron tasks
- Fixed "Call to a member function get_available_payment_gateways() on null" error
- Added lazy loading for payment gateways in block editor
- Improved compatibility with plugins that filter available payment methods TECHNICAL
- Implemented protection against premature WooCommerce object initialization
- Changed gateway retrieval method: uses
payment_gateways()instead ofget_available_payment_gateways() - Added existence checks for
WC()andWC()->payment_gatewaysobjects before access initialize()method no longer triggers WooCommerce filters during initial load
- Full WooCommerce Block Editor support
- Compatibility with modern WordPress themes (Gutenberg blocks)
- Automatic registration of Yandex Pay and Yandex Split in block cart and checkout
- Payment method icons and descriptions in the block interface
- Modern architecture with React component support
- Build process for JavaScript files (webpack, babel)
- Plugin fully restructured: now works equally stable with both classic and block checkout
- Added refund support via Yandex API
- Eliminated last meta_key query warning
- Replaced all meta_key queries with global delete_metadata() function
- Maximum efficiency for metadata deletion during uninstall PERFORMANCE OPTIMIZATION
- Eliminated slow meta_query warning
- Using fields => 'ids' to retrieve only order IDs
- Direct metadata deletion via delete_post_meta() RESULT
- Significantly improved performance during plugin uninstall
- Plugin fully ready for WordPress.org, all Plugin Check tests passed
- Unified payment service names throughout the plugin
- All variations standardized to consistent naming RESULT
- Uniform naming conventions
- Improved user experience
- Optimized plugin size
- Fixed refund amount availability check logic
- Support for resending existing refunds to Yandex API
- Eliminated WooCommerce refund duplication on API errors
- Added detailed logging for refund amounts and statuses
- Replaced HTML tags with plain text in error messages
- Clear instructions when settings are missing (Merchant ID, API key)
- Merchant ID format validation (UUID) with informative messages
- Date: 2025-08-23
- Minor improvements
- Date: 2025-08-03
- CRITICAL FIX: Fixed ORDER_AMOUNT_MISMATCH error when creating payments
- Fixed: Amount calculation accuracy with discounts and rounding
- Fixed: Discount distribution inaccuracies across items
- Improved: Correction algorithm for totals to meet Yandex API requirements
- Improved: Mathematical precision for monetary calculations
- Added: Automatic rounding error correction in the last cart item
- Added: Additional logging for debugging amount calculations
- Technical: WordPress Coding Standards compliance for internationalization
- Technical: Added translator comments for all localizable strings
- Technical: Ordered placeholders in translatable strings (%1$s, %2$s)
cart_total = items_sum - discounts_sum
- Added precise rounding at all calculation stages (round with 2 decimal places)
- Implemented calculated_total vs woocommerce_total verification
- Automatic correction of last item when discrepancy >= 0.01
- Improved distribution of remaining discounts across items
- Added final validation of all amounts before sending to API
- All monetary operations now use
round($value, 2) - Added check
abs($calculated_total - $woocommerce_total) >= 0.01 - Implemented correction via last cart item adjustment
- Improved logging with output of all intermediate sums for debugging
- Brought up to WordPress standards for proper localization
- Date: 2025-07-20
- Added: Protection against status changes for orders paid via other payment systems
- Added: Intelligent webhook processing considering the payment method
- Improved: Order status processing logic to prevent conflicts between payment systems
- Improved: Handling of legitimate cancel/refund operations for Yandex orders
- Fixed: Issue with cancellation of paid orders when receiving Yandex webhook after payment via another method
- If an order was paid via another payment system, Yandex webhooks will no longer change its status
- Orders paid via Yandex correctly handle cancel and refund operations from the Yandex dashboard
- Informative notes added to orders when status change attempts occur
process_order_status_from_webhookmethod now checks the order payment method before applying changes- Added
$is_yandex_paymentcheck to determine the payment source - Improved logging to track all status change attempts
- Date: 2025-06-17
- Added: Extended Yandex Pay webhook processing
- Added: Flexible payment status mapping system
- Added: Custom filters for developers
- Improved: Webhook processing refactoring for increased reliability
- Improved: Payment operation logging
- Improved: Security of incoming request processing
-
kosteams_payments_for_yandex_webhook_status_mapModifies the Yandex → WooCommerce status mapping Parameters: - $status_map (array) - Current status mapping
- $order (WC_Order) - Order object
- $payment_status (string) - Status from Yandex Example: add_filter('kosteams_payments_for_yandex_webhook_status_map', function($status_map, $order, $payment_status) { $status_map['CAPTURED'] = 'completed'; return $status_map; }, 10, 3);
-
kosteams_payments_for_yandex_before_process_statusModifies the status before applying it to the order Parameters: - $new_status (string) - Planned status
- $payment_status (string) - Status from Yandex
- $order (WC_Order) - Order object
-
kosteams_payments_for_yandex_handle_webhook_statusFull custom status handling (returning true cancels default processing) Parameters: - $handled (bool) - Processing flag
- $payment_status (string) - Status from Yandex
- $order (WC_Order) - Order object
-
kosteams_payments_for_yandex_status_change_noteModifies the note when order status changes Parameters: - $note (string) - Note text
- $order (WC_Order) - Order object
- $old_status (string) - Old status
- $new_status (string) - New status
-
kosteams_payments_for_yandex_partial_refund_noteModifies the note for partial refunds Parameters: - $note (string) - Note text
- $order (WC_Order) - Order object
- Strengthened incoming data validation
- Improved error decoding handling
- Issues with PARTIALLY_REFUNDED status processing
- Dynamic icon switching in the Yandex Split payment gateway depending on the selected payment method
- When selecting "Split", the standard Split icon is displayed
- When selecting "Card + Split", the combined icon is displayed
- All discount types (coupons, bonuses, negative fees) are combined into a total discount amount
- Discounts are distributed proportionally across items
- Remaining discount is added to the last item for precise distribution
- Items with quantity > 1 are created as separate line items
- Discounts are evenly distributed between units of an item
- Discounts are applied only to products (not to shipping and fees)
- Style separation implemented
- Minor fixes
- Improved documentation
- Added separate payment gateways:
Yandex Split— installment paymentsYandex Pay— classic card payment- Shared logic extracted to base class (
WC_Yandex_Base_Gateway) - Improved payment URL storage:
- Payment URLs are saved to order metadata
- Duplicate payment creation prevented for existing orders
- Fixed compatibility with WooCommerce 8.7
- Updated test scenarios for PHP 8.3
- Added multilingual site support
- Optimized script loading
- Initial release
- Basic Yandex Pay/Split integration
- Classic editor support