Marcin Wosinek

<p>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.</p>
<p>Features:</p>
<ul>
<li>Mollie payment gateway with test/live modes, application fees, and webhook handling</li>
<li>Transactions with itemized line items, linked to posts, event dates (fair-events), and participants (fair-audience)</li>
<li>Status lifecycle (<code>draft</code> <span aria-hidden="true" class="wp-exclude-emoji">→</span> <code>pending_payment</code> <span aria-hidden="true" class="wp-exclude-emoji">→</span> <code>paid</code>/<code>failed</code>) with action hooks (<code>fair_payment_paid</code>, etc.)</li>
<li>Proactive status sync to recover stuck pending payments</li>
<li>Budgets and financial entries ledger with split entries, event linkage, and import deduplication</li>
<li>Many-to-many reconciliation between bank-import entries and transactions</li>
<li>Token-authenticated data sharing API so satellite sites can pull their own transaction data from a hub site</li>
<li>Telegram notifications on payment events</li>
<li>Gutenberg “Simple Payment” block (amount, currency, description) for standalone use</li>
<li>Admin pages for transactions, budgets, entries, reconciliation, API tokens, connected sites, and settings</li>
</ul>
<p>Public PHP API for integration from other plugins:</p>
<ul>
<li><code>fair_payment_create_transaction( $line_items, $args )</code></li>
<li><code>fair_payment_initiate_payment( $transaction_id, $args )</code></li>
<li><code>fair_payment_get_transaction( $transaction_id )</code></li>
<li><code>fair_payment_sync_transaction_status( $transaction_id )</code></li>
</ul>
<h3>Development</h3>
<ul>
<li>GitHub Repository: https://github.com/marcin-wosinek/fair-event-plugins</li>
<li>Report Issues: https://github.com/marcin-wosinek/fair-event-plugins/issues</li>
<li>Contribute: https://github.com/marcin-wosinek/fair-event-plugins/pulls</li>
</ul>
<h3>External services</h3>
<p>This plugin relies on the following third-party services. Data is only sent to a service when you enable and configure the related feature.</p>
<h4>Mollie payment gateway (api.mollie.com)</h4>
<p>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 <code>fair_payment_initiate_payment()</code>), 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.</p>
<ul>
<li>Terms of service: https://www.mollie.com/legal/user-agreement</li>
<li>Privacy policy: https://www.mollie.com/legal/privacy</li>
</ul>
<h4>Fair Event Plugins OAuth proxy (fair-event-plugins.com)</h4>
<p>Used only if you connect Mollie through the built-in OAuth flow instead of pasting a personal API key. The plugin redirects you to <code>https://fair-event-plugins.com/oauth/authorize</code> to authorize access to your Mollie account, and later calls <code>https://fair-event-plugins.com/oauth/refresh</code> 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.</p>
<ul>
<li>Terms of service: https://fair-event-plugins.com/terms/</li>
<li>Privacy policy: https://fair-event-plugins.com/privacy/</li>
</ul>
<h4>Telegram Bot API (api.telegram.org)</h4>
<p>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 <code>https://api.telegram.org/bot<token>/sendMessage</code> 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.</p>
<ul>
<li>Terms of service (Bot API): https://telegram.org/tos/bot-developers</li>
<li>Privacy policy: https://telegram.org/privacy</li>
</ul>
<h4>Other WordPress sites you connect (hub / satellite data sharing)</h4>
<p>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.</p>


Fair Payments Connector

Mollie-based payments and bookkeeping for WordPress events.

tsjippy

<p>Add-on plugin for Contact Form 7 – adds three fields and a shortcode.</p>
<h3>Mollie Description</h3>
<p>Add a (hidden) field: [text paymentdescription “Payment for This is my description”]</p>
<h3>Payment amount</h3>
<p>The amount which needs to be payed.<br />
Does accept shortcodes without brackets like so:<br />
    [amount* amount-734 “CF7_GET key=’Amount'”]</p>
<h3>Payment Options</h3>
<p>Optional field so that the user can select from available payment options.<br />
This field is filled automatically with all payment options from Mollie.<br />
You can also add extra options like “cash”.<br />
If this field is not present, people have to select the payment option on the mollie website.<br />
If there is only one payment option available this will be automatically selected.</p>
<p>There are three Payment options types:</p>
<h3>Default</h3>
<p>The type is “oneoff”, ment for payment that occur once</p>
<h3>Recurring</h3>
<p>This list all availbale payment options for recurring payments</p>
<h3>Initial payment</h3>
<p>This lists all available payment options to do the first payment of a recurring payment.<br />
This initial payment is needed to confirm the recurring payment.</p>
<p>If you want to do recurring payment and you have only one recurring payment option available, you can skip this the recurring field.<br />
Only an Initial payment field is enough.</p>
<h3>iDeal bankchoice:</h3>
<p>If payment option iDeal is chosen, this field can be used to select the bank (issuer).</p>
<h3>frequency</h3>
<p>You can optionally add a field with name “frequency” to use with the recurring payment to set the payment frequency in months.</p>
<h3>chargedate</h3>
<p>You can optionall add a date field with the name “chargedate” to use with the recurring payment to set the first chargedate.</p>
<h3>Shortcode for payment result</h3>
<p>[payment_result]<br />
This shortcode can be used on a custom redirect page or on the form page itself.</p>
<p>The shortcode can have a shortcode nested within it.<br />
It accepts two arguments, both can include layout and pictures:<br />
succes — the succes message to be displayed<br />
fail — the failure message to be displayed</p>
<p>On succes only the success message will be displayed.<br />
In all other cases the nested content will be displayed.</p>
<p>You can include shortcodes just use $l for [ and $r for ]</p>
<p>Shortcode can thus be used like this:</p>
<p>[payment_result success = “Uw donatie is succesvol ontvangen. Hartelijk dank daarvoor! $lSome shortcode$r”  fail = “Uw donatie is mislukt, probeert u het alstublieft opnieuw.”]</p>
<pre><code>[payment_result success = "Your payment was successful." fail = "Payment failed, try again."]

    Fill in the form below to pay.
    [contact-form-7 id="211" title="Paymentform"]  
    Thank you.
[/payment_result]
</code></pre>
<p>In this case the contact form with id 211 will not be shown on successful payment, only the success message will.</p>
<p>All arguments are optional, you can also use the shortcode like this: [payment_result].<br />
In that case the default messages will be:<br />
‘Payment was successful, thank you.’<br />
‘Payment failed, please try again.’</p>
<h3>Shortcode for payment overview</h3>
<p>The short code [paymentstable] gives an oveview of all payments made.<br />
It accepts the parameters: hide, header, paymenttype and columns<br />
hide difines the columns no to shown<br />
header changes the title<br />
paymenttype define whether to show only subscriptions (paymenttype=”subscription”) or only one time payments (paymenttype=”onetime”)<br />
columns defines custom column names.<br />
status=”paid” only shows payments with the status paid<br />
search = “!Description=’Some decription'” shows all payments excluding the one with “Some decription” as description<br />
search = “Description=’Some decription'” shows all payments with “Some decription” as description</p>
<p>example:<br />
[paymentstable} hide=”Time,OrderID,CustomerID,Times,PaymentID, Status,SubscriptionID” header=Custom table title” columns=”ID,Naam,E-mail,Bedrag, Omschrijving,Frequentie,Start datum, Mogelijke acties” status=”paid” search=”!Description=’Some description'”]</p>
<h3>Usage</h3>
<h3>General Settings</h3>
<p>Create a Mollie account, and paste the api into the side-wide api key field under “Mollie”, or use it on the form specific settings tab.</p>
<p>Optionally define a redirect page.</p>
<h3>Examples</h3>
<h3>One off payment</h3>
<pre><code>[hidden paymentdescription "Payment for some description"]

[submission_id_hidden orderid]

<label> Donation amount
[amount* amount-185 min:5]</label>

<label> Payment method
[paymentchoice paymentmethod-901 paymenttype:oneoff]</label>

<label> Your bank brand
[bankchoice bankchoice-22]</label>
</code></pre>
<h3>Recurring Payment with multiple recurring methods avaialble</h3>
<pre><code>[hidden paymentdescription "Payment for some description"]

<label> Donation amount
[amount* amount-185 min:5]</label>

<label> Payment method
[paymentchoice paymentmethod-14 paymenttype:recurring]</label>

<label> Payment method for first payment
[paymentchoice paymentmethod-15 paymenttype:first]</label>

<label> Your bank brand
[bankchoice bankchoice-22]</label>

<label> How often do you want to pay
[select frequency "1" "3" "6" "12"] months</label>

<label> When do you want to be charged for the first time?
[date chargedate]</label>
</code></pre>
<h3>Minimal Recurring Payment</h3>
<pre><code>[hidden paymentdescription "Payment for some description"]

<label> Donation amount
[amount* amount-185 min:5]</label>

<label> Payment method for first payment
[paymentchoice paymentmethod-15 paymenttype:first]</label>
</code></pre>


Mollie for Contact Form 7

An add-on for Contact Form 7 to connect to Mollie.

Fair Payments Connector vs Mollie for Contact Form 7