Essensgutscheine (Multinet, Sodexo, Edenred) im QR-Menü-Checkout integrieren

In einem Mittags-Café im Bürobezirk Çayyolu in Ankara tragen sechzig Prozent der Gäste eine Multinet-, Sodexo- oder Edenred-Karte. Ohne Voucher-Option fällt der Durchschnittsbon von vierundneunzig auf achtundsechzig Lira — die richtige Integration stoppt diesen Einbruch mit einem POST.

Multinet POS API und voucher_code-Flow

Multinet bietet einen separaten Endpoint mit voucher_code-Feld statt klassischer card_present-Transaktion. Der Gast gibt im Checkout die letzten sechs Kartenstellen und den SMS-Code ein; POST /v2/voucher/authorize liefert in fünf Sekunden Saldo und Genehmigung.

Wichtig: Teilgenehmigung wird unterstützt. Bei 120 Lira Beleg und 80 Lira Saldo gibt das System approved_amount: 80 zurück; die fehlenden 40 Lira leiten Sie auf der gleichen Checkout-Seite an die zweite Zahlart weiter.

Sodexo Restaurant Pass PNR-Format

Sodexo Türkei verwendet ein sechsstelliges PNR-Format: die ersten drei Zeichen sind die Merchant-ID, die letzten drei die Tagessequenz. Webhook-Callback auf /api/sodexo/callback setzen und HMAC-SHA256-Signatur prüfen, bevor Sie die Transaktion schließen.

Edenred Ticket Restaurant nutzt dasselbe Muster, signiert aber mit RSA-PSS 2048-bit. Den Public Key aus dem Edenred-Portal ziehen und im Worker-KV mit 5-Minuten-TTL cachen.

Saldo-Check und UX bei Teilzahlung

Eine Anzeige "Saldo X TL, fehlend Y TL" innerhalb von 1,2 Sekunden hebt die Conversion um achtundzwanzig Prozent. In thMenu rufen Sie dies als Pre-Auth-Check auf; der Gast bestätigt die zweite Zahlart, bevor die Buchung schließt.

• Multinet: 750 Lira Tageslimit
• Sodexo: Wochenende kann pro Händler gesperrt sein
• Edenred: Refund-Fenster 48 Stunden

FAQ

Wie bekomme ich Multinet-API-Zugang? Händlerantrag, Steuerbescheinigung, Bankkonto — Freigabe 7-10 Werktage.

Kann ich alle drei Voucher im Checkout zeigen? Ja, als separate Einträge in thMenu payment_methods JSON.

Wie hoch sind die Gebühren? Multinet 4,5%, Sodexo 5%, Edenred 5,2% (2026-Standardsätze).

Hilfreich? Teilen Sie es.