Title: Fair Payments Connector
Author: Marcin Wosinek
Published: <strong>June 17, 2026</strong>
Last modified: June 17, 2026

---

Search plugins

![](https://s.w.org/plugins/geopattern-icon/fair-payments-connector.svg)

# Fair Payments Connector

 By [Marcin Wosinek](https://profiles.wordpress.org/marcinwosinek/)

[Download](https://downloads.wordpress.org/plugin/fair-payments-connector.1.2.0.zip)

 * [Details](https://wordpress.org/plugins/fair-payments-connector/#description)
 * [Reviews](https://wordpress.org/plugins/fair-payments-connector/#reviews)
 *  [Installation](https://wordpress.org/plugins/fair-payments-connector/#installation)
 * [Development](https://wordpress.org/plugins/fair-payments-connector/#developers)

 [Support](https://wordpress.org/support/plugin/fair-payments-connector/)

## Description

Fair Payments Connector is the money layer of the Fair Event plugin suite. It handles
Mollie payment processing, stores transactions with line items, and provides a ledger
for budgets and bank-import reconciliation.

Features:

 * Mollie payment gateway with test/live modes, application fees, and webhook handling
 * Transactions with itemized line items, linked to posts, event dates (fair-events),
   and participants (fair-audience)
 * Status lifecycle (`draft`  `pending_payment`  `paid`/`failed`) with action hooks(`
   fair_payment_paid`, etc.)
 * Proactive status sync to recover stuck pending payments
 * Budgets and financial entries ledger with split entries, event linkage, and import
   deduplication
 * Many-to-many reconciliation between bank-import entries and transactions
 * Token-authenticated data sharing API so satellite sites can pull their own transaction
   data from a hub site
 * Telegram notifications on payment events
 * Gutenberg “Simple Payment” block (amount, currency, description) for standalone
   use
 * Admin pages for transactions, budgets, entries, reconciliation, API tokens, connected
   sites, and settings

Public PHP API for integration from other plugins:

 * `fair_payment_create_transaction( $line_items, $args )`
 * `fair_payment_initiate_payment( $transaction_id, $args )`
 * `fair_payment_get_transaction( $transaction_id )`
 * `fair_payment_sync_transaction_status( $transaction_id )`

### Development

 * GitHub Repository: https://github.com/marcin-wosinek/fair-event-plugins
 * Report Issues: https://github.com/marcin-wosinek/fair-event-plugins/issues
 * Contribute: https://github.com/marcin-wosinek/fair-event-plugins/pulls

### External services

This plugin relies on the following third-party services. Data is only sent to a
service when you enable and configure the related feature.

#### Mollie payment gateway (api.mollie.com)

Used to process payments. When a customer initiates a payment through the plugin(
for example by submitting the Simple Payment block, or when another plugin calls`
fair_payment_initiate_payment()`), the plugin contacts the Mollie API to create 
the payment and later to retrieve its status (including via Mollie webhooks and 
periodic status sync). Data sent includes: payment amount and currency, description,
redirect/webhook URLs of your site, customer billing email when provided, and your
Mollie access token. Mollie is operated by Mollie B.V.

 * Terms of service: https://www.mollie.com/legal/user-agreement
 * Privacy policy: https://www.mollie.com/legal/privacy

#### Fair Event Plugins OAuth proxy (fair-event-plugins.com)

Used only if you connect Mollie through the built-in OAuth flow instead of pasting
a personal API key. The plugin redirects you to `https://fair-event-plugins.com/
oauth/authorize` to authorize access to your Mollie account, and later calls `https://
fair-event-plugins.com/oauth/refresh` to refresh the Mollie access token when it
expires. Data sent includes: the OAuth refresh token stored in your site and, during
initial authorization, the parameters Mollie returns to the proxy. The proxy is 
operated by the plugin author (Marcin Wosinek) and exists because Mollie OAuth requires
a registered client secret that cannot ship in a public plugin.

 * Terms of service: https://fair-event-plugins.com/terms/
 * Privacy policy: https://fair-event-plugins.com/privacy/

#### Telegram Bot API (api.telegram.org)

Used only if you configure a Telegram bot token and chat ID in the plugin settings
to receive payment notifications. When a payment event occurs (such as a payment
being marked as paid or failed), the plugin sends an HTTP request to `https://api.
telegram.org/bot<token>/sendMessage` containing the notification text (transaction
id, amount, status, and a link back to the admin transaction page) and the configured
chat id. The Telegram Bot API is operated by Telegram FZ-LLC / Telegram Messenger
Inc.

 * Terms of service (Bot API): https://telegram.org/tos/bot-developers
 * Privacy policy: https://telegram.org/privacy

#### Other WordPress sites you connect (hub / satellite data sharing)

If you use the connected-sites / data-sharing feature, the plugin will send authenticated
REST requests to the WordPress site URLs you explicitly enter in the “Connected 
sites” admin page so it can pull transaction data. No data is sent to those sites
unless you configure them yourself. There are no third-party terms for this feature—
the remote endpoint is another WordPress site running this same plugin, under your
control.

## Blocks

This plugin provides 1 block.

 *   Simple Payment Simple payment block for WordPress

## Installation

 1. Upload the plugin files to the `/wp-content/plugins/fair-payments-connector` directory,
    or install the plugin through the WordPress plugins screen directly.
 2. Activate the plugin through the ‘Plugins’ screen in WordPress

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“Fair Payments Connector” is open source software. The following people have contributed
to this plugin.

Contributors

 *   [ Marcin Wosinek ](https://profiles.wordpress.org/marcinwosinek/)

[Translate “Fair Payments Connector” into your language.](https://translate.wordpress.org/projects/wp-plugins/fair-payments-connector)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/fair-payments-connector/),
check out the [SVN repository](https://plugins.svn.wordpress.org/fair-payments-connector/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/fair-payments-connector/)
by [RSS](https://plugins.trac.wordpress.org/log/fair-payments-connector/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 0.1.0

 * Initial release

## Meta

 *  Version **1.2.0**
 *  Last updated **16 hours ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 6.2 or higher **
 *  Tested up to **7.0**
 *  PHP version ** 7.4 or higher **
 * Tags
 * [block](https://wordpress.org/plugins/tags/block/)[Bookkeeping](https://wordpress.org/plugins/tags/bookkeeping/)
   [events](https://wordpress.org/plugins/tags/events/)[mollie](https://wordpress.org/plugins/tags/mollie/)
   [payment](https://wordpress.org/plugins/tags/payment/)
 *  [Advanced View](https://wordpress.org/plugins/fair-payments-connector/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/fair-payments-connector/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/fair-payments-connector/reviews/)

## Contributors

 *   [ Marcin Wosinek ](https://profiles.wordpress.org/marcinwosinek/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/fair-payments-connector/)