Paiement en un clic depuis le QR menu via iyzico Inline Checkout

Un steakhouse de 45 tables à Ankara Çankaya voulait éliminer les 7-9 minutes mortes entre "l'addition" et la sortie du client. L'objectif n'était pas seulement la vitesse mais la génération automatique de factures conformes à la réglementation turque avec séparation TVA.

Pourquoi Inline Checkout ? 3DS v2 et périmètre PCI

Inline Checkout garde le formulaire dans un iframe iyzico — votre serveur ne touche jamais au PAN. Vous tombez en PCI DSS SAQ-A : coût d'audit annuel d'environ 2 500-4 000 USD évité. 3DS v2 s'active automatiquement, flux frictionless dans 78% des transactions.

Architecture : le client tape "Payer" → POST vers /api/payments/initialize → backend récupère checkoutFormContent → l'iframe s'ouvre.

Idempotence webhook

iyzico envoie le webhook 3-7 fois pour le même paymentId. Solution : contrainte UNIQUE sur paymentId. Sur duplicate (23505), 200 no-op.

• Vérif signature : HMAC-SHA256 avec secret marchand.
• Fenêtre replay : 5 minutes.
• Mapping statut : SUCCESS → paid ; FAILURE → réessayable.

Facture TVA séparée (nourriture 10%, alcool 20%)

La réglementation turque exige des lignes séparées : nourriture TVA 10%, alcool TVA 20%. Une facture de 480 TL se répartit en 320 TL nourriture (29,09 TL TVA) et 160 TL alcool (26,67 TL TVA). Génération PDF avec @react-pdf/renderer, conforme e-Arşiv.

FAQ

Combien iyzico prend de commission ? Taux standard 2,49% + 0,25 TL/transaction ; négociable à 1,99% au-delà de 100K TL/mois.

Le stockage de carte est-il sécurisé ? iyzico retourne cardUserKey/cardToken — pas de PAN chez le marchand, hors PCI.

Vitesse des remboursements ? Le jour même : immédiat ; après T+1 : 2-7 jours ouvrés.

Cet article vous a été utile ? Partagez-le.