Integrations
WooCommerce
Add card payments with USDC settlement to a WordPress / WooCommerce store.
Requirements#
- WordPress 6.0+ and WooCommerce 8.0+
- PHP 7.4 or newer
- Your store must be served over HTTPS, because PayLio only delivers webhooks to https URLs.
- A PayLio account with an API key and a Polygon wallet.
Install the plugin#
- 1
Get the plugin ZIP
Download the latest version from the WooCommerce plugin page.
- 2
Upload it to WordPress
Go to Plugins › Add New › Upload Plugin, choose the ZIP, then Install Now and Activate.
- 3
Enable the gateway
Open WooCommerce › Settings › Payments, enable PayLio and click Manage. Paste your API key and click Test connection.
- 4
Enter your credentials
Fill in the settings below and save.
- 5
Place a test order
Use a small amount. The order switches to Processing automatically once the payment is confirmed.
Settings#
| Setting | Description |
|---|---|
| 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 | WooCommerce default, Processing or Completed. |
| 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 WooCommerce › Status › Logs. |
How orders are updated#
At checkout the plugin creates a PayLio payment and redirects the customer. When the payment completes, PayLio sends a signed webhook to /wc-api/paylio_webhook/ on your store. The plugin verifies the signature, double-checks the payment with the API and then marks the order as paid.
A missed webhook is caught
If your store is down or a firewall blocks the webhook, the plugin's scheduled status checks pick the payment up later. You can also open the order and choose Check PayLio payment status under Order actions. Allow POST requests from PayLio to the URL above in any security plugin or WAF.After paying, the customer is sent back to the WooCommerce order received page (after 5 seconds, or at once with the Back to button). That page shows the order's own status; arriving there never marks it paid.
Troubleshooting#
- Gateway not shown at checkout: it must be enabled with an API key, the store currency must be USD, EUR, CAD, INR or GBP, and the total must be at or above the selected provider's minimum.
- “Invalid API key”: the key was revoked or mistyped. Create a new one.
- Amount errors: the order total must be between 0.01 and 10,000 and above the provider minimum.
- Order not updated: enable Debug Logging and look for webhook entries. Then contact support.