Cuprinsul documentației

Ghid de integrare

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 cabinetValoarea din sistemul tău
sourceIdentificator stabil al integrării, de exemplu my_pos.
accountIdIdentificatorul comerciantului sau contului POS.
externalLocationIdIdentificatorul magazinului în POS.
locationIdUUID-ul locației corespunzătoare din Mereu.
eligiblePolicyFoloseș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.

  1. Calculează beneficiul cu POST /checkouts/preview. Trimite sumele și reward.mode: none, points sau visit_reward. Pentru points, valoarea este un șir zecimal, de exemplu 10.25.
  2. Citește discount și expected_paid_total din ofertă. Oferta este valabilă 120 secunde. Nu recalcula aceste valori în POS.
  3. Rezervă beneficiul cu POST /checkouts, folosind quote_id și referința stabilă a vânzării.
  4. Trimite POST /checkouts/{id}/payment-started cu expected_revision din rezervare și așteaptă succesul.
  5. Abia acum aplică beneficiul și încasează plata în POS-ul sau sistemul tău de plăți.
  6. După verificarea încasării, confirmă prin POST /checkouts/{id}/commit. Folosește revizia din payment-started, suma reală egală cu expected_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.