Description
Payment Matcher for Fio Bank downloads incoming payments from your Fio banka account every 15 minutes and matches them to WooCommerce orders by variable symbol (order number). When the amount is right, the order moves to Processing and the customer receives the usual WooCommerce e-mail.
What it does
- Automatic matching by variable symbol – also finds the order number in the message for recipient and ignores leading zeros. Works with sequential order number plugins.
- Live status on the thank-you page – “Waiting for your bank transfer” switches to “Payment received” by itself, usually within a minute.
- Refunds – an outgoing payment with the order’s variable symbol is recorded on the order, only when money for that order actually arrived.
- Underpayments and overpayments – partial payments add up; you get an e-mail for anything that needs attention.
- Observing mode – start safely: the plugin only lists what it would do, changes nothing.
- Manual assignment – assign any payment to an order with one click, with a suggestion when the variable symbol is missing (same amount and sender name).
- Restore and mark paid – when money arrives for an order that was already cancelled.
- Payment box in the order – all payments for the order and how long it has been waiting.
- Server cron address – a secret URL your hosting’s cron can open every 15 minutes, so checks run even when WP-Cron does not. Plus
wp pmfio checkfor WP-CLI. - Token health alerts – an e-mail and an admin notice when the Fio token expires or checks stop running.
- Daily summary e-mail at 7:00.
- Payment reminder – a standard WooCommerce e-mail sent to the customer after a set number of days without payment.
- Token expiry reminder – set the token’s expiry date and get an e-mail and an admin notice 14 days before.
- Personal data – privacy policy text, WordPress personal data export and erasure, automatic deletion of old payments (12 months by default).
- Multiple Fio accounts – connect e.g. a CZK and a EUR account, each with its own read-only token. Payments from all of them are matched together, each with its own expiry reminder.
- QR payment – optional QR code on the thank-you page and in order e-mails: QR Platba for CZK orders (Czech banks), PAY by square for EUR orders (Slovak banks). The account in the order’s currency is used automatically. Generated on your server, no external service.
- Translation-ready – Czech and Slovak translations are provided through translate.wordpress.org.
Requirements
- A Fio banka account and a read-only API token (Fio internet banking Settings API Add token, type “Account monitoring”).
- WooCommerce 8.0+, HPOS compatible.
- The PHP GD extension for the QR code image in e-mails (the thank-you page uses SVG and works without it).
External services
This plugin connects to the Fio banka API (https://fioapi.fio.cz/) to read the movements of your own account, using the token you enter. The request is made from your server every 15 minutes and when you click “Check now”. No other data is sent.
- Fio banka API documentation: https://www.fio.cz/bankovni-sluzby/api-bankovnictvi
- Terms of use (electronic account management): https://www.fio.cz/docs/cz/VSP_IB.pdf
- Privacy policy (Informační memorandum): https://www.fio.cz/docs/cz/fio_informacni_memorandum.pdf
The plugin is not affiliated with or endorsed by Fio banka, a.s.
Hooks
pmfio_payment_matched( WC_Order $order, string $result, array $movement ) – an incoming payment was assigned to an order.pmfio_refund_matched( WC_Order $order, float $amount, array $movement ) – an outgoing payment was recorded as a refund.pmfio_reminders_per_run– how many payment reminders are sent per check (default 20); the rest are sent on the next check, so a batch of old orders never floods the mail server.pmfio_status_poll_interval– how often the thank-you page asks for the status, in milliseconds (default 15000).pmfio_order_number_meta_key,pmfio_find_order– customise how the variable symbol is matched to an order.
Screenshots





Installation
- Upload the plugin and activate it.
- Go to WooCommerce Fio payments Settings and paste your Fio API token.
- Leave the mode on Observing only for a few days and check the results.
- Switch to Live.
You can also define the token in wp-config.php: define( 'PMFIO_FIO_TOKEN', '…' );
FAQ
-
How do I get the Fio API token?
-
- Log in to Fio internet banking (ib.fio.cz) and open Settings API.
- Choose the account that receives payments for orders and click “Add new token”. Name it, e.g. after the website.
- Choose the type “Account monitoring only” (read-only).
- Set the validity to 180 days and turn on automatic renewal – every login to internet banking then extends it.
- Confirm with SMS or Smartbanking. The token works about 5 minutes later.
- Click “Show full token” and copy all 64 characters to WooCommerce Fio payments Settings.
The same guide is shown in the plugin settings under “How to get the token”. Fio’s official guide with a screenshot of the API settings is on pages 4–5 of https://www.fio.cz/docs/cz/API_Bankovnictvi.pdf (in Czech).
-
Checks do not run on time. What can I do?
-
WordPress runs scheduled tasks only when someone visits the site. Copy the address from Settings Automatic checks and let your hosting’s cron open it every 15 minutes. The settings page shows when cron last called it.
-
I have a CZK and a EUR account. Does it work?
-
Yes. Create a read-only token for each account and add the second one under Settings Other Fio accounts. EUR orders are matched with payments in EUR, and their QR code (PAY by square) points to the EUR account.
-
Does it work with Fio banka in Slovakia?
-
It uses the same Fio API, so it should. The PAY by square QR code is included. Feedback from Slovak shops is welcome.
-
It works, because both only read the account, but Fio allows one request per 30 seconds per token. When they collide, one check is skipped and the next one catches up; the plugin does not raise an alert for that. A separate token per plugin and per website is cleaner.
-
What happens to payments seen in observing mode when I switch to live?
-
They are marked as “seen” and are not processed again, so you do not get a burst of e-mails for orders you already handled by hand.
-
Does it send the payment reminder to old orders?
-
No. Only orders created after you switched to live mode get a reminder, and each order gets at most one.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Payment Matcher for Fio Bank” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “Payment Matcher for Fio Bank” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.7.4
- The plugin page with a Czech guide moved to wp.kasparek.app.
1.7.3
- New: “Support development” link in the plugin list and on the plugin page.
1.7.2
- No limit on the number of additional Fio accounts.
- Translations are no longer bundled; they are delivered from translate.wordpress.org.
1.7.1
- Plugin name shortened to Payment Matcher for Fio Bank (the slug stays the same).
1.7.0
- New: multiple Fio accounts (e.g. CZK and EUR), each with its own token and expiry date.
- New: PAY by square QR code for EUR orders; the QR code uses the connected Fio account in the order’s currency.
- New: Slovak translation.
- Fio’s 30-second limit is now tracked per token.
1.6.3
- Payments table: labels of quiet rows (no order, seen, paid earlier) are grey too.
1.6.2
- Payments table: quieter rows for payments without an order, one-click “Assign to …” for suggestions, assign form folded away, shorter labels.
- Fix: an extra closing tag left the table outside the styled wrapper, so result labels lost their colours.
1.6.1
- Payments page: actions in the header, icons, a warning when automatic checks are not running.
wp pmfio checkwaits for the Fio rate limit instead of failing.
1.6.0
- New: server cron address with a secret key (throttled to once a minute), daily summary included. WP-CLI command
wp pmfio check.
1.5.2
- Settings: payment methods and order statuses are chosen with checkboxes by their names; technical options moved to “Advanced settings”.
1.5.1
- New: “Paid earlier” result for bank-transfer orders already marked paid by another plugin or by hand (no alert). Transfers to card-paid orders and second payments still need review.
- New: “Evaluate again” button while observing.
- Fix: filters in observing mode; “To review” no longer counts payments without an order; the waiting list only covers the last 30 days.
1.5.0
- New: live payment status on the thank-you page.
- New: refunds (outgoing payments) are recorded on the order. Other outgoing payments are stored without personal data and hidden.
- New: actions pmfio_payment_matched and pmfio_refund_matched for integrations.
1.4.0
- New: token expiry date with an e-mail and admin notice 14 days ahead.
- New: privacy policy text, personal data exporter and eraser, automatic deletion of old payments.
1.3.0
- Renamed to Payment Matcher for Fio Bank (slug payment-matcher-for-fio-bank, prefix pmfio).
- Stricter input sanitizing and output escaping.
1.2.0
- New: QR payment code (QR Platba) on the thank-you page and in order e-mails.
- New: redesigned admin page with overview, filters and tabs.
- Translations: English source strings, Czech translation included.
1.1.0
- New: manual assignment, suggestions without variable symbol, restore cancelled orders, order meta box, health alerts, daily summary, payment reminder.
1.0.0
- First version.
