PayKassa for WooCommerce

Turn WooCommerce into a modern cryptocurrency checkout with PayKassa. PayKassa for WooCommerce lets customers pay with Bitcoin, Ethereum, USDT, USDC, TON, Litecoin, Dogecoin and other supported cryptocurrencies while your store can continue pricing orders in supported currencies such as USD, EUR, GBP or RUB. The plugin combines a customer-friendly hosted crypto checkout with a conservative payment-verification model: an order is marked paid only after PayKassa has verified the server-to-server notification. Browser redirects are never trusted as proof of payment. Why use PayKassa for WooCommerce?

• 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, terms and privacy information are available at PayKassa. This plugin is an independent integration and is not an official PayKassa product.

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.