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
Three separate tracks
Section titled “Three separate tracks”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) |
Only signed messages count
Section titled “Only signed messages count”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.
When the POS cannot take the payment
Section titled “When the POS cannot take the payment”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.
Late confirmations
Section titled “Late confirmations”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.

