Pago en un clic desde el menú QR vía iyzico Inline Checkout

Un asador de 45 mesas en Ankara Çankaya quería eliminar los 7-9 minutos muertos entre "la cuenta por favor" y la salida del cliente. El objetivo no era solo velocidad sino factura PDF con IVA separado según normativa turca.

¿Por qué Inline Checkout? 3DS v2 y alcance PCI

Inline Checkout mantiene el formulario en un iframe de iyzico — tu servidor nunca toca el PAN. Caes a PCI DSS SAQ-A: coste de auditoría anual de unos 2.500-4.000 USD evitado. 3DS v2 se activa automáticamente, frictionless en el 78% de transacciones.

Arquitectura: el cliente pulsa "Pagar" → POST a /api/payments/initialize → backend obtiene checkoutFormContent → se abre el iframe.

Idempotencia webhook

iyzico dispara webhooks 3-7 veces para el mismo paymentId. Solución: restricción UNIQUE sobre paymentId. En duplicado (23505) devuelve 200 no-op.

• Verificación firma: HMAC-SHA256 con secret merchant.
• Ventana replay: 5 minutos.
• Mapeo estado: SUCCESS → paid; FAILURE → reintentable.

Factura con IVA separado (comida 10%, alcohol 20%)

La normativa turca exige líneas separadas: comida IVA 10%, alcohol IVA 20%. Una factura de 480 TL se reparte en 320 TL comida (29,09 TL IVA) y 160 TL alcohol (26,67 TL IVA). PDF con @react-pdf/renderer, conforme e-Arşiv.

FAQ

¿Cuánto cobra iyzico de comisión? Tarifa estándar 2,49% + 0,25 TL/transacción; negociable a 1,99% por encima de 100K TL/mes.

¿Es seguro el almacenamiento de tarjeta? iyzico devuelve cardUserKey/cardToken — sin PAN en el merchant, fuera de PCI.

¿Velocidad de reembolsos? Mismo día: instantáneo; tras T+1: 2-7 días hábiles.

¿Te resultó útil? Compártelo.