Chapter 5 of 8Page 9 of 18

Daily use

Card and QR payments

How cashiers use Pay card for Stripe Terminal readers and QR Pay for Stripe QR payments on the tender screen, what a decline shows and where a payment goes.

updated: applies-to: 1.0.0.141

Bitta Retail POS takes electronic payments through Stripe in two ways: Pay card charges a card on a Stripe Terminal reader paired with the register, and QR Pay shows a Stripe Checkout QR code the customer pays on a phone. Every attempt is recorded as an EFT transaction in Business Central before the processor is called, so a payment interrupted by a closed browser is resolved instead of lost. A standalone card machine that is not connected to the register works too, through the Card (external card terminal) tender.

Prerequisites

  • The BAA POS - User permission set, a signed-in register and items in the cart.
  • An administrator has selected Stripe or Simulated as the EFT Provider, chosen the Integrated Card Tender Code, and, for Stripe, paired a reader in the terminal's EFT Terminal ID. QR Pay also needs QR Pay Enabled and a QR Pay Tender Method Code. See Stripe Terminal setup.
  • The demo company turns on the Simulated provider: it behaves like a reader that approves payments, with no hardware and no real charges. An administrator still sets Integrated Card Tender Code (and, for QR Pay, QR Pay Enabled and QR Pay Tender Method Code), for example to CARD, before Pay card and QR Pay appear. See Test with the Simulated provider.

Take a card payment

  1. Press Tender. When integrated card payments are set up for this terminal, Pay card appears on the tender screen; QR Pay appears when QR payments are set up.
Register tender screen with the Pay card and QR Pay buttons next to Add tender and OK
Step 1: Pay card and QR Pay appear on the tender screen when they are set up.
  1. Choose Pay card. The card charges the remaining balance, or the amount you typed on the keypad first. The Card Payment dialog opens with Follow the prompts on the card reader, the Amount and the Status, which reads "Waiting for the customer to tap or insert their card..." while the customer pays. The dialog checks the reader in the background, so the register never freezes.

  2. When the status reads "Approved - press Done to continue.", choose Done. The captured card line is booked on the sale. If it covered the balance, the sale completes and the register starts a new sale; otherwise the tender screen reopens for the rest.

NOTE

The dialog never closes on its own when the payment finishes. Done lights up and waits for you, so you always see the result before the register moves on.

Split with a card

Add the other tenders first, for example cash or On Account, then choose Pay card for the rest. Lines you have already added go to the server with the card request, and an on-account charge passes its credit check before the processor is called. A captured card line shows a lock on the tender screen and cannot be removed there.

Declined, cancelled or retried

  • Declined: the status reads "Declined - press Done to close." and Failure Message shows the processor's reason. Choose Done. The tender screen reopens with your other lines intact and the message "The external payment was not captured. The staged tender split is still available for review or retry."
  • Cancel: choose Cancel Payment while the payment is in progress to cancel it on the reader. Closing the dialog any other way while the payment is in progress also asks the reader to cancel.
  • Retry: choose Pay card again, or take another tender.
  • Resume payment: if a payment for this sale is still in progress from an earlier attempt, the tender screen shows Resume payment and locks the other controls until that payment is resumed or resolved.

When status checks keep failing, the dialog stops checking and shows a Recovery message instead. Choose Review Payment to open the exact transaction, and do not take another payment until it is reconciled.

Take a QR payment

  1. On the tender screen, choose QR Pay. The QR Payment dialog opens with "Ask the customer to scan and pay on their phone", the amount and a QR code for a Stripe Checkout payment page.
  2. The customer scans the code and pays. If the customer cannot scan, copy the Payment Link and send it to them.
  3. When the status reads "Paid - press Done to continue.", choose Done.

Cancel Payment expires the payment page so it can no longer be paid. Closing the dialog while the payment is still open expires it the same way, so an abandoned QR code cannot be paid later from the customer's phone history.

Standalone card terminals

The Card (external card terminal) tender is for a card machine that is not connected to Bitta Retail POS. Key the amount into the machine and take the payment there, then on the tender screen select Card (external card terminal) and choose Add tender with the same amount. The register records the tender for totals, shift counts and settlement but does not talk to the machine, so the two amounts must match.

If the browser closes during a payment

When a register opens, it first resolves every card or QR payment that terminal left in progress, before the cashier signs in. A payment the processor captured while the register was closed is captured and booked on its sale, a payment the sale no longer expects is voided, and anything that cannot be resolved is flagged for review. The cashier sees a short message such as "1 in-flight card payment(s) from an earlier session were resolved." or "Some card payments need attention - review the POS EFT Transactions page."

Supervisors and administrators follow up from the EFT Attention count on the role center or from POS EFT Transactions, where Reconcile Open Transactions re-checks every open payment that is not held by a register. A payment still held by a register is resolved by opening POS Register on that terminal.

POS EFT Transactions list with the Reconcile Open Transactions action in the Recovery group
Back office: reconcile card and QR payments left open by a closed session.

Card refunds

A card payment is never undone on the tender screen. Refund it with a return against the receipt: the refund is allocated to the original tenders, and an integrated card refund goes back through the same provider to the original charge, never for more than that charge across all returns. Starting a provider refund needs BAA POS - Supervisor or BAA POS - Admin. If the provider does not confirm a refund, the return waits in Refund Recovery. See Returns and refunds.

What's next

Charge a sale to a customer's account: On-account sales. To rehearse approvals, declines and recovery before go-live, use Test with the Simulated provider.

// next step

Ready to try Bitta Retail POS?