개요
VibeFox Viva Wallet Gateway는 PrestaShop에 Viva Wallet(Viva.com) Smart Checkout을 추가합니다. 결제 단계에서 고객은 Viva Wallet을 선택하고, 안전한 Viva 결제 페이지로 이동하여 카드, Apple Pay, Google Pay 또는 Viva 계정에서 활성화된 현지 결제 수단으로 결제한 뒤 쇼핑몰로 돌아옵니다. 카드 정보는 귀하의 사이트를 거치지 않습니다. 주문은 Viva가 결제를 확인한 후에만 생성되므로, 중단된 결제로 미결제 주문이 남지 않습니다.
자체 사이트에 카드 양식을 두는 대신 호스팅 결제 페이지를 원하는 Viva 가맹점 계정 보유 쇼핑몰에 적합합니다. 이 모듈은 일회성 결제만 지원합니다. 사전 승인 및 캡처, 할부, 저장된 카드, 구독, 자체 페이지의 카드 입력란, POS 단말기는 지원하지 않으며, Viva 대시보드에서 이루어진 환불은 가져오지 않습니다.
주요 기능
Smart Checkout: 장바구니 금액을 장바구니 통화로 하여, 통화의 올바른 최소 단위를 사용한 Viva 결제 주문이 생성됩니다.
Viva 확인 시에만 결제 완료: Viva 웹훅은 서명되지 않으므로, 모듈은 Viva API에서 모든 거래를 다시 조회합니다. 해당 거래는 이 장바구니의 Viva 결제 주문에 속하고, 완료되었으며, 장바구니 금액 및 통화와 일치해야 합니다.
웹훅과 복귀: 주문은 Viva 웹훅으로 생성되거나, 고객이 쇼핑몰로 돌아올 때 생성됩니다. Viva의 웹훅 URL 확인에는 Merchant ID와 API Key로 자동 응답합니다.
이중 처리 방지: 반복되거나 동시에 들어온 웹훅과 복귀로 두 번째 주문이 생성되거나 결제가 두 번 기록되는 일은 없습니다. 늦게 도착한 결제가 취소되거나 환불된 주문을 다시 열지도 않습니다.
금액 및 통화 검사: 불일치가 있으면 주문이 Viva Wallet payment on hold 상태로 바뀌어 검토를 기다리며, 메모가 남습니다.
데모 및 라이브 계정: 각각 별도의 자격 증명을 사용합니다. 이미 시작된 결제는 Test Mode를 전환한 후에도 결제가 이루어진 계정에서 확인 및 환불됩니다.
주문 페이지에서 환불: 주문의 Viva Wallet payment 블록에서 전액 및 부분 환불이 가능하며, Viva가 청구한 금액 이내에서 결제의 계정과 통화로 처리됩니다. 전액 환불 시 주문은 Refunded로 설정됩니다.
주문 페이지의 Viva 블록: 거래, 결제 시도, 환불 내역, 메모를 표시합니다. 결제 후 원하는 주문 상태를 선택할 수 있으며, 로그에는 키나 고객 데이터가 기록되지 않습니다.
요구 사항
PrestaShop 8.0 ~ 9.x, PHP 8.0 이상. Smart Checkout 자격 증명(Client ID 및 Client Secret)과 결제 소스(Source Code)가 있는 Viva 가맹점 계정. 장바구니 통화는 EUR, GBP, PLN, RON, BGN, CZK, HUF, DKK, SEK, NOK 또는 CHF여야 합니다. vibefox.net에서 받은 VibeFox 라이선스 키(도메인 하나당 키 하나).