Skip to content

Payment states

stateDiagram-v2
  [*] --> Processing: Guest presses Pay
  Processing --> Paid: Provider confirms
  Processing --> Failed: Declined or cancelled
  Processing --> Unknown: No answer from the provider
  Unknown --> Paid: Provider confirms later
  Unknown --> Failed: Provider confirms failure
  Failed --> AutoRefund: Provider later reports it was charged
  AutoRefund --> [*]: Money returned automatically
  Paid --> RecordedInPOS: Payment written to the POS
  Paid --> StaffAlert: POS write fails
  StaffAlert --> RecordedInPOS: Retried, or finished by staff
  RecordedInPOS --> [*]
  Failed --> [*]: Guest can try again

Card charged, recorded in the POS, and money settled are tracked separately. A payment can be charged but not yet in the POS, or in the POS but not yet settled. The admin console shows every payment against all three.

Track Done when
Charged The payment provider sends a signed confirmation
Recorded in the POS The POS accepts the payment on the check
Settled The restaurant receives the money from the provider (see payouts)

A redirect back from the payment page, or a wallet animation, never marks a payment as paid. Only a confirmation the payment provider signed counts. A webhook from the provider only wakes 4u Check to check the payment again; it does not carry the result on its own.

If the payment is charged but cannot be written to the POS, the guest is done and sees “Paid”. Staff get a “paid but not in the POS” alert that links to the table, and the worker keeps retrying. With a POS that cannot accept a partner’s payment on an open check, such as Foodics, the cashier closes the check with the “4u Check” payment method and 4u Check checks the amount.

If the provider confirms a charge after the guest was shown “failed” (for example after a timeout), 4u Check refunds it automatically. The guest is never left paying twice for one share.