Integrations
All plugins
Free PayLio plugins for 8 shop and billing platforms. They all work the same way and share the same settings.
Platforms#
Each plugin page has the requirements, install steps and the download. The settings are in the place shown below.
| Platform | Settings | Marks paid |
|---|---|---|
| WooCommerce | WooCommerce › Settings › Payments › PayLio | Order |
| Easy Digital Downloads | Downloads › Settings › Payments › PayLio | Order |
| WHMCS | System Settings › Payment Gateways › PayLio | Invoice |
| FOSSBilling | System › Payment gateways › PayLio | Invoice |
| Paymenter | Admin › Gateways › PayLio | Invoice |
| OpenCart | Extensions › Extensions › Payments › PayLio | Order |
| PrestaShop | Modules › Module Manager › PayLio › Configure | Order |
| Magento 2 | Stores › Configuration › Sales › Payment Methods › PayLio | Order |
Settings#
Same names and order on every platform. Where a platform has no place for a setting, the plugin leaves it out.
| Setting | Description |
|---|---|
| Enabled | Shows PayLio at checkout. |
| Title / Description | What customers see at checkout. English and German defaults are included. |
| API key | Required. Create one in Dashboard › API Keys, then click Test connection. |
| Payout wallet (optional) | A Polygon wallet (0x…) for this shop. Empty uses the wallet from your PayLio dashboard. |
| Payment provider | All providers (the customer chooses) or one fixed provider. The list shows each provider's minimum, see Providers. |
| Processing fee | Included in your price, or added to the customer's total. |
| Order status after payment | Where the platform has order statuses. |
| Cancel unpaid orders after (hours) | 0 turns it off. PayLio is asked one last time before an order is cancelled. |
| Show payment icon / Custom icon URL | The card icon at checkout, or your own https image. |
| Advanced | API base URL (leave the default) and debug logging to the platform's log. |
When PayLio is hidden at checkout
The payment method only shows when it is enabled with an API key, the currency is USD, EUR, CAD, INR or GBP, and the total is between 0.01 and 10,000 and at least the minimum of the selected provider.How an order gets paid#
- At checkout the plugin creates a PayLio card payment and redirects the customer to the PayLio checkout. Card data never touches your shop.
- When the payment completes, PayLio sends a signed webhook to your shop. The plugin then asks the PayLio API for the status and checks amount and currency.
- Only then is the order or invoice marked paid, exactly once. If the order total changed in the meantime, it is put on hold with a note instead.
- A missed webhook (downtime, firewall, Cloudflare challenge) is caught by scheduled status checks where the platform has cron. Every plugin also has an admin action Check PayLio payment status.
Back to your shop#
After paying, the PayLio checkout shows Back to your-shop.com and returns the customer to your order confirmation or invoice after 5 seconds. The plugins set this up for you. The return page checks the status itself: arriving there never marks an order paid. Building your own integration? Send returnUrl when you create the payment.
Updating from an older plugin#
- Older WooCommerce and WHMCS modules (version 2) used your Merchant ID or email. The current plugins only need an API key: create one before you update and paste it into the settings.
- Deactivate and remove the old version, then install the new one. Orders and invoices that were already paid are not changed.
- Place a small test order after updating and check that it is marked paid.
Troubleshooting#
- “Invalid API key”: the key was revoked or mistyped. Create a new one.
- Order not updated: allow POST requests from PayLio to the plugin's webhook URL in your firewall or security plugin, then use Check PayLio payment status on the order.
- Still stuck: enable debug logging, then contact support with the payment ID.