食事券 (Multinet、Sodexo、Edenred) を QR メニュー決済に統合

アンカラ Çayyolu のオフィス街にあるランチカフェでは、客の六十パーセントが Multinet、Sodexo、Edenred のカードを所持している。食事券オプションがなければ平均客単価は九十四リラから六十八リラへ落ちる。正しい統合が一つの POST でこの下落を止める。

Multinet POS API と voucher_code フロー

Multinet は card_present トランザクションではなく voucher_code フィールドを受け取る別エンドポイントを提供する。客がカード番号下六桁と SMS コードを入力すると、POST /v2/voucher/authorize が五秒以内に残高を返す。

重要な詳細:部分承認に対応。120 リラの会計でカード残高 80 の場合、システムは approved_amount: 80 を返し、残り 40 は同じチェックアウト画面で二つ目の決済手段にルーティングされる。

Sodexo Restaurant Pass PNR フォーマット

Sodexo トルコは六文字の PNR を使う。先頭三文字がマーチャント ID、末尾三文字が日次シーケンス。Webhook を /api/sodexo/callback に向け、HMAC-SHA256 署名検証後にトランザクションをクローズする。

Edenred Ticket Restaurant は同パターンだが RSA-PSS 2048-bit で署名する。公開鍵は Edenred ポータルから取得し worker KV に TTL 五分でキャッシュする。

残高チェックと UX

1.2 秒以内に「残高 X TL、不足 Y TL」を表示するとコンバージョンが二十八パーセント上昇する。thMenu ではクローズ前の pre-auth check として呼び出す。

• Multinet:日次上限 750 リラ
• Sodexo:週末は無効化されている場合あり
• Edenred:返金ウィンドウ 48 時間

FAQ

Multinet API アクセスに必要なものは? 加盟店申請、税務証明、銀行口座 — 承認 7-10 営業日。

三種類の食事券を同じチェックアウトに? 可能。payment_methods JSON に個別エントリで定義する。

手数料率は? Multinet 4.5%、Sodexo 5%、Edenred 5.2%(2026 標準)。

お役に立ちましたか?シェアしてください。