Payment Gateways
Pro - Payment gateways require Eventonomy Pro.
Eventonomy Pro supports five payment gateways: Stripe, PayPal, Square, Mollie, and WooCommerce. Only one gateway is active at a time. This page walks you through configuring each one.
What You Will Learn
- Where to configure payment gateways
- Step-by-step setup for each gateway
- What a webhook URL is and why you need it
- How to switch the active gateway
Where to Configure Gateways
Go to Eventonomy → Settings → Money → Payments (Pro).
Note: This card is only visible when Pro is active. In the Free plan the card is not shown.
Select the Active gateway from the dropdown. The settings panel for that gateway appears below the selector. Only the active gateway's credentials are used at checkout.
Stripe
Stripe processes payments with 0% platform fee from Eventonomy. Stripe charges its own standard processing fee.
Setup Steps
- Go to Stripe Dashboard → Developers → API keys.
- Copy your Secret key (starts with
sk_live_for production orsk_test_for sandbox). - Paste it into the Secret key field in Eventonomy → Settings → Money → Payments.
- Copy the Webhook URL shown in the same panel.
- In the Stripe Dashboard, go to Developers → Webhooks and click Add endpoint.
- Paste the Webhook URL and subscribe to
checkout.session.completedandpayment_intent.succeededevents. - Save changes.
Sandbox Testing
Use a sk_test_ key to test without real charges. Stripe test cards are listed in the Stripe docs.
PayPal
PayPal uses REST API credentials from the PayPal Developer Dashboard.
Setup Steps
- Go to PayPal Developer Dashboard → Apps & Credentials.
- Toggle between Sandbox and Live to match the environment you want to set up.
- Open your app (or create one) and copy the Client ID and Secret.
- Paste them into the Client ID and Secret fields in Eventonomy → Settings → Money → Payments.
- If testing, check Use the PayPal sandbox (test) environment.
- Copy the Webhook URL shown in the panel.
- In the PayPal Developer Dashboard, add the Webhook URL to your app's Webhooks and subscribe to payment completion events.
- Save changes.
Note: Make sure the sandbox checkbox matches the credentials you entered. Sandbox credentials do not work in live mode and vice versa.
Square
Square requires an access token from the Square Developer Dashboard.
Setup Steps
- Go to Square Developer Dashboard and open your application.
- Go to Credentials and copy the Production Access Token (or sandbox token for testing).
- Paste it into the Access token field in Eventonomy → Settings → Money → Payments.
- Copy the Webhook URL shown in the panel.
- In the Square Developer Dashboard, go to your app's Webhooks and add the Webhook URL.
- Save changes.
Mollie
Mollie supports European payment methods including iDEAL, SEPA Direct Debit, Bancontact, and more. Mollie calls your webhook automatically when a payment status changes - no manual configuration needed on their end for most methods.
Setup Steps
- Go to Mollie Dashboard → Developers → API keys.
- Copy a Live API key (or test key for testing). Mollie API keys start with
live_ortest_. - Paste it into the API key field in Eventonomy → Settings → Money → Payments.
- Copy the Webhook URL shown in the panel.
- Mollie auto-detects the webhook for most payment methods. For explicit setup, add the URL under your Mollie account's webhook settings.
- Save changes.
WooCommerce
The WooCommerce gateway passes the order to your existing WooCommerce installation and uses whatever payment methods you have configured there.
Requirements
- WooCommerce must be installed and activated.
- At least one WooCommerce payment method must be enabled.
Setup Steps
- Select WooCommerce from the Active gateway dropdown.
- No API keys are needed - WooCommerce handles all credential management.
- Save changes.
Note: Order management (refunds, receipts) for WooCommerce orders happens in WooCommerce → Orders, not in Eventonomy → Attendees & Orders.
About Webhook URLs
Each gateway uses a webhook URL to confirm that a payment was completed server-side. Eventonomy generates a unique, HMAC-authenticated webhook URL for each gateway:
https://yoursite.com/wp-json/eventonomy/v1/payments/{gateway}/webhook?wht={token}
The wht parameter is an HMAC token derived from your site's secret keys. You must paste this URL into your gateway dashboard so the gateway can call it when a payment succeeds.
If you change the active gateway, the old webhook URL stops working. Update your gateway dashboard to use the new URL.
Switching the Active Gateway
You can change the active gateway at any time from the Active gateway dropdown. Existing completed orders retain their original gateway's transaction IDs. In-flight orders (started but not yet completed) may fail if the gateway changes mid-checkout.
What's Next?
Configure taxes, booking fees, and coupon codes.