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 vebhuku saskaņošana.

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

Fooodo maksājumu apstrādi nodala 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 vebhuku 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šs maksājums caur interneta banku, 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 atzīmē pasūtījumu kā apmaksātu tieši Fooodo administrācijā. Pats pasūtījums plūst caur to pašu stāvokļu automātu; tiek apiets tikai Mollie maksājuma izveides solis.

Atbalstītās valūtas

Fooodo norēķinās par katru pasūtījumu 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
CitiCHF, USD

Mollie pilnais katalogs (31 valūta, tostarp 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; metodes un valūtas atbalsts tiek galīgi noteikts ievadīšanas procesā 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 vebhuku pamata un ir idempotents. Mollie var atkārtoti nosūtīt vebhukus 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 termiņš 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 atskaites un dzeramnaudu izmaksas plūsmas darbotos kā vienmēr. POS ieņēmumu kods, ko izmanto dzeramnaudas ienākumu attēlošanai, tiek iestatīts katram restorānam administrācijā (R-Keeper ir aktī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 aktī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 atskaitēs — tas nonāk partnera organizācijas grāmatvedībā.

Vebhuki

Ir iesaistīti divi vebhuki:

  • 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 atsaukums nevar pārvietot naudu vai mainīt pasūtījuma stāvokli. (Šis ir standarta Mollie integrācijas modelis; viņu atsaukumi 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 ievadīšanas procesā. Ja jūs integrējaties ar Fooodo kā partneris, parasti jūs neredzēsiet nevienu no tiem.

Ko redz partneri

Partneru integrētāji netieši integrējas 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šana

Atmaksas nav Fooodo funkcija: izvēlnes lietotnē vai maksājumu servisa administrācijā nav atmaksas darbības. Atmaksa tiek veikta tieši Mollie vadības panelī pret sākotnējo maksājumu, un pasūtījums tiek atcelts POS kā vienmēr. Viesi nevar pieprasīt atmaksu no lietotnes.

Šajā lapā