개요
VibeFox Tap Payments는 PrestaShop에 Tap Payments를 추가합니다: Visa, Mastercard, Amex, mada, KNET, Benefit, Apple Pay, Google Pay. 고객은 Tap의 보안 결제 페이지 또는 쇼핑몰 결제 페이지의 Tap Checkout 팝업에서 결제합니다. 카드 정보는 쇼핑몰 서버에 전달되지 않습니다. 주문은 Tap이 결제를 확인한 후에만 생성되므로, 중도 포기되거나 거절된 결제로 미결제 주문이 남지 않습니다.
쿠웨이트, 사우디아라비아, UAE, 바레인, 카타르, 오만 및 기타 Tap 지원 시장에서 Tap 계정으로 현지 및 국제 결제 수단을 받고자 하는 쇼핑몰에 적합합니다. 모듈은 일회성 결제만 처리합니다. 저장된 카드, 구독, 체크아웃 페이지에 내장된 카드 입력란은 지원하지 않으며, 부분 캡처도 지원하지 않습니다.
주요 기능
두 가지 체크아웃 방식: Tap 결제 페이지(리디렉션, 권장) 또는 모듈 결제 페이지의 Tap Checkout 팝업. Tap 결제 페이지는 대체 수단으로 제공됩니다.
Tap이 확인한 경우에만 결제 완료: 모듈이 Tap API에서 결제 정보를 읽고, 해당 결제가 장바구니에 속하는지 확인한 뒤, 주문을 생성하기 전에 금액과 통화를 장바구니와 비교합니다.
서명된 웹훅, 별도 설정 불필요: 웹훅 URL은 모든 결제와 함께 전송됩니다. 유효한 서명이 없는 알림은 거부됩니다.
정확한 금액: KWD, BHD, OMR, JOD는 소수점 3자리로, SAR, AED, QAR, EUR, USD 및 기타 통화는 소수점 2자리로 전송됩니다.
청구 또는 승인만: 승인된 주문은 Tap payment authorized 상태가 됩니다. 주문 페이지에서 Capture Tap payment로 캡처하거나 Void Tap authorization으로 금액을 해제할 수 있습니다.
주문 페이지에서 환불: Tap payment 블록에서 전액 및 부분 환불이 가능하며, Tap이 실제로 청구한 금액까지 환불할 수 있습니다. 환불은 결제가 이루어진 모드(테스트 또는 운영)의 키로 항상 전송됩니다.
안전한 상태 처리: 반복되는 웹훅과 복귀로 두 번째 주문이 생성되지 않습니다. 금액 불일치는 Tap payment on hold 상태로 전환되며, 중복 또는 지연된 결제는 주문에 메모로 기록됩니다.
주문 페이지의 Tap 블록: Tap ID, 결제 시도, 환불 내역, 결제 메모. Tap 페이지는 영어 또는 아랍어로 표시됩니다. 키나 고객 데이터를 포함하지 않는 선택적 디버그 로그.
요구 사항
PrestaShop 8.0 ~ 9.x, PHP 8.0 이상. 테스트 및 운영 API 키가 있는 Tap 계정(시크릿 키, 팝업의 경우에만 퍼블리셔블 키 필요). 쇼핑몰 통화는 AED, BHD, EGP, EUR, GBP, JOD, KWD, OMR, QAR, SAR, USD 중 하나여야 합니다. vibefox.net에서 받은 VibeFox 라이선스 키(도메인 하나당 키 하나).