Yhden napsautuksen maksu QR-menulta iyzico Inline Checkoutilla

45 pöydän pihviravintola Ankaran Çankayassa halusi poistaa 7-9 minuutin kuolleen ajan "lasku kiitos" -hetkestä asiakkaan poistumiseen. Tavoitteena ei ollut vain nopeus vaan Turkin lainsäädännön mukaisten ALV-erotettujen laskut-PDF:ien automaattinen luonti.

Miksi Inline Checkout? 3DS v2 ja PCI-laajuus

Inline Checkout pitää korttilomakkeen iyzico-iframessa — palvelimesi ei koskaan käsittele PAN-numeroa. Putoat PCI DSS SAQ-A:han: vuosittainen tarkastus noin 2 500-4 000 USD säästyy. 3DS v2 käynnistyy automaattisesti, frictionless flow 78 %:ssa tapahtumista.

Arkkitehtuuri: asiakas napauttaa "Maksa" → POST osoitteeseen /api/payments/initialize → backend hakee checkoutFormContent → iframe avautuu.

Webhook-idempotenssi

iyzico lähettää webhookin 3-7 kertaa samalle paymentId:lle. Ratkaisu: UNIQUE-rajoite paymentId:lle. Kaksoiskappaleessa (23505) palauta 200 no-op.

• Allekirjoituksen vahvistus: HMAC-SHA256 merchant secretillä.
• Replay-ikkuna: 5 minuuttia.
• Statuskartoitus: SUCCESS → paid; FAILURE → uudelleenyritettävä.

ALV-erotettu lasku (ruoka 10 %, alkoholi 20 %)

Turkin lainsäädäntö vaatii erotellut rivit: ruoka ALV 10 %, alkoholi ALV 20 %. 480 TL:n lasku jakautuu 320 TL:n ruokaan (29,09 TL ALV) ja 160 TL:n alkoholiin (26,67 TL ALV). PDF kautta @react-pdf/renderer, e-Arşiv-yhteensopiva.

UKK

Mikä on iyzicon provisio? Vakio 2,49 % + 0,25 TL/tapahtuma; neuvoteltavissa 1,99 %:iin yli 100K TL/kk.

Onko korttitallennus turvallinen? iyzico palauttaa cardUserKey/cardToken — ei PAN-tietoa kauppiaalla, PCI-laajuuden ulkopuolella.

Palautusten nopeus? Samana päivänä: välitön; T+1 jälkeen: 2-7 arkipäivää.

Oliko tästä hyötyä? Jaa se.