식권 (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에 5분 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 표준).

도움이 되셨나요? 공유해 주세요.