{"id":406452,"date":"2026-11-18T16:35:52","date_gmt":"2026-11-18T16:35:52","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/payment-matcher-for-fio-bank\/"},"modified":"2026-11-18T18:30:46","modified_gmt":"2026-11-18T18:30:46","slug":"payment-matcher-for-fio-bank","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/payment-matcher-for-fio-bank\/","author":17808888,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.7.4","stable_tag":"1.7.4","tested":"7.1.5","requires":"6.4","requires_php":"7.4","requires_plugins":null,"header_name":"Payment Matcher for Fio Bank","header_author":"Jakub Ka\u0161p\u00e1rek","header_description":"Downloads incoming payments from the Fio banka API and marks bank-transfer orders as paid by variable symbol. Manual assignment, payment reminders, daily summary, token health alerts, multiple accounts and an optional QR payment code (QR Platba, PAY by square).","last_updated":"2026-11-18 18:30:46","external_support_url":"","external_repository_url":"","donate_link":"https:\/\/wp.kasparek.app\/fio#podpora","header_plugin_uri":"https:\/\/wp.kasparek.app\/fio","header_author_uri":"https:\/\/github.com\/kasparek-net","rating":0,"author_block_rating":0,"active_installs":0,"downloads":60,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.7.2":{"tag":"1.7.2","author":"jakubkasparek","date":"2026-11-18 16:35:27","revision":3809780},"1.7.3":{"tag":"1.7.3","author":"jakubkasparek","date":"2026-11-18 17:18:46","revision":3809864},"1.7.4":{"tag":"1.7.4","author":"jakubkasparek","date":"2026-11-18 18:30:46","revision":3809997}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3809780,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3809780,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256},"icon.svg":{"filename":"icon.svg","revision":3809780,"resolution":false,"location":"assets","locale":false}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3809780,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3809780,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.7.2","1.7.3","1.7.4"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3809780,"resolution":"1","location":"assets","locale":"","width":2200,"height":2032},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3809780,"resolution":"2","location":"assets","locale":"","width":2200,"height":3448},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3809780,"resolution":"3","location":"assets","locale":"","width":2200,"height":1598},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3809780,"resolution":"4","location":"assets","locale":"","width":2064,"height":730},"screenshot-5.png":{"filename":"screenshot-5.png","revision":3809780,"resolution":"5","location":"assets","locale":"","width":560,"height":340}},"screenshots":{"1":"Payments: overview, filters, manual assignment with a suggested order.","2":"Settings: connection, matching, notifications and personal data.","3":"QR payment settings with a live preview.","4":"Thank-you page: live payment status and the QR code.","5":"Order screen: payments from Fio for the order."}},"plugin_section":[],"plugin_tags":[127760,156739,507,7312,286],"plugin_category":[45],"plugin_contributors":[245695],"plugin_business_model":[],"class_list":["post-406452","plugin","type-plugin","status-publish","hentry","plugin_tags-bank-transfer","plugin_tags-fio","plugin_tags-payment","plugin_tags-qr","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_contributors-jakubkasparek","plugin_committers-jakubkasparek"],"banners":{"banner":"https:\/\/ps.w.org\/payment-matcher-for-fio-bank\/assets\/banner-772x250.png?rev=3809780","banner_2x":"https:\/\/ps.w.org\/payment-matcher-for-fio-bank\/assets\/banner-1544x500.png?rev=3809780","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":"https:\/\/ps.w.org\/payment-matcher-for-fio-bank\/assets\/icon.svg?rev=3809780","icon":"https:\/\/ps.w.org\/payment-matcher-for-fio-bank\/assets\/icon.svg?rev=3809780","icon_2x":false,"generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/payment-matcher-for-fio-bank\/assets\/screenshot-1.png?rev=3809780","caption":"Payments: overview, filters, manual assignment with a suggested order."},{"src":"https:\/\/ps.w.org\/payment-matcher-for-fio-bank\/assets\/screenshot-2.png?rev=3809780","caption":"Settings: connection, matching, notifications and personal data."},{"src":"https:\/\/ps.w.org\/payment-matcher-for-fio-bank\/assets\/screenshot-3.png?rev=3809780","caption":"QR payment settings with a live preview."},{"src":"https:\/\/ps.w.org\/payment-matcher-for-fio-bank\/assets\/screenshot-4.png?rev=3809780","caption":"Thank-you page: live payment status and the QR code."},{"src":"https:\/\/ps.w.org\/payment-matcher-for-fio-bank\/assets\/screenshot-5.png?rev=3809780","caption":"Order screen: payments from Fio for the order."}],"raw_content":"<!--section=description-->\n<p>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.<\/p>\n\n<h4>What it does<\/h4>\n\n<ul>\n<li><strong>Automatic matching<\/strong> by variable symbol \u2013 also finds the order number in the message for recipient and ignores leading zeros. Works with sequential order number plugins.<\/li>\n<li><strong>Live status on the thank-you page<\/strong> \u2013 \u201cWaiting for your bank transfer\u201d switches to \u201cPayment received\u201d by itself, usually within a minute.<\/li>\n<li><strong>Refunds<\/strong> \u2013 an outgoing payment with the order\u2019s variable symbol is recorded on the order, only when money for that order actually arrived.<\/li>\n<li><strong>Underpayments and overpayments<\/strong> \u2013 partial payments add up; you get an e-mail for anything that needs attention.<\/li>\n<li><strong>Observing mode<\/strong> \u2013 start safely: the plugin only lists what it would do, changes nothing.<\/li>\n<li><strong>Manual assignment<\/strong> \u2013 assign any payment to an order with one click, with a suggestion when the variable symbol is missing (same amount and sender name).<\/li>\n<li><strong>Restore and mark paid<\/strong> \u2013 when money arrives for an order that was already cancelled.<\/li>\n<li><strong>Payment box in the order<\/strong> \u2013 all payments for the order and how long it has been waiting.<\/li>\n<li><strong>Server cron address<\/strong> \u2013 a secret URL your hosting\u2019s cron can open every 15 minutes, so checks run even when WP-Cron does not. Plus <code>wp pmfio check<\/code> for WP-CLI.<\/li>\n<li><strong>Token health alerts<\/strong> \u2013 an e-mail and an admin notice when the Fio token expires or checks stop running.<\/li>\n<li><strong>Daily summary<\/strong> e-mail at 7:00.<\/li>\n<li><strong>Payment reminder<\/strong> \u2013 a standard WooCommerce e-mail sent to the customer after a set number of days without payment.<\/li>\n<li><strong>Token expiry reminder<\/strong> \u2013 set the token\u2019s expiry date and get an e-mail and an admin notice 14 days before.<\/li>\n<li><strong>Personal data<\/strong> \u2013 privacy policy text, WordPress personal data export and erasure, automatic deletion of old payments (12 months by default).<\/li>\n<li><strong>Multiple Fio accounts<\/strong> \u2013 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.<\/li>\n<li><strong>QR payment<\/strong> \u2013 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\u2019s currency is used automatically. Generated on your server, no external service.<\/li>\n<li><strong>Translation-ready<\/strong> \u2013 Czech and Slovak translations are provided through translate.wordpress.org.<\/li>\n<\/ul>\n\n<h4>Requirements<\/h4>\n\n<ul>\n<li>A Fio banka account and a read-only API token (Fio internet banking \u2192 Settings \u2192 API \u2192 Add token, type \u201cAccount monitoring\u201d).<\/li>\n<li>WooCommerce 8.0+, HPOS compatible.<\/li>\n<li>The PHP GD extension for the QR code image in e-mails (the thank-you page uses SVG and works without it).<\/li>\n<\/ul>\n\n<h4>External services<\/h4>\n\n<p>This plugin connects to the <strong>Fio banka API<\/strong> (<code>https:\/\/fioapi.fio.cz\/<\/code>) 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 \u201cCheck now\u201d. No other data is sent.<\/p>\n\n<ul>\n<li>Fio banka API documentation: https:\/\/www.fio.cz\/bankovni-sluzby\/api-bankovnictvi<\/li>\n<li>Terms of use (electronic account management): https:\/\/www.fio.cz\/docs\/cz\/VSP_IB.pdf<\/li>\n<li>Privacy policy (Informa\u010dn\u00ed memorandum): https:\/\/www.fio.cz\/docs\/cz\/fio_informacni_memorandum.pdf<\/li>\n<\/ul>\n\n<p>The plugin is not affiliated with or endorsed by Fio banka, a.s.<\/p>\n\n<h3>Hooks<\/h3>\n\n<ul>\n<li><code>pmfio_payment_matched<\/code> ( WC_Order $order, string $result, array $movement ) \u2013 an incoming payment was assigned to an order.<\/li>\n<li><code>pmfio_refund_matched<\/code> ( WC_Order $order, float $amount, array $movement ) \u2013 an outgoing payment was recorded as a refund.<\/li>\n<li><code>pmfio_reminders_per_run<\/code> \u2013 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.<\/li>\n<li><code>pmfio_status_poll_interval<\/code> \u2013 how often the thank-you page asks for the status, in milliseconds (default 15000).<\/li>\n<li><code>pmfio_order_number_meta_key<\/code>, <code>pmfio_find_order<\/code> \u2013 customise how the variable symbol is matched to an order.<\/li>\n<\/ul>\n\n<!--section=installation-->\n<ol>\n<li>Upload the plugin and activate it.<\/li>\n<li>Go to <strong>WooCommerce \u2192 Fio payments \u2192 Settings<\/strong> and paste your Fio API token.<\/li>\n<li>Leave the mode on <strong>Observing only<\/strong> for a few days and check the results.<\/li>\n<li>Switch to <strong>Live<\/strong>.<\/li>\n<\/ol>\n\n<p>You can also define the token in <code>wp-config.php<\/code>: <code>define( 'PMFIO_FIO_TOKEN', '\u2026' );<\/code><\/p>\n\n<!--section=faq-->\n<dl>\n<dt id=\"how%20do%20i%20get%20the%20fio%20api%20token%3F\"><h3>How do I get the Fio API token?<\/h3><\/dt>\n<dd><ol>\n<li>Log in to Fio internet banking (ib.fio.cz) and open Settings \u2192 API.<\/li>\n<li>Choose the account that receives payments for orders and click \u201cAdd new token\u201d. Name it, e.g. after the website.<\/li>\n<li>Choose the type \u201cAccount monitoring only\u201d (read-only).<\/li>\n<li>Set the validity to 180 days and turn on automatic renewal \u2013 every login to internet banking then extends it.<\/li>\n<li>Confirm with SMS or Smartbanking. The token works about 5 minutes later.<\/li>\n<li>Click \u201cShow full token\u201d and copy all 64 characters to WooCommerce \u2192 Fio payments \u2192 Settings.<\/li>\n<\/ol>\n\n<p>The same guide is shown in the plugin settings under \u201cHow to get the token\u201d. Fio\u2019s official guide with a screenshot of the API settings is on pages 4\u20135 of https:\/\/www.fio.cz\/docs\/cz\/API_Bankovnictvi.pdf (in Czech).<\/p><\/dd>\n<dt id=\"checks%20do%20not%20run%20on%20time.%20what%20can%20i%20do%3F\"><h3>Checks do not run on time. What can I do?<\/h3><\/dt>\n<dd><p>WordPress runs scheduled tasks only when someone visits the site. Copy the address from Settings \u2192 Automatic checks and let your hosting\u2019s cron open it every 15 minutes. The settings page shows when cron last called it.<\/p><\/dd>\n<dt id=\"i%20have%20a%20czk%20and%20a%20eur%20account.%20does%20it%20work%3F\"><h3>I have a CZK and a EUR account. Does it work?<\/h3><\/dt>\n<dd><p>Yes. Create a read-only token for each account and add the second one under Settings \u2192 Other Fio accounts. EUR orders are matched with payments in EUR, and their QR code (PAY by square) points to the EUR account.<\/p><\/dd>\n<dt id=\"does%20it%20work%20with%20fio%20banka%20in%20slovakia%3F\"><h3>Does it work with Fio banka in Slovakia?<\/h3><\/dt>\n<dd><p>It uses the same Fio API, so it should. The PAY by square QR code is included. Feedback from Slovak shops is welcome.<\/p><\/dd>\n<dt id=\"can%20i%20share%20the%20token%20with%20another%20fio%20plugin%3F\"><h3>Can I share the token with another Fio plugin?<\/h3><\/dt>\n<dd><p>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.<\/p><\/dd>\n<dt id=\"what%20happens%20to%20payments%20seen%20in%20observing%20mode%20when%20i%20switch%20to%20live%3F\"><h3>What happens to payments seen in observing mode when I switch to live?<\/h3><\/dt>\n<dd><p>They are marked as \u201cseen\u201d and are not processed again, so you do not get a burst of e-mails for orders you already handled by hand.<\/p><\/dd>\n<dt id=\"does%20it%20send%20the%20payment%20reminder%20to%20old%20orders%3F\"><h3>Does it send the payment reminder to old orders?<\/h3><\/dt>\n<dd><p>No. Only orders created after you switched to live mode get a reminder, and each order gets at most one.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.7.4<\/h4>\n\n<ul>\n<li>The plugin page with a Czech guide moved to wp.kasparek.app.<\/li>\n<\/ul>\n\n<h4>1.7.3<\/h4>\n\n<ul>\n<li>New: \"Support development\" link in the plugin list and on the plugin page.<\/li>\n<\/ul>\n\n<h4>1.7.2<\/h4>\n\n<ul>\n<li>No limit on the number of additional Fio accounts.<\/li>\n<li>Translations are no longer bundled; they are delivered from translate.wordpress.org.<\/li>\n<\/ul>\n\n<h4>1.7.1<\/h4>\n\n<ul>\n<li>Plugin name shortened to Payment Matcher for Fio Bank (the slug stays the same).<\/li>\n<\/ul>\n\n<h4>1.7.0<\/h4>\n\n<ul>\n<li>New: multiple Fio accounts (e.g. CZK and EUR), each with its own token and expiry date.<\/li>\n<li>New: PAY by square QR code for EUR orders; the QR code uses the connected Fio account in the order\u2019s currency.<\/li>\n<li>New: Slovak translation.<\/li>\n<li>Fio's 30-second limit is now tracked per token.<\/li>\n<\/ul>\n\n<h4>1.6.3<\/h4>\n\n<ul>\n<li>Payments table: labels of quiet rows (no order, seen, paid earlier) are grey too.<\/li>\n<\/ul>\n\n<h4>1.6.2<\/h4>\n\n<ul>\n<li>Payments table: quieter rows for payments without an order, one-click \u201cAssign to \u2026\u201d for suggestions, assign form folded away, shorter labels.<\/li>\n<li>Fix: an extra closing tag left the table outside the styled wrapper, so result labels lost their colours.<\/li>\n<\/ul>\n\n<h4>1.6.1<\/h4>\n\n<ul>\n<li>Payments page: actions in the header, icons, a warning when automatic checks are not running. <code>wp pmfio check<\/code> waits for the Fio rate limit instead of failing.<\/li>\n<\/ul>\n\n<h4>1.6.0<\/h4>\n\n<ul>\n<li>New: server cron address with a secret key (throttled to once a minute), daily summary included. WP-CLI command <code>wp pmfio check<\/code>.<\/li>\n<\/ul>\n\n<h4>1.5.2<\/h4>\n\n<ul>\n<li>Settings: payment methods and order statuses are chosen with checkboxes by their names; technical options moved to \u201cAdvanced settings\u201d.<\/li>\n<\/ul>\n\n<h4>1.5.1<\/h4>\n\n<ul>\n<li>New: \u201cPaid earlier\u201d 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.<\/li>\n<li>New: \u201cEvaluate again\u201d button while observing.<\/li>\n<li>Fix: filters in observing mode; \u201cTo review\u201d no longer counts payments without an order; the waiting list only covers the last 30 days.<\/li>\n<\/ul>\n\n<h4>1.5.0<\/h4>\n\n<ul>\n<li>New: live payment status on the thank-you page.<\/li>\n<li>New: refunds (outgoing payments) are recorded on the order. Other outgoing payments are stored without personal data and hidden.<\/li>\n<li>New: actions pmfio_payment_matched and pmfio_refund_matched for integrations.<\/li>\n<\/ul>\n\n<h4>1.4.0<\/h4>\n\n<ul>\n<li>New: token expiry date with an e-mail and admin notice 14 days ahead.<\/li>\n<li>New: privacy policy text, personal data exporter and eraser, automatic deletion of old payments.<\/li>\n<\/ul>\n\n<h4>1.3.0<\/h4>\n\n<ul>\n<li>Renamed to Payment Matcher for Fio Bank (slug payment-matcher-for-fio-bank, prefix pmfio).<\/li>\n<li>Stricter input sanitizing and output escaping.<\/li>\n<\/ul>\n\n<h4>1.2.0<\/h4>\n\n<ul>\n<li>New: QR payment code (QR Platba) on the thank-you page and in order e-mails.<\/li>\n<li>New: redesigned admin page with overview, filters and tabs.<\/li>\n<li>Translations: English source strings, Czech translation included.<\/li>\n<\/ul>\n\n<h4>1.1.0<\/h4>\n\n<ul>\n<li>New: manual assignment, suggestions without variable symbol, restore cancelled orders, order meta box, health alerts, daily summary, payment reminder.<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>First version.<\/li>\n<\/ul>","raw_excerpt":"Marks WooCommerce bank-transfer orders as paid automatically using the Fio banka API. Manual assignment, reminders, QR payment code.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/406452","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=406452"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/jakubkasparek"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=406452"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=406452"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=406452"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=406452"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=406452"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=406452"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}