Fooodo / Dokumentacija

Mokėjimai

Kaip mokėjimai juda per Fooodo — palaikomi metodai ir valiutos, Mollie veikimas, arbatpinigių ir aukų maršrutizavimas, mokėjimų būsenų mašina ir webhook suderinimas.

Auto-translated · pending native review. The English version is canonical.

Fooodo mokėjimų apdorojimą išskiria į atskirą paslaugą. Svečiui skirta meniu programa perduoda užklausas jai; mokėjimų paslauga valdo Mollie integraciją, PCI apimtį ir webhook suderinimą.

Palaikomi metodai

Šiuo metu gamyboje:

  • Kortelė (Visa, Mastercard) ir ES banko tiesioginis debetas
  • Apple Pay
  • Google Pay
  • Trustly — tiesioginis mokėjimas per internetinę bankininkystę, pirmiausia skirtas Šiaurės ir Baltijos rinkoms, kuriose banko programėlės autentifikavimas yra numatytasis vartotojų srautas

Visas Mollie metodų katalogas yra techniškai prieinamas per tą pačią integraciją; tik aukščiau nurodyti metodai yra sujungti su gamybos atsiskaitymo keliu. Papildomus metodus (pvz., iDEAL, Bancontact) galima įjungti kiekvienam diegimui atskirai.

Grynaisiais pinigais mokama atskiru srautu: padavėjas paima grynuosius prie stalo ir tiesiogiai Fooodo administravimo sąsajoje pažymi užsakymą kaip apmokėtą. Pats užsakymas juda per tą pačią būsenų mašiną; tik Mollie mokėjimo kūrimo žingsnis yra praleidžiamas.

Palaikomos valiutos

Fooodo kiekvieną užsakymą atsiskaito ta valiuta, kuri sukonfigūruota restoranui. Mollie palaiko daugiau nei 30 valiutų; praktinis sąrašas rinkoms, kurioms Fooodo šiandien tarnauja:

RegionasValiutos
Euro zonaEUR
Jungtinė KaralystėGBP
Rytų Europa (ne euro zona)PLN (Lenkija), CZK (Čekija), HUF (Vengrija), RON (Rumunija), BGN (Bulgarija)
Šiaurės šalysDKK, NOK, SEK
KitaCHF, USD

Visas Mollie katalogas (31 valiuta, įskaitant AUD, CAD, JPY, ZAR) yra techniškai prieinamas; ne kiekvienas mokėjimo metodas apima kiekvieną valiutą. EUR ir pagrindiniai kortelių tinklai (Visa, Mastercard) veikia visur; metodo ir valiutos suderinamumas galutinai nustatomas diegimo metu ne euro zonos diegimams.

Konkrečiai Rumunijos diegimams RON palaikomas kortelių mokėjimais nuo pradžios iki pabaigos; Apple Pay ir Google Pay taip pat priima RON korteles.

Mokėjimo gyvavimo ciklas

Menu appPayment serviceMollieGuest
01Create payment for order
02Build payload (tips · donations) and create payment
03Return checkout URL
04Pass checkout URL through
05Redirect guest to Mollie checkout
06Complete payment
07Webhook callback (payment ID only)
08Fetch authoritative status
09Notify status (queued, signed)
10Show success / cancel page
Payment lifecycle · sequence

Konvejeris yra webhook valdomas ir idempotentinis. Mollie gali pakartotinai siųsti webhooks laikinos klaidos atveju; pakartotiniai paleidimai yra saugūs — paslauga trumpina grandinę, jei mokėjimo būsena nepasikeitė nuo paskutinio paleidimo.

Mokėjimų būsenos

Mokėjimų paslauga stebi savo būsenų mašiną, lygiagrečią užsakymų būsenų mašinai meniu programoje:

BūsenaKą tai reiškia
OpenSukurta, laukiama Mollie atsakymo
PendingMollie priėmė, laukiama svečio
AuthorizedAutorizuota, bet dar neužfiksuota
PaidUžfiksuota ir galutinė
FailedGalutinė klaida
CancelledSvečias atšaukė
ExpiredMollie mokėjimo laikas baigėsi

Cancelled ir Expired yra atstatomi — svečias gali bandyti dar kartą su tuo pačiu užsakymu, o tai sukuria naują mokėjimo bandymą tam pačiam užsakymui.

Arbatpinigiai

Arbatpinigiai įtraukiami į vieną Mollie mokestį kartu su užsakymu — svečiai niekada nemato antro atsiskaitymo už arbatpinigius. Mokėjimui nusistovėjus, arbatpinigiai POS sistemoje patenka kaip atskira arbatpinigių eilutė užsakyme, kad ataskaitos ir arbatpinigių paskirstymo srautai veiktų kaip visada. POS pajamų kodas, naudojamas arbatpinigių pajamoms atvaizduoti, nustatomas kiekvienam restoranui atskirai administravimo sąsajoje (R-Keeper yra aktyvus etaloninis jungtis šiam tikslui; kiti POS jungtys tą pačią nustatymą atskleidžia per jungties sutartį).

Aukos

Aukos veikia taip pat: vienas Mollie mokestis svečiui, tačiau aukos dalis nukreipiama į atskirą organizacijos sąskaitą Mollie sistemoje (Raudonasis Kryžius yra aktyvus etaloninis pavyzdys). Svečio požiūriu tai yra viena operacija; operatoriaus požiūriu auka neatsiranda restorano pajamose ar POS pardavimų ataskaitose — ji tvarkingai patenka į partnerio organizacijos apskaitą.

Webhooks

Dalyvauja du webhooks:

  • Mollie → mokėjimų paslauga. Viešas galinis taškas, gaunantis tik Mollie mokėjimo ID. Tada paslauga kviečia Mollie API, kad gautų autoritetingą būseną — taigi suklastotas atgalinis iškvietimas negali perkelti pinigų ar pakeisti užsakymo būsenos. (Tai yra standartinis Mollie integracijos šablonas; jų atgaliniai iškvietimai yra sąmoningai minimalūs.)
  • Mokėjimų paslauga → meniu programa. Autentifikuota nešiklio prieigos raktu, kiekvienam diegimui skirtu slaptu raktu. Tai yra kanalas, kuris iš tikrųjų pakeičia užsakymo būseną meniu programos pusėje.

Jei valdote Fooodo diegimą, meniu programos slaptasis raktas suteikiamas diegimo metu. Jei integruojatės su Fooodo kaip partneris, paprastai nematysite nė vieno iš šių.

Ką mato partneriai

Partnerių integruotojai tiesiogiai nesąveikauja su mokėjimų paslauga. Sutartis yra tokia:

  • Jūs kviečiate meniu programos užsakymų kūrimo API.
  • Gaunate užsakymą ir (kai reikalingas mokėjimas) atsiskaitymo URL.
  • Jūs netvarkote kortelių duomenų, nekviečiate Mollie, jums nereikia PCI apimties.

Tai yra viena iš pagrindinių priežasčių, kodėl mokėjimų paslauga egzistuoja kaip atskira riba.

Grąžinimai ir atšaukimai

Grąžinimai nėra Fooodo funkcija: meniu programoje ar mokėjimų paslaugos administravimo sąsajoje nėra grąžinimo veiksmo. Grąžinimas išduodamas tiesiogiai Mollie valdymo skydelyje pagal pradinį mokėjimą, o užsakymas atšaukiamas POS sistemoje kaip visada. Svečiai negali prašyti grąžinimo per programą.

Šiame puslapyje