Fooodo / Dokumentācija

Maksājumi

Kā maksājumi plūst caur Fooodo — atbalstītās metodes un valūtas, Mollie zem pārsega, dzeramnaudas un ziedojumu maršrutēšana, maksājumu stāvokļu automāts un vebhāku saskaņošana.

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

Fooodo maksājumu apstrādi nodalījis atsevišķā servisā. Klientam redzamā izvēlnes lietotne pārsūta pieprasījumus uz to; maksājumu serviss pārvalda Mollie integrāciju, PCI tvērumu un vebhāku saskaņošanu.

Atbalstītās metodes

Šobrīd ražošanas vidē:

  • Karte (Visa, Mastercard) un ES bankas tiešais debets
  • Apple Pay
  • Google Pay
  • Trustly — tiešais maksājums caur internetbanku, galvenokārt Ziemeļvalstu un Baltijas tirgiem, kur bankas lietotnes autentifikācija ir noklusējuma patērētāju plūsma

Mollie pilnais metožu katalogs ir tehniski pieejams caur to pašu integrāciju; tikai iepriekš minētās metodes ir ieviestas ražošanas norēķinu ceļā. Papildu metodes (piemēram, iDEAL, Bancontact) var iespējot katram izvietojumam atsevišķi.

Skaidra nauda tiek atbalstīta kā atsevišķa plūsma: viesmīlis pieņem skaidru naudu pie galda un tieši Fooodo administrācijā atzīmē pasūtījumu kā apmaksātu. Pats pasūtījums plūst caur to pašu stāvokļu automātu; tikai Mollie maksājuma izveides solis tiek izlaists.

Atbalstītās valūtas

Fooodo katru pasūtījumu norēķina restorānam konfigurētajā valūtā. Mollie atbalsta vairāk nekā 30 valūtas; praktiskais saraksts tirgiem, kurus Fooodo šobrīd apkalpo:

ReģionsValūtas
Eirozonas valstisEUR
LielbritānijaGBP
Austrumeiropa (ārpus eiro)PLN (Polija), CZK (Čehija), HUF (Ungārija), RON (Rumānija), BGN (Bulgārija)
ZiemeļvalstisDKK, NOK, SEK
CitasCHF, USD

Mollie pilnais katalogs (31 valūta, ieskaitot AUD, CAD, JPY, ZAR) ir tehniski pieejams; ne katra maksājumu metode aptver katru valūtu. EUR un galvenie karšu tīkli (Visa, Mastercard) darbojas visur; metožu un valūtu atbalsts tiek galīgi noteikts onboardinga laikā izvietojumiem ārpus eirozonas.

Rumānijas izvietojumiem konkrēti — RON tiek atbalstīts caur karšu maksājumiem no gala līdz galam; Apple Pay un Google Pay arī pieņem RON kartes.

Maksājuma dzīves cikls

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

Cauruļvads darbojas uz vebhāku pamata un ir idempotents. Mollie var atkārtoti nosūtīt vebhākus pārejošu kļūmju gadījumā; atkārtota atskaņošana ir droša — serviss īssavienojumu veic, ja maksājuma statuss nav mainījies kopš pēdējās izpildes.

Maksājumu stāvokļi

Maksājumu serviss uztur savu stāvokļu automātu, paralēli pasūtījumu stāvokļu automātam izvēlnes lietotnē:

StāvoklisNozīme
OpenIzveidots, gaida Mollie atbildi
PendingMollie ir pieņēmis, gaida viesi
AuthorizedAutorizēts, bet vēl nav iekasēts
PaidIekasēts un galīgs
FailedGalīga kļūme
CancelledViesis atcēla
ExpiredMollie maksājuma laiks beidzās

Cancelled un Expired ir atgūstami — viesis var mēģināt vēlreiz tajā pašā pasūtījumā, kas izveido jaunu maksājuma mēģinājumu pret to pašu pasūtījumu.

Dzeramnaudas

Dzeramnaudas tiek apvienotas vienā Mollie maksājumā kopā ar pasūtījumu — viesi nekad neredz otru norēķinu par dzeramnaudu. Pēc maksājuma nokārtošanas dzeramnaudas summa nonāk jūsu POS kā atsevišķa dzeramnaudas rinda pasūtījumā, lai pārskatu veidošana un dzeramnaudu izmaksas plūsmas darbotos kā ierasts. POS ieņēmumu kods, ko izmanto dzeramnaudas ienākumu attēlošanai, tiek iestatīts katram restorānam administrācijā (R-Keeper ir dzīvais atsauces savienotājs šim nolūkam; citi POS savienotāji atklāj to pašu iestatījumu caur savienotāja līgumu).

Ziedojumi

Ziedojumi darbojas tāpat: viens Mollie maksājums viesim, taču ziedojuma daļa tiek novirzīta uz atsevišķu organizācijas kontu Mollie ietvaros (Sarkanais Krusts ir dzīvais atsauces piemērs). No viesa skatpunkta tā ir viena transakcija; no operatora skatpunkta ziedojums neparādās restorāna ieņēmumos vai jūsu POS pārdošanas pārskatos — tas nonāk partnera organizācijas grāmatvedībā.

Vebhāki

Ir iesaistīti divi vebhāki:

  • Mollie → maksājumu serviss. Publisks galapunkts, kas saņem tikai Mollie maksājuma ID. Pēc tam serviss izsauc Mollie API, lai iegūtu autoritatīvo statusu — tādējādi viltots atzvans nevar pārvietot naudu vai mainīt pasūtījuma stāvokli. (Šis ir standarta Mollie integrācijas modelis; viņu atzvani ir apzināti minimāli.)
  • Maksājumu serviss → izvēlnes lietotne. Autentificēts ar nesēja marķieri, katram izvietojumam atsevišķs noslēpums. Šis ir kanāls, kas faktiski maina pasūtījuma stāvokli izvēlnes lietotnes pusē.

Ja jūs pārvaldāt Fooodo izvietojumu, izvēlnes lietotnes noslēpums tiek nodrošināts onboardinga laikā. Ja jūs integrējaties ar Fooodo kā partneris, parasti jūs neredzēsiet nevienu no šiem.

Ko redz partneri

Partneru integrētāji neintegrējas tieši ar maksājumu servisu. Līgums ir šāds:

  • Jūs izsaucat izvēlnes lietotnes pasūtījumu izveides API.
  • Jūs saņemat pasūtījumu un (ja nepieciešams maksājums) norēķinu URL.
  • Jūs neapstrādājat karšu datus, neizsaucat Mollie, jums nav nepieciešams PCI tvērums.

Tas ir viens no galvenajiem iemesliem, kāpēc maksājumu serviss pastāv kā atsevišķa robeža.

Atmaksas un atcelšanas

Atmaksas ir operatora darbība — viesi nevar tās pieprasīt no lietotnes. Atkarībā no jūsu izvietojuma atmaksas tiek izsniegtas no Mollie vadības paneļa vai maksājumu servisa administrācijas paneļa. Šobrīd nav klientam pieejamas atmaksas plūsmas.

Šajā lapā