Module · Payments
Enabling online payments
Where: ExpertPress → Online payments (in the System group of the ExpertPress admin menu). The plugin's Settings link on the WordPress Plugins screen opens the same page.
Who: WordPress administrators only (manage_options).
Activating the ExpertPress Payments plugin does not change how clients pay. Until you complete the steps on this page, the site stays on manual payment: clients pay using the instructions in the booking, and payment is marked manually (see The booking flow). The Manual payment block on Settings → General stays available until online payments are enabled.
Before you start
- Install and activate ExpertPress, then ExpertPress Payments.
- Finish or close bookings that are in the middle of a manual payment if you can. Bookings created before the switch keep manual payment (see the warning below).
- Make sure no other update or maintenance is running on the site.
- The first payment method is the built-in Test bank. Real providers are chosen after activation, on Money → Settings (see Payment providers).
The Readiness panel
The page opens with a Readiness panel. It lists what is already in order, for example:
- "Plugin files and transactional storage are ready. No unfinished money operations block activation."
- "No background actions are currently running."
- "Enabled payment methods have settings for the current mode and shop currency."
- "Money storage needs migration. Enabling payments creates or updates it and proves it before payments open." (or "Money storage is complete…")
A yellow warning may say "Bookings staying on manual payment: N. They keep direct payment and manual paid marks; refunds are handled outside the site." These bookings are not converted; they finish the manual way (refund questions stay with the site team).
Anything that blocks activation is listed under Before online payments can be enabled:. Common items and what to do:
| Message | What to do |
|---|---|
| The WordPress options table must use InnoDB for safe payment switching. / Money storage must use InnoDB: … | Ask your host to convert the tables to InnoDB. |
| Open bookings with online payments or conflicting manual payment data: N. Finish or reconcile them before enabling payments. | Finish or cancel those bookings first. |
| Unfinished money operations in …: N. Finish or reconcile them before enabling payments. | Wait for them to finish, or reconcile them. |
| N background actions are still running; nothing switched. | Wait a minute and press Refresh. |
| Schema upgrades are disabled in the site configuration. Allow them before enabling online payments. | Remove the setting that disables schema upgrades from wp-config.php. |
| WordPress maintenance is active. Wait until it finishes. | Wait for the running update to finish. |
| WordPress cannot create the maintenance file in its installation directory. | Make the WordPress directory writable for the web server. |
| Payment method …: no keys for the current mode. | Add the provider's constants to wp-config.php (see Payment providers), or turn that method off. |
| Another payment settings change is running, or the activation lock is unavailable. Refresh and try again. | Someone else is saving payment settings; try again shortly. |
Steps
- Click Enable online payments.
- Read the Confirm online payment activation panel. It explains that the site briefly enters maintenance during each stage, that the module takes over payments, creates or updates its money storage and checks the money engine before payments open, and that the test or live mode you configured is kept.
- Click Enable online payments again to start. The page continues through the remaining stages by itself.
- When it finishes you see "Online payments are enabled. Migration and the money engine check passed." and a Payment provider settings button that opens Money → Settings.
Each stage either completes or leaves payments closed with a message explaining why. If activation was interrupted (for example, the browser was closed), open the page again: it shows "If activation was interrupted, continue here. Completed stages are safe to repeat." and a Continue enabling payments button.
While activation is in progress, clients cannot pay: "Activation is in progress. Payments stay closed until migration and the engine check pass."
From the command line
Administrators with WP-CLI access can run the same steps:
wp expertpress payments-module preflightchecks readiness.wp expertpress payments-module enableruns all stages (option--wait=<seconds>, default 120, for running background actions).wp expertpress payments-module statusshows the current payment mode.
After activation
- Open Money → Settings and choose the mode, shop currency, payment methods, money scheme, cash register and payout method. See Settings.
- Make a test booking and pay it with the test bank (see Payments in the booking flow).
- When you are ready for real money, follow Going live.
Deactivating or deleting the plugin
- Deactivating stops the module's recurring background tasks.
- Deleting the plugin removes its code. Money tables, journal rows, money settings and per-payment scheduled steps are always kept. When delete data on plugin deletion is on in ExpertPress settings, the module also removes its own technical state (background-task positions, caches, notices and the accounting export permission).
- This page does not offer a way to switch a site back from online payments to manual payment.