Module · Payments
Payments in the booking flow
This page shows what changes in a booking when online payments are on. The core steps (request, confirmation, session, completion, review) are described in The booking flow; here we cover only the money.
Bookings created while the site was on manual payment keep manual payment until they finish.
The Payment block
Every booking page (/booking/<id>/) gets a Payment (Оплата) block once the specialist has accepted the request. The client, the specialist and staff each see it with texts for their role. It shows:
- Booking amount:
( . If the client views the site in another display currency, an approximate amount follows: "… — approximate. Payment is charged in the booking currency; your card bank determines the final conversion.") - "Test payment — no money is charged" when the booking is paid through the test bank.
- The payment state (see the table below).
- The refund rule and the cancellation deadline (see Cancelling a paid booking).
- The payment deadline and the Pay button (client only).
- Receipt and Refund receipt links (client only) once they exist.
Payment states
| State | Meaning |
|---|---|
| Awaiting payment | Accepted by the specialist, waiting for the client to pay. |
| Paid | The provider confirmed the payment. |
| The payment deadline has passed | The client did not pay in time; the booking was cancelled. |
| Refunded | The whole amount was returned to the client. |
| Partially refunded | Part of the amount was returned. |
| Closed without payment | The booking ended before anything was paid. |
When the site uses card holds (see Settings without a field on the screen), further states appear, such as Awaiting the client card, Card saved, Money held on the card and The card hold failed — pay for the session.
Paying
- The specialist accepts the request. The client is asked to pay; in the core flow this is the Go to payment step.
- On the booking page the client sees "Pay by
to keep your booking. Otherwise the booking will be cancelled." The deadline comes from Maximum time to pay and the related shares under Booking times and rules. - If more than one payment method is on, the client chooses one under Payment method (Спосіб оплати). Methods appear in the order set on Money → Settings.
- The client clicks Pay (Оплатити) and is sent to the provider's payment page (or the test bank page). Card details are never entered on your site.
- After paying, the client returns to the booking page. The state changes to Paid when the provider confirms the payment, usually within seconds.
If the deadline passes without payment: "The payment deadline passed. The booking was cancelled; this time is no longer reserved."
Messages the client may see instead of the Pay button
| Message | Cause |
|---|---|
| Payment is off: the payment provider is not set up. | No payment method is ready for the current mode (for example keys are missing). |
| Live mode without a cash register: the payment was not started. | Live mode is on but receipts cannot be issued for this booking. |
| The previous attempt is still being processed by the bank. Try in a few minutes. | An earlier payment page is still open at the bank. The module never opens a second bank payment for the same booking while the first is unresolved. |
| The bank has already accepted this payment. Refresh the page. | The payment went through; the page has not caught up yet. |
| This payment method is not available. Choose another one. | The chosen method was turned off or is not ready. |
| The specialist has no recipient identifier for a split payment. | The bank split is on and the specialist has no receiver id. |
The test bank page
In test mode with the test bank, Pay opens a test page on your own site with "Test bank — no money is taken". Choose the outcome:
- Payment successful (Оплата успішна) — the booking becomes paid.
- The bank declined (Банк відмовив) — the payment fails; the client can try again before the deadline.
- The client closed the page (Клієнт закрив сторінку) — nothing happens; the client can try again.
- Other test outcomes (to check errors) — further cases, such as a delayed success or a repeated notification, for checking how the site recovers.
Only the client of the booking or an administrator can open this page.
After payment
- The client gets a payment receipt, linked as Receipt (Чек) on the booking page. With the test cash register it is a Test receipt marked "Not fiscal". If the receipt could not be issued, the client sees why, for example "Receipt issuing for this specialist is not connected yet."
- The specialist sees that the booking is paid and holds the session as usual.
- After the session and the confirmation steps (see Completing the session), the specialist's share joins their balance. See Refunds and payouts.
- The client can leave a review once the booking is complete and paid.
Group sessions
For group meetings, each participant pays for their own booking (price per seat times the number of seats). The staff view of the booking shows Price per seat and the rules frozen at booking time: a full refund when the participant cancels the set number of hours before the start, and no refund later. If the minimum number of participants is not reached a day before the start, nothing is cancelled automatically: the specialist gets an email and decides whether to hold the meeting or cancel it for everyone with a full refund, including the platform fee.
Cancelling a paid booking
Before paying, and on the paid booking, the client sees the refund rule with exact times, for example:
- "If you cancel less than 24 h before the start after payment is charged, your payment is not refunded."
- "The late cancellation period starts after
." - "The late cancellation period has already started for this booking."
The number of hours comes from Full refund if at least this many hours remain before the start and is fixed for each booking.
The specialist sees what will happen to the client's money before cancelling:
- "If you cancel this session, the client payment is refunded automatically." (early cancellation)
- "If you cancel this session, the client can request a refund or choose another time." (late cancellation)
What happens next is described in Refund rules.
When the specialist cancels late
If the specialist cancels a paid booking within the late-cancellation period, the client chooses what to do on the booking page:
- Request a refund (Подати запит на повернення): the full amount is refunded.
- Move the payment to another time (Перенести оплату на інший час): "Choose a free time for the same service. The specialist confirms the new request as usual; the payment from this booking moves to it without paying again." The client picks a New date and New time and clicks Send the request. "If the specialist declines or does not reply in time, we refund the full amount for this booking immediately. No need to pay again."
- Do nothing: "If you do not choose before
, we refund automatically." The waiting time is set by Late cancellation by the specialist.
While a move request waits for the specialist, the automatic refund is paused ("A request for a new time was sent (booking #N). Automatic refund is paused until the specialist replies."). The specialist sees "The client requested another time. Automatic refund is paused until you reply to the new request."
A payment can be moved only to the same service at the same price. If the service was changed, unpublished or its price differs, the client is asked to choose a refund instead.
After a successful move, the original booking says "Payment was moved to booking #N. No refund to your card was made." with an Open the new booking link.
Complaints
While a complaint about a paid booking is open, the specialist's payout for that booking is on hold. If the team decides on Partial refund or Full refund, the money is returned to the client through the same provider. See Complaints.