PayKassa for WooCommerce

Accept cryptocurrency payments in WooCommerce with PayKassa — Bitcoin, USDT, USDC, Ethereum, TON and more. PayKassa for WooCommerce is a modern cryptocurrency payment gateway for WooCommerce that lets online stores accept Bitcoin, Ethereum, USDT, USDC, TON and other cryptocurrencies through PayKassa. Customers can pay with popular cryptocurrency and network combinations including USDT TRC20, USDT ERC20, USDT BEP20, USDC ERC20, USDC BEP20, Bitcoin, Ethereum and TON, while your WooCommerce store can continue pricing products in supported currencies such as USD, EUR, GBP and RUB. The plugin supports both classic WooCommerce checkout and WooCommerce Checkout Blocks, declares HPOS compatibility, supports fiat-to-crypto conversion and provides secure server-to-server PayKassa payment verification. Unlike integrations that trust a customer browser redirect, PayKassa for WooCommerce marks an order paid only after payment evidence has been verified with PayKassa and matched against the saved payment snapshot. Whether you need a WooCommerce USDT payment gateway, want to accept Bitcoin in WooCommerce, or need TRC20, ERC20, BEP20 or TON cryptocurrency payments, PayKassa for WooCommerce provides one integrated payment flow. Highlights

• Bitcoin payments for WooCommerce with provider-verified confirmation.
• USDT payments for WooCommerce on TRC20, ERC20, BEP20 and TON where supported.
• USDC payments on supported ERC20 and BEP20 networks.
• Ethereum, TON, Litecoin, Dogecoin and more through the built-in PayKassa payment registry.
• WooCommerce Checkout Blocks and classic checkout support.
• HPOS compatible using WooCommerce order APIs.
• Fiat-to-crypto checkout for supported WooCommerce currencies including USD, EUR, GBP and RUB.
• 24 cryptocurrency/network payment directions across supported PayKassa systems.
• Secure server-to-server payment verification before WooCommerce fulfils an order.
• Test Mode for controlled payment testing before going live.

WooCommerce cryptocurrency payment gateway features

• Accept major cryptocurrencies including BTC, ETH, USDT, USDC, LTC, DOGE, TON, TRX, XRP, BCH, DASH, XLM, BNB, ADA, EOS and SHIB.
• 24 exact cryptocurrency/network payment directions across 14 PayKassa payment systems and network variants.
• Stablecoin support on popular networks including USDT TRC20, USDT/USDC ERC20, USDT/USDC BEP20 and USDT on TON.
• Fiat-to-crypto checkout for supported WooCommerce order currencies including USD, EUR, GBP and RUB using a fresh PayKassa Currency API quote when the invoice is created.
• WooCommerce Checkout Blocks support for modern block-based checkout.
• HPOS compatibility for High-Performance Order Storage / custom order tables.
• Hosted PayKassa checkout so the customer completes the cryptocurrency payment through PayKassa.
• Provider-verified payment confirmation before WooCommerce calls payment_complete().
• Immutable payment snapshots preserve the exact order amount, payment amount, currency, network, conversion and merchant context used for the invoice.
• Exact decimal-string money checks instead of unsafe floating-point equality.
• Webhook idempotency protects orders from duplicate callback delivery.
• Credential rotation support keeps unfinished payment contexts verifiable after SCI credentials change.
• Test mode for PayKassa test payments.
• Site Health diagnostics, redacted order payment details and optional redacted debug logging.
• Custom success, pending and failure return pages with native WooCommerce behavior as the safe default.
• Separate callback and browser-return base URLs for reverse proxies, tunnels and multi-origin setups.
• Optional minimum payment rules for exact PayKassa cryptocurrency/network directions.
• Optional bounded payment recovery for merchants who configure PayKassa API credentials.

Sell in fiat, get paid in crypto Your WooCommerce catalog does not have to be priced in cryptocurrency. For supported order currencies such as USD, EUR, GBP and RUB, the plugin can request a PayKassa Currency API quote when the payment invoice is created and convert the saved WooCommerce order amount into the customer's selected cryptocurrency payment amount. The original WooCommerce order currency and total remain preserved. The converted payment amount, selected cryptocurrency, network and conversion data are stored in the payment snapshot used for later verification. Bitcoin, USDT, USDC, Ethereum and more The built-in PayKassa direction registry currently includes:

• Bitcoin (BTC)
• Ethereum (ETH)
• Litecoin (LTC)
• Dogecoin (DOGE)
• Dash (DASH)
• Bitcoin Cash (BCH)
• XRP
• TRON (TRX)
• Stellar (XLM)
• BNB Chain (BNB)
• USDT on TRON / TRC20
• USDT, USDC, ADA, EOS, BTC, ETH, DOGE and SHIB on BNB Smart Chain / BEP20
• USDT, USDC and SHIB on Ethereum / ERC20
• TON and USDT on TON

The merchant chooses exactly which cryptocurrency/network combinations are available at checkout. Built for modern WooCommerce PayKassa for WooCommerce supports both the classic checkout flow and WooCommerce Checkout Blocks. It declares compatibility with HPOS / custom order tables and uses WooCommerce CRUD APIs for order state and payment metadata. The gateway correlates PayKassa payments using the immutable internal WooCommerce order ID, so plugins that only change the displayed order number do not break provider matching. Payment verification designed for real money Crypto payment confirmation is treated as a security boundary. Incoming callback fields are not trusted by themselves. The plugin verifies the callback token with PayKassa server-to-server and then checks the verified payment evidence against the immutable invoice snapshot before settling the WooCommerce order. The payment pipeline includes:

• server-to-server PayKassa SCI verification;
• immutable order/payment snapshots;
• exact amount, currency and network checks;
• Live/Test environment matching;
• durable webhook transaction deduplication;
• database-backed settlement locking;
• retained SCI credential contexts for unfinished invoices;
• fail-closed handling of malformed provider responses.

The successful-payment and malfunction browser URLs are only for customer UX. They cannot independently mark an order paid. Merchant controls From WooCommerce payment settings you can configure:

• PayKassa Merchant / Shop ID and SCI secret;
• PayKassa Test Mode;
• accepted WooCommerce order currencies;
• enabled cryptocurrency/network payment directions;
• optional PayKassa API credentials for diagnostics/recovery;
• optional minimum payment rules per exact payment direction;
• external server callback base URL;
• external browser-return base URL;
• success, pending and failed/cancelled customer return pages;
• redacted debug logging;
• uninstall data cleanup.

The plugin also generates the PayKassa Merchant URLs that must be copied into the matching fields in the PayKassa merchant interface. External service This plugin connects to the third-party PayKassa payment service. A PayKassa merchant account is required. When a customer starts payment, the plugin sends the merchant ID, WooCommerce internal order ID, amount, selected payment currency/network and a short order comment to PayKassa. When PayKassa sends a payment notification, the plugin verifies the provider token server-to-server using the configured SCI credentials. The PayKassa Currency API is used when a supported order currency must be converted to the selected payment currency. Optional API credentials are used for merchant-initiated connection/history checks and optional payment recovery. PayKassa service information, merchant account access, documentation and integration resources are available at PayKassa. This plugin is an independent integration and is not an official PayKassa product.

Before configuring the plugin, you need a PayKassa account and a configured PayKassa merchant. 1. Prepare your PayKassa account

1. Create an account or sign in at PayKassa.
2. In your PayKassa account, create and configure a Merchant for the WooCommerce store where you want to accept cryptocurrency payments.
3. Keep the Merchant ID and Merchant Password / secret available. You will enter these credentials in the WooCommerce PayKassa gateway settings.
4. For full diagnostics and optional payment-recovery functionality, create PayKassa API credentials as well. In PayKassa, open API, choose Add API, configure the required environment and save it.
5. Keep your API ID and API Password private. Never expose PayKassa merchant or API credentials in public pages, screenshots, support requests or frontend JavaScript.

Basic payment acceptance uses the PayKassa merchant / SCI credentials. API credentials are used by optional diagnostics, connection checks, history access and payment-recovery functionality. Official PayKassa SCI/API documentation and integration information is available on the PayKassa Developers page. 2. Install PayKassa for WooCommerce

1. Install and activate WooCommerce.
2. Install and activate PayKassa for WooCommerce.
3. Go to WooCommerce > Settings > Payments > PayKassa.
4. Enable the PayKassa payment gateway.
5. Enter your PayKassa Merchant / Shop ID and Merchant secret.
6. If you created PayKassa API credentials, enter the API ID and API Password in the corresponding PayKassa settings.
7. Make sure Test Mode in WooCommerce matches the PayKassa environment you intend to use.

3. Configure currencies and cryptocurrency networks

1. Select the WooCommerce order currencies that PayKassa should accept.
2. Select the exact cryptocurrency/network payment directions you want customers to see at checkout.
3. You can enable combinations such as Bitcoin, Ethereum, USDT TRC20, USDT ERC20, USDT BEP20, USDC ERC20, USDC BEP20, TON and other supported directions.
4. Save the WooCommerce PayKassa settings.

4. Configure PayKassa Merchant URLs After saving the gateway settings, PayKassa for WooCommerce generates the Merchant URLs required for payment notifications and customer returns.

1. Copy the generated PayKassa Merchant URLs from the WooCommerce gateway settings.
2. Sign in to your account at PayKassa.
3. Open the corresponding Merchant settings.
4. Paste each generated URL into the matching PayKassa Merchant URL field.
5. Save the PayKassa Merchant configuration.

The server callback URL is security-sensitive because verified PayKassa payment notifications are used to confirm WooCommerce orders. The customer success or failure browser return URL alone never marks an order as paid. 5. Test the integration before going live

1. Enable Test Mode in the PayKassa WooCommerce gateway.
2. Make sure the corresponding PayKassa test environment and credentials are configured.
3. Create a controlled WooCommerce order.
4. Select PayKassa at checkout.
5. Choose a cryptocurrency/network payment direction.
6. Complete a PayKassa test payment.
7. Confirm that the WooCommerce order receives the expected payment status and PayKassa payment details.
8. Check Tools > Site Health and the PayKassa diagnostics if you want to verify the gateway configuration.
9. After testing successfully, configure your Live PayKassa credentials and disable Test Mode when you are ready to accept real cryptocurrency payments.

Your WooCommerce store is now ready to accept cryptocurrency payments through PayKassa.

2.0.1

• Added a PayKassa payment method icon on the WooCommerce checkout.
• Detect PayKassa's "IP not allowlisted" API rejection and show a diagnostics notice naming the blocked server IP, so merchants know exactly what to add to the PayKassa API IP whitelist.
• Added readable labels for payment recovery status values and translated remaining diagnostics page strings.
• Moved front-end assets to a Sass/TypeScript build pipeline; compiled admin CSS and block script are now generated from source instead of being hand-edited.
• Added an optional, development-only merchant connectivity probe (tools/) for verifying PayKassa API/SCI/webhook reachability without touching WordPress or live orders.
• Updated Russian translations.

2.0.0

• Complete modern rewrite for PHP 8.1+, WordPress 6.6+ and WooCommerce 8.5+.
• Added HPOS and Checkout Block integrations.
• Added immutable payment snapshots, provider-verified IPN processing, exact amount comparison and durable webhook idempotency storage.
• Preserved 1.x settings and the ?wc-api=wc_gateway_paykassa endpoint.
• Replaced unsafe legacy TLS and order access patterns.
• Added optional API health/reconciliation scheduling, diagnostics, Site Health checks and deterministic build tooling.

1.0.2 - 2020-07-20

• Update main SCI class.

1.0.1 - 2018-03-29

• Bugfix WC-API check response.
• Improved order processing.
• Minor changes.

1.0.0 - 2018-03-27

• First release.