Deposits and advance payments

Updated on Wednesday 09 September 2026

How to charge a deposit or the full amount at booking time with tpago, what the customer sees, and what stays on you.

If your business suffers from frequent no-shows (customers who book and never turn up) or offers expensive services where a no-show hurts, you can require a deposit up front. The customer pays online, and the payment confirms the booking automatically.

When to turn deposits on

Symptom Action
More than 10% of bookings don’t show up Turn deposits on
Your services cost PYG 200,000+ and a no-show costs you the day Turn deposits on
You get fake or very impulsive bookings Turn deposits on
A customer tells you “I wasn’t sure I could make it” after not showing Turn deposits on
Symptom Don’t turn them on
Low no-show volume (under 5%) The friction of online payment isn’t worth it
A new business with no reputation Customers may not trust paying you online yet
Very cheap services where the deposit is PYG 5,000 Too much friction for too little

tpago is the only way to collect

To collect online you need three things:

  1. The tpago add-on active on your account. If the credentials form is greyed out with an amber notice, that’s what’s missing — get in touch and we’ll enable it.
  2. A Bancard/tpago merchant account with your credentials.
  3. The “Accept online payments” checkbox ticked in Settings.

Setting up tpago

Go to Online payments (tpago) in the dashboard menu:

  1. Enter the four credentials Bancard/tpago gave you: public key, private key, commerce code and branch code.
  2. Copy the payment confirmation (callback) URL the screen shows and register it in the tpago panel. Without that step, payments are charged but the booking never confirms itself.
  3. Save and click Test connection: it validates your credentials against tpago without saving them. Not required, but worth doing.

There is also a sandbox mode for testing without moving real money.

No Bancard merchant account yet?

You can apply with the Bancard adhesion form: fill it in online, download the PDF and send it to your Bancard contact, noting that it’s to integrate with Citauno. Since Citauno is already integrated with Bancard’s platform, mentioning it speeds up onboarding.

Until you have tpago, leave “Accept online payments” off and use the Manual confirmation mode: the booking comes in pending, you arrange the deposit by transfer, and you confirm it by hand from the dashboard. It’s more work, but it works from day one.

Turning advance payment on

Confirmation mode selector in the business settings

Two different things live on the same Settings screen, and they’re often confused:

  • The Confirmation mode (Auto / Manual / Deposit required), which decides whether a booking comes in confirmed or pending.
  • The “Online payments (deposit / prepay)” section, which is what actually defines how much money is charged at booking time.

The second one is what makes the pay button appear. In Settings, section “Online payments (deposit / prepay)”:

  1. Tick “Accept online payments”.
  2. Under “What to charge at booking”, pick one of the four options:
Option What happens
Optional The customer may pay, but the booking doesn’t depend on it.
Deposit: a percentage of the total Charges that % of the total. You set the percentage next to it.
Deposit: a fixed amount Always charges the same amount, never exceeding the booking total.
Full payment to confirm The customer pays everything at booking time.
  1. Save.

A different deposit per service

Each service’s form has a “Deposit for this service” block with four options: Use business setting (the normal one), Percentage of the price, Fixed amount and No deposit.

It covers the common case: a general policy of “Optional”, with a mandatory deposit only on the two or three expensive services. If a booking mixes services, each line contributes its own share and the total deposit is the sum.

What the customer sees

  1. They book normally (service → professional → time → details).
  2. On the confirmation screen a green box appears with the amount and the pay buttons:
    • If there’s a deposit and it’s less than the total, they see two buttons: “Pay deposit PYG 45,000” and “Pay in full PYG 150,000”.
    • If the policy is full payment, they see a single button for the total.
  3. They tap it and go to tpago’s checkout.
  4. They pay by card.
  5. tpago notifies Citauno, the booking flips to confirmed on its own, and the customer gets the confirmation email.

That same payment box reappears on the booking’s detail page inside the customer’s account. If they’ve already paid the deposit, it reads “Your appointment is confirmed. You can pay the remaining Gs. 105.000 whenever you like”, with a single button for what’s left: “Pay Gs. 105.000” (amounts always render with the currency’s own format, whatever the interface language).

The payment confirms the booking even if your confirmation mode is manual: the payment is the confirmation.

What happens if they don’t pay

  • The booking stays pending.
  • It holds the slot on the calendar in the meantime.
  • It expires after 24 hours. If the deposit never arrives, Citauno rejects the booking itself, releases the slot and emails the customer.

You can still release one yourself before the 24 hours are up:

  1. Review the pending ones under Bookings (or on the calendar).
  2. Reject or cancel the ones that weren’t paid.
  3. The slot is freed and the customer gets the cancellation email.

Cancellations and refunds

What you do today to return a deposit:

  1. Cancel the booking in Citauno (to free the slot and notify the customer).
  2. Issue the refund out of band: from your Bancard/tpago panel, or by bank transfer to the customer.
  3. Note what you returned wherever you keep your books. In Citauno the payment will keep showing as collected, because that’s what happened on your side.

Since there’s no automatic refund, your cancellation policy is what sets expectations. Write it in Settings, in the Cancellation policy field: it’s free text the customer reads in two places — on your public page, in the “Cancellation policy” card in the side column, and when cancelling from the email link, inside the amber box of the confirmation dialog. It does not appear in the booking summary. Be plain about it, for example: “Cancel more than 4 hours ahead and we’ll refund your deposit by transfer within 48 hours. Under 4 hours, the deposit is not refunded.”

The balance they pay on arrival

When the customer has paid only the deposit, a balance stays open.

  • The customer can pay the balance online with the same button, from their booking detail.
  • If they pay you in cash or by card at the counter, there is no “mark balance as paid” action in Citauno. The booking will keep showing the balance open.

What you do today to record a cash payment:

  • If you have the invoicing / POS module, you issue the receipt for the balance with its payment method (cash, transfer, card), and that document stays linked to the customer.
  • If you don’t, you record it wherever you keep your till. Citauno only records payments that went through tpago.

Where to see the money

Screen What it shows
Payments (dashboard menu) Every payment with date, booking, provider, kind (deposit / full / balance), amount and status. This is the list you reconcile against your tpago statement.
Analytics The “Deposits collected” card with the total deposits taken in the selected period.

The statuses you’ll see on a payment are: pending, authorized, paid, failed and cancelled.

Fees

Bancard/tpago charges a per-transaction fee according to your merchant contract — check with them, because it varies by industry and volume. Citauno adds no fee of its own on top of what your customers pay: the money settles directly into your tpago account.

Common problems

Symptom Cause Fix
The customer pays but the booking doesn’t confirm The callback URL is missing in the tpago panel, or tpago couldn’t reach it Check the URL under Online payments (tpago); the payment shows under Payments, so confirm the booking by hand in the meantime
No pay button appears on the booking Missing tpago add-on, missing credentials, or “Accept online payments” is off Review the three requirements above
The tpago form is greyed out The tpago add-on isn’t active Get in touch and we’ll enable it
I cancelled a paid booking and the customer got no money back There is no automatic refund Refund it from Bancard/tpago or by transfer
The customer paid twice They retried and both attempts settled Both show under Payments; refund the surplus out of band
The balance still shows even though they paid cash There’s no action to mark a balance as paid Record it in your invoicing or your till

Good practices

  1. Start with a small deposit: 20-30% is standard. Asking for 100% up front hurts conversion.
  2. Write your cancellation policy before turning deposits on, and be specific about how and when you refund.
  3. Review pending bookings daily: that’s what stops an unpaid booking from blocking a slot.
  4. Warn your regulars before you start asking for deposits.
  5. Reconcile weekly: the Payments screen against your tpago statement.

What you’ve got now

  • tpago configured, tested, and with its callback URL registered.
  • Your charging policy defined at the business level and, if needed, per service.
  • Clarity on what Citauno does by itself (collect and confirm) and what stays on you (refunds, cash balances, clearing pending bookings).

What this guide closes

That completes Citauno’s advanced workflows. For the exhaustive detail of every form and option, head to the Reference guide.