Fooodo / Dokumentacija

Mokėjimai

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

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

Fooodo mokėjimų tvarkymą išskiria į atskirą paslaugą. Klientui skirta meniu programa perduoda užklausas jai; mokėjimo 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 šalių rinkoms, kuriose banko programėlės autentifikavimas yra numatytasis vartotojo srautas

Visas Mollie metodų katalogas techniškai pasiekiamas per tą pačią integraciją; tik aukščiau nurodyti metodai yra sujungti su gamybos atsiskaitymo keliu. Papildomi metodai (pvz., iDEAL, Bancontact) gali būti įjungti kiekvienam diegimui atskirai.

Grynieji pinigai palaikomi kaip atskiras srautas: 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 aplenkiamas.

Palaikomos valiutos

Fooodo kiekvieną užsakymą atsiskaito restorane sukonfigūruota valiuta. 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) techniškai pasiekiamas; 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

Vamzdynas yra webhook valdomas ir idempotentinis. Mollie gali pakartotinai siųsti webhook pranešimus esant laikiniems gedimams; pakartotiniai paleidimai yra saugūs — paslauga trumpina grandinę, jei mokėjimo būsena nepasikeitė nuo paskutinio paleidimo.

Mokėjimo būsenos

Mokėjimo 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 atkuriamos — 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 patenka į jūsų POS 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 aktyvi etaloninė jungtis šiam tikslui; kitos POS jungtys atskleidžia tą patį nustatymą 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 jūsų POS pardavimų ataskaitose — ji tvarkingai patenka į partnerio organizacijos apskaitą.

Webhook pranešimai

Dalyvauja du webhook pranešimai:

  • Mollie → mokėjimo paslauga. Viešas galinės taško adresas, 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 tyčia minimalūs.)
  • Mokėjimo 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š jų.

Ką mato partneriai

Partnerių integruotojai tiesiogiai neintegruojasi su mokėjimo 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ėjimo paslauga egzistuoja kaip atskira riba.

Grąžinimai ir atšaukimai

Grąžinimai yra operatoriaus veiksmas — svečiai negali jų prašyti iš programos. Priklausomai nuo jūsų diegimo, grąžinimai išduodami iš Mollie valdymo skydelio arba mokėjimo paslaugos administravimo skydelio. Šiandien nėra klientui skirto grąžinimo srauto.

Šiame puslapyje