Title: Payment Matcher for Fio Bank
Author: jakubkasparek
Published: <strong>November 18, 2026</strong>
Last modified: November 18, 2026

---

Search plugins

![](https://ps.w.org/payment-matcher-for-fio-bank/assets/banner-772x250.png?rev=
3809780)

![](https://ps.w.org/payment-matcher-for-fio-bank/assets/icon.svg?rev=3809780)

# Payment Matcher for Fio Bank

 By [jakubkasparek](https://profiles.wordpress.org/jakubkasparek/)

[Download](https://downloads.wordpress.org/plugin/payment-matcher-for-fio-bank.1.7.4.zip)

 * [Details](https://wordpress.org/plugins/payment-matcher-for-fio-bank/#description)
 * [Reviews](https://wordpress.org/plugins/payment-matcher-for-fio-bank/#reviews)
 *  [Installation](https://wordpress.org/plugins/payment-matcher-for-fio-bank/#installation)
 * [Development](https://wordpress.org/plugins/payment-matcher-for-fio-bank/#developers)

 [Support](https://wordpress.org/support/plugin/payment-matcher-for-fio-bank/)

## 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 check` for 
   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

[⌊Payments: overview, filters, manual assignment with a suggested order.⌉⌊Payments:
overview, filters, manual assignment with a suggested order.⌉[

Payments: overview, filters, manual assignment with a suggested order.

[⌊Settings: connection, matching, notifications and personal data.⌉⌊Settings: connection,
matching, notifications and personal data.⌉[

Settings: connection, matching, notifications and personal data.

[⌊QR payment settings with a live preview.⌉⌊QR payment settings with a live preview
.⌉[

QR payment settings with a live preview.

[⌊Thank-you page: live payment status and the QR code.⌉⌊Thank-you page: live payment
status and the QR code.⌉[

Thank-you page: live payment status and the QR code.

[⌊Order screen: payments from Fio for the order.⌉⌊Order screen: payments from Fio
for the order.⌉[

Order screen: payments from Fio for the order.

## Installation

 1. Upload the plugin and activate it.
 2. Go to **WooCommerce  Fio payments  Settings** and paste your Fio API token.
 3. Leave the mode on **Observing only** for a few days and check the results.
 4. 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?

 1. Log in to Fio internet banking (ib.fio.cz) and open Settings  API.
 2. Choose the account that receives payments for orders and click “Add new token”.
    Name it, e.g. after the website.
 3. Choose the type “Account monitoring only” (read-only).
 4. Set the validity to 180 days and turn on automatic renewal – every login to internet
    banking then extends it.
 5. Confirm with SMS or Smartbanking. The token works about 5 minutes later.
 6. 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.

### Can I share the token with another Fio plugin?

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.

Contributors

 *   [ jakubkasparek ](https://profiles.wordpress.org/jakubkasparek/)

[Translate “Payment Matcher for Fio Bank” into your language.](https://translate.wordpress.org/projects/wp-plugins/payment-matcher-for-fio-bank)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/payment-matcher-for-fio-bank/),
check out the [SVN repository](https://plugins.svn.wordpress.org/payment-matcher-for-fio-bank/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/payment-matcher-for-fio-bank/)
by [RSS](https://plugins.trac.wordpress.org/log/payment-matcher-for-fio-bank/?limit=100&mode=stop_on_copy&format=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 check` waits 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.

## Meta

 *  Version **1.7.4**
 *  Last updated **54 minutes ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 6.4 or higher **
 *  Tested up to **7.1.5**
 *  PHP version ** 7.4 or higher **
 * Tags
 * [bank transfer](https://wordpress.org/plugins/tags/bank-transfer/)[fio](https://wordpress.org/plugins/tags/fio/)
   [payment](https://wordpress.org/plugins/tags/payment/)[qr](https://wordpress.org/plugins/tags/qr/)
   [woocommerce](https://wordpress.org/plugins/tags/woocommerce/)
 *  [Advanced View](https://wordpress.org/plugins/payment-matcher-for-fio-bank/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/payment-matcher-for-fio-bank/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/payment-matcher-for-fio-bank/reviews/)

## Contributors

 *   [ jakubkasparek ](https://profiles.wordpress.org/jakubkasparek/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/payment-matcher-for-fio-bank/)

## Donate

Would you like to support the advancement of this plugin?

 [ Donate to this plugin ](https://wp.kasparek.app/fio#podpora)