Module · Payments

ExpertPress Payments

ExpertPress Payments is the money module for ExpertPress. It replaces manual payment (the client pays using the instructions in the booking, and payment is marked by hand) with online payment on the site: after the specialist confirms a booking, the client pays through a payment provider, the platform keeps its fee, and the specialist's share is paid out after the session. Refunds, receipts, special commission rates and the full money journal are handled in the same place.

Key capabilities:

  • Online payment after confirmation. The client pays on the booking page only after the specialist has accepted the request, before the payment deadline. If the deadline passes, the booking is cancelled and the time is released.
  • Several payment methods. Turn on one or more providers (built-in test bank, monobank, Stripe in test mode) and choose the order in which clients see them.
  • Automatic refund rules. A full refund when the client cancels early enough; when the specialist cancels late, the client can move the payment to another time or ask for a refund, and is refunded automatically if they do nothing.
  • Manual and partial refunds by staff, with the split between specialist and platform shown before confirming.
  • Platform fee and special rates. One platform fee for the whole site, plus individual rates per specialist with an optional end date.
  • Weekly payouts to specialists. Balances, holds while a complaint or confirmation is open, payout requests, accountant review of payout details, bank or manual transfers, reversals and debts.
  • Receipts. A payment receipt and a refund receipt for each booking, from a test cash register or a connected cash-register service (Checkbox).
  • Money journal and reports. Every payment, refund, fee and payout is posted to a journal, with CSV exports, a monthly statement per specialist and an accounting export.
  • Test mode first. The built-in test bank and test cash register let you try the whole flow without moving any money.

On this page


Requirements

Software

Requirement Value
ExpertPress core plugin Required and active (Requires Plugins: expertpress). WordPress will not activate the module without it.
WordPress 6.0 or later (Requires at least: 6.0).
PHP 7.4 or later (Requires PHP: 7.4).
Database The WordPress options table and the money tables must use the InnoDB engine. The readiness check refuses to enable online payments otherwise.
Site configuration Schema upgrades must be allowed, and WordPress must be able to create its maintenance file in the installation directory. Enabling online payments puts the site into maintenance for a few seconds per stage.

Payment providers and accounts

The module works with no outside account at all: the Test bank (Тестовий банк) and Test cash register (Тестова каса) run inside WordPress, send nothing out and charge no money. Use them to set up and try the site.

For anything beyond testing you need accounts with outside services. Their keys are never typed into the admin screens; they are added as constants in wp-config.php (see Payment providers).

Service What it is used for Account needed Mode
Test bank Client payments, holds, refunds, split payments none test mode only
Virtual bank (test) Specialist payouts none test mode only
Test cash register Receipts (not fiscal) none test mode only
monobank internet acquiring Client payments and refunds, in UAH only a monobank merchant account and its API token test and live
Stripe Client payments, card holds, saved cards, refunds; specialist payouts as Stripe transfers (Stripe Connect) a Stripe account with test API keys and webhook endpoints; specialists complete Stripe verification test mode only in this version
Checkbox Fiscal receipts from the platform's cash register, or from each specialist's own cash register a Checkbox cashier login, cashier password and license key test and live
Manual payouts Specialist payouts made by your accountant in the bank, then recorded on the site your own bank account test and live

What needs real provider credentials

  • Live mode (real charges) is possible only with monobank as the payment method, Checkbox as the cash register (or each specialist's own cash register), and the live constants set. The test bank, the test cash register and Stripe are refused in live mode. In live mode, payouts that were set to the virtual bank switch to the manual path.
  • Stripe payouts need Stripe as a payment method, the Stripe keys, and a "Ready" payout route (the Stripe account's country and settlement currency must match your shop currency).
  • Bank split (the bank splits each payment between the specialist and the platform) works with the test bank, and with monobank in test mode. With a live monobank token it stays off until the bank confirms it.
  • Everything else (payouts through the virtual bank, refunds, rates, journal, reports, receipts from the test cash register) works with the test providers.

The module never gives tax or legal advice. Fields such as "Platform sole proprietor" or "Who issues the receipt" only record your own decisions; check them with your accountant and providers.


How the module changes the site

Installing and activating the plugin does not switch payments on. The site keeps manual payment (clients pay using the instructions in the booking; who receives the money is set under Settings → General → Manual payment) until an administrator enables online payments under ExpertPress → Online payments. See Enabling online payments.

After that:

The booking flow

The core flow stays the same: the client requests a time, the specialist accepts, the client pays, the session takes place, the client leaves a review. What changes is step 3 and everything that involves money. See The booking flow for the core steps.

Step Manual payment (core only) With ExpertPress Payments
Pay The client pays using the instructions in the booking; staff (or the specialist, when the payee is the specialist) clicks Mark as paid. The client pays on the booking page with Pay before the payment deadline. The paid state comes from the provider.
Cancel Refund questions are handled by the site team. Refunds follow the refund rules automatically (full refund, no refund, or the client's choice).
Complaint The team's decision is an instruction; refund questions are handled by the site team. The specialist's payout is held while a complaint is open; a refund decision moves the money.
After the session Nothing to do. The specialist's share joins their balance and is paid out on the weekly payout cycle.

Details: Payments in the booking flow.

The admin area

  • The core Complaints menu item is replaced by Money (Гроші), with nine tabs: payments and refunds, journal, payouts, unfinished operations, reports, rates, disputes (complaints), documents and settings. See Admin screens.
  • A new Online payments item appears in the System group for administrators.
  • The booking card under Bookings gets a Payment and refunds (Оплата і повернення) panel with refunds, receipts, complaints and bank fees.
  • Amounts appear on core screens (overview, bookings, complaints) for staff with money access.

The specialist cabinet

Specialists get a Finances (Фінанси) page at /specialist/finance/ with their balance, payout details, payout requests, payout history and a monthly report. See Refunds and payouts.


What each person sees

Client

  • On the booking page, a Payment (Оплата) block after the specialist accepts: the booking amount, the payment deadline, the refund rule with the exact time when the late-cancellation period starts, and a Pay (Оплатити) button. If several payment methods are on, the client first picks one under Payment method (Спосіб оплати).
  • In test mode: "Test payment — no money is charged", and a test bank page where the client (or you) choose the outcome.
  • After payment: a Receipt (Чек) link and, after a refund, a Refund receipt link.
  • If the specialist cancels late: Request a refund (Подати запит на повернення) and Move the payment to another time (Перенести оплату на інший час).

Specialist

  • On the booking page, the payment state of the booking and what happens to the client's money if they cancel.
  • The Finances page: available balance, amounts on hold and why, debt (if any), payout details for review, Request payout, payout history and the monthly report with CSV.
  • Their own commission rate, if a special rate is assigned.

Site owner and staff

  • Administrator: enables online payments, chooses providers, mode, currency, money scheme, cash register and payout method; sees which secret constants are set.
  • Manager: platform fee, refund hours, complaint deadlines, special rates, refunds, payouts.
  • Accountant: payments, journal, payouts, payout-detail review, reports and the accounting export; most technical settings are read-only.

Who can change which option is listed on each option in Settings. Roles are described in Roles and access.


More pages

Related core pages: ExpertPress documentation, Money section in the core, Booking times and rules, Complaints.