DocsSDKs & PluginsWordPress / WooCommerce
Saleonix for WooCommerce
A WooCommerce payment gateway plugin. Customers complete payment on the Saleonix-hosted checkout page — card data never touches your WordPress site, keeping your PCI compliance requirements minimal.
Requirements
| Requirement | Version |
|---|---|
| WordPress | 6.0+ |
| PHP | 7.4+ |
| WooCommerce | Any recent version (classic and block checkout supported) |
| Store currency | EUR — with any other currency the gateway hides itself from checkout |
| Order totals | €1.00 – €50,000 |
Installation
- Download the plugin (
saleonix.zip) or copy thesaleonix/folder intowp-content/plugins/. - Alternatively upload the zip via Plugins → Add New → Upload.
- Activate the plugin in your WordPress admin.
Configure the gateway
Go to WooCommerce → Settings → Payments → Saleonix:
- Enable the gateway.
- Paste your test secret key (
sk_test_...) under Test secret key and leave Test mode on while testing. - When you're ready to go live, paste your live secret key (
sk_live_...) and uncheck Test mode.
That's the whole setup — no product configuration is needed. At checkout the plugin creates a Saleonix session for the order total (including shipping, fees and discounts, via amount mode) and redirects the customer to the hosted payment page.
Where your keys live
How a checkout works
- The customer places an order and clicks Place order.
- They are redirected to the Saleonix-hosted payment page and enter their card details there.
- After payment they return to your store. The plugin verifies the payment server-side — and checks the paid amount matches the order total — before marking the order complete.
Always fulfill from order status
Payment outcomes → order states
| Payment outcome | WooCommerce order |
|---|---|
| Paid | Moves to processing / completed. |
| Customer returned without paying | Stays pending; the customer is offered the payment link again. |
| Payment declined | Marked failed. The customer can try again — a new payment session is started. |
| Session expired | Marked failed; the customer can start over. |
| Verification could not be completed | Placed on hold. The customer is told not to pay again until the store confirms the outcome. |
Customer paid but never returned?
If a customer completed payment but closed the browser before being redirected back, the order stays pending or on-hold. Open the order in the WordPress admin and run Order actions → Verify Saleonix payment — the plugin checks the payment status with the API and updates the order.
Testing
With test mode on, use these cards on the hosted payment page:
| Card | Result |
|---|---|
4242 4242 4242 4242 | Approved |
4343 4343 4343 4343 | Declined |
Developers can run the plugin's API-client test suite without a WordPress install:
Terminal
php test/smoke.phpCompatibility & structure
- Classic (shortcode) checkout and the WooCommerce block-based checkout.
- High-Performance Order Storage (HPOS / custom order tables).
- This release uses redirect checkout (the hosted page). An embedded in-page card form is planned — its settings already appear in the gateway configuration but have no effect yet.
Plugin structure
saleonix/
├── saleonix.php # plugin bootstrap and registration
├── includes/
│ ├── class-saleonix-api-client.php # Saleonix API client (server-side)
│ ├── class-wc-gateway-saleonix.php # WooCommerce payment gateway
│ └── class-saleonix-blocks-support.php # block checkout integration
└── assets/
└── blocks.js # payment method for block checkout