PayLioDocs

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. 1

    Get the plugin ZIP

    Request the latest WooCommerce plugin from our team on Telegram.

  2. 2

    Upload it to WordPress

    Go to Plugins › Add New › Upload Plugin, choose the ZIP, then Install Now and Activate.

  3. 3

    Enable the gateway

    Open WooCommerce › Settings › Payments, enable PayLio and click Manage.

  4. 4

    Enter your credentials

    Fill in the settings below and save.

  5. 5

    Place a test order

    Use a small amount. The order switches to Processing automatically once the payment is confirmed.

Settings#

SettingDescription
PayLio API KeyRequired. Create one in Dashboard › API Keys.
Merchant ID or EmailYour account email or the Merchant ID shown in Settings.
Settlement USDC WalletYour Polygon wallet (0x…) that receives USDC.
Card Providermulti lets customers choose. Or set a single provider ID, see Providers.
Fee HandlingAbsorb the fee yourself, or add it to the customer's total.
Title / DescriptionWhat customers see at checkout.
Debug LoggingWrites API and webhook activity to WooCommerce › Status › Logs. Turn off in production.

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.

Webhooks are sent once

If your store is down or a firewall blocks the request, the order stays on Pending payment. Check the payment in your PayLio dashboard and complete the order manually. Allow POST requests from PayLio to the URL above in any security plugin or WAF.

Troubleshooting#

  • Gateway not shown at checkout: make sure it is enabled and the API key and wallet are filled in.
  • “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.