Plăți

Fooodo separă procesarea plăților într-un serviciu dedicat. Aplicația de meniu orientată către client îi transmite solicitările prin proxy; serviciul de plăți deține integrarea Mollie, domeniul de aplicare PCI și reconcilierea webhook-urilor.

Metode acceptate

În producție în prezent:

• Card (Visa, Mastercard) și debit direct bancar european
• Apple Pay
• Google Pay
• Trustly — plată directă prin internet banking, în principal pentru piețele nordice și baltice unde autentificarea prin aplicația bancară este fluxul implicit al consumatorilor

Catalogul complet de metode al Mollie este disponibil tehnic prin aceeași integrare; doar metodele de mai sus sunt conectate la fluxul de checkout din producție. Metode suplimentare (de ex. iDEAL, Bancontact) pot fi activate per implementare.

Numerarul este acceptat ca flux separat: un chelner preia numerarul la masă și marchează comanda ca plătită direct în administrarea Fooodo. Comanda în sine parcurge aceeași mașină de stări; doar pasul de creare a plății Mollie este omis.

Valute acceptate

Fooodo decontează fiecare comandă în valuta configurată pentru restaurant. Mollie acceptă mai mult de 30 de valute; lista practică pentru piețele pe care Fooodo le deservește în prezent:

Catalogul complet al Mollie (31 de valute, inclusiv AUD, CAD, JPY, ZAR) este disponibil tehnic; nu orice metodă de plată acoperă orice valută. EUR și principalele rețele de carduri (Visa, Mastercard) funcționează peste tot; compatibilitatea metodă-valută este finalizată în timpul procesului de integrare pentru implementările din afara zonei Euro.

Pentru implementările din România în mod specific, RON este acceptat prin plăți cu cardul de la un capăt la altul; Apple Pay și Google Pay acceptă de asemenea carduri în RON.

Ciclul de viață al plății

Fluxul este condus de webhook-uri și este idempotent. Mollie poate retrimite webhook-uri în caz de eșecuri tranzitorii; reluările sunt sigure — serviciul scurtcircuitează dacă starea plății nu s-a schimbat față de ultima rulare.

Stările plății

Serviciul de plăți urmărește propria sa mașină de stări, paralelă cu mașina de stări a comenzilor din aplicația de meniu:

Cancelled și Expired sunt recuperabile — un oaspete poate reîncerca pe aceeași comandă, ceea ce creează o nouă tentativă de plată pentru aceeași comandă.

Bacșișuri

Bacșișurile sunt incluse într-o singură tranzacție Mollie alături de comandă — oaspeții nu văd niciodată un al doilea checkout pentru bacșiș. După decontarea plății, bacșișul apare în POS-ul tău ca o linie separată de bacșiș pe comandă, astfel încât fluxurile de raportare și distribuire a bacșișurilor funcționează ca întotdeauna. Codul de venit POS utilizat pentru a reprezenta veniturile din bacșișuri este setat per restaurant în administrare (R-Keeper este conectorul de referință activ pentru aceasta; ceilalți conectori POS expun aceeași setare prin contractul conectorului).

Donații

Donațiile funcționează în același mod: o singură tranzacție Mollie pentru oaspete, dar porțiunea de donație este rutată către un cont de organizație separat în Mollie (Crucea Roșie este exemplul de referință activ). Din perspectiva oaspetelui este o singură tranzacție; din perspectiva operatorului, donația nu apare în veniturile restaurantului sau în rapoartele de vânzări din POS — aceasta ajunge în mod curat în evidențele organizației partenere.

Webhook-uri

Sunt implicate două webhook-uri:

• Mollie → serviciul de plăți. Endpoint public care primește doar un ID de plată Mollie. Serviciul apelează apoi API-ul Mollie pentru a obține starea autoritativă — astfel un callback falsificat nu poate mișca bani sau schimba starea comenzii. (Acesta este modelul standard de integrare Mollie; callback-urile lor sunt în mod intenționat minimale.)
• Serviciul de plăți → aplicația de meniu. Autentificat cu token Bearer, secret per implementare. Acesta este canalul care schimbă efectiv starea comenzii în aplicația de meniu.

Dacă operați o implementare Fooodo, secretul aplicației de meniu este provizionat în timpul procesului de integrare. Dacă vă integrați cu Fooodo ca partener, în mod normal nu veți vedea niciunul dintre acestea.

Ce văd partenerii

Integratorii parteneri nu se integrează direct cu serviciul de plăți. Contractul este:

• Apelați API-ul de creare a comenzilor al aplicației de meniu.
• Primiți o comandă și (când plata este necesară) un URL de checkout.
• Nu gestionați date de card, nu apelați Mollie, nu aveți nevoie de domeniu de aplicare PCI.

Acesta este unul dintre motivele esențiale pentru care serviciul de plăți există ca o limită separată.

Rambursări și reversări

Rambursările sunt o acțiune a operatorului — oaspeții nu le pot solicita din aplicație. În funcție de implementarea ta, rambursările sunt emise din panoul de control Mollie sau din panoul de administrare al serviciului de plăți. Nu există un flux de rambursare orientat către client în prezent.