Hosted checkout
Customers pay on the PayLio checkout. No card data reaches your server.
PayLio for FOSSBilling
Card payments for FOSSBilling.
Add a card option to the FOSSBilling client area. Invoices are marked as paid after PayLio has confirmed the payment.
Version 1.0.1 · 38 KB · GPL-2.0-or-later
Requirements
- FOSSBilling 0.7.2 or newer
- PHP 8.2 or newer with cURL
- Site on HTTPS
- Invoices in USD, EUR, CAD, INR or GBP
- A PayLio API key and a Polygon wallet
Installation
Live in a few minutes
Settings: System › Payment gateways › PayLio
- 1Download the adapter ZIP from this page.
- 2Upload the library folder from the ZIP into your FOSSBilling root.
- 3Open System › Payment gateways › New payment gateway and install PayLio.
- 4Paste your API key, allow one time payments, set the accepted currencies, enable it and save.
- 5Reopen the gateway: the description shows the connection status.
What the plugin does
Built so every invoice is paid exactly once
Verified payments
Signed webhook plus a server-to-server status check of amount and currency before the invoice is marked paid.
Automatic recovery
Scheduled status checks catch a missed webhook, and you can re-check any invoice from the admin.
USDC payouts
Payouts arrive as USDC on Polygon. Choose who pays the processing fee.
Settings
The same settings on every platform
Every PayLio plugin uses the same settings, so switching platforms or running several shops stays simple.
API key and connection test
Paste the key from Dashboard › API Keys and check it with one click.
Payment provider
Let the customer choose from all providers, or fix one. Minimum amounts are shown in the list.
Processing fee
Include it in your price or add it to the customer's total.
Invoice handling
Status after payment, automatic cancellation of unpaid invoices where the platform supports it.
Checkout look
Title, description and payment icon, in English and German.
FOSSBilling FAQ
Which payment methods do customers get in FOSSBilling?
Customers pay by Visa or Mastercard, and with Apple Pay, Google Pay or local methods where the provider handling the payment supports them for the customer's country and amount. The PayLio checkout only shows the options that fit.
When is the invoice marked as paid?
Only after PayLio has confirmed the payment server-to-server. The plugin receives a signed webhook, asks the PayLio API for the payment status and checks amount and currency before it marks the invoice as paid. A lost webhook is caught by the plugin's scheduled status check.
What do I receive and when?
Your payout arrives as USDC on Polygon in the wallet from your PayLio dashboard, or in the payout wallet you set in the plugin. You can choose whether the processing fee is included in your price or added to the customer's total.
Does the customer come back to my shop after paying?
Yes. Once the payment is confirmed, the PayLio checkout shows a "Back to" button and returns the customer to the invoice page after a few seconds. That page checks the status itself, so arriving there never marks the invoice as paid.
Does card data touch my server?
No. The customer is redirected to the PayLio checkout and pays on the provider's page. Your shop only stores the PayLio payment id and status.
More integrations
PayLio works with the tools you already use
Also available for WHMCS, Paymenter and more, plus a REST API for custom backends.