Integrarea POS: beneficiu înainte de plată
Folosește acest flux când POS-ul aplică reducerea sau consumă puncte înainte să încaseze plata. Cere permisiunea checkouts:write și autorizează explicit operațiunile financiare în cabinet.
| Asociere în cabinet | Valoarea din sistemul tău |
|---|---|
| source | Identificator stabil al integrării, de exemplu my_pos. |
| accountId | Identificatorul comerciantului sau contului POS. |
| externalLocationId | Identificatorul magazinului în POS. |
| locationId | UUID-ul locației corespunzătoare din Mereu. |
| eligiblePolicy | Folosește paid_excluding_tips_surcharges. |
Această asociere leagă referințele documentelor; nu oferă acces Mereu la contul unui furnizor POS. Păstrează aceleași valori după rotația cheii.
- Calculează beneficiul cu
POST /checkouts/preview. Trimite sumele șireward.mode:none,pointssauvisit_reward. Pentrupoints, valoarea este un șir zecimal, de exemplu10.25. - Citește
discountșiexpected_paid_totaldin ofertă. Oferta este valabilă 120 secunde. Nu recalcula aceste valori în POS. - Rezervă beneficiul cu
POST /checkouts, folosindquote_idși referința stabilă a vânzării. - Trimite
POST /checkouts/{id}/payment-startedcuexpected_revisiondin rezervare și așteaptă succesul. - Abia acum aplică beneficiul și încasează plata în POS-ul sau sistemul tău de plăți.
- După verificarea încasării, confirmă prin
POST /checkouts/{id}/commit. Folosește revizia dinpayment-started, suma reală egală cuexpected_paid_total, ora plății și referința sa. Salveazătransaction_id.
Un card poate avea o singură rezervare, comună cu Casa. Rezervarea pentru care plata nu a început expiră după 10 minute. Pentru a afla starea, citește GET /checkouts/{id}.
Dacă plata nu a avut loc, anularea cere revizia curentă și un motiv. După ce plata ar fi putut începe, payment_not_completed:true este o confirmare explicită de neplată, nu o presupunere după timeout.