개요
VibeFox Viva Wallet Gateway는 Viva Wallet(Viva.com) Smart Checkout을 OpenCart 3와 OpenCart 4에 추가하는 확장 기능입니다. 고객은 마지막 체크아웃 단계에서 Confirm Order를 클릭하면 Viva의 보안 결제 페이지로 이동하여 카드, Apple Pay, Google Pay 또는 귀하의 Viva 계정에서 사용하도록 설정된 현지 결제 수단으로 결제한 후 쇼핑몰로 돌아옵니다. 카드 정보는 쇼핑몰 서버를 거치지 않습니다. OpenCart는 결제 전에 주문을 생성하지만, 주문은 Viva API로 결제가 확인된 후에야 상태를 받습니다. 따라서 결제되지 않은 시도는 누락된 주문으로 남습니다.
이 확장 기능은 Viva 가맹점 계정이 있고, 자체 사이트에 카드 입력 양식을 두는 대신 호스팅 결제 페이지를 사용하려는 쇼핑몰에 적합합니다. 일회성 결제만 지원하며, 사전 승인 및 매입, 할부, 카드 저장, 정기 구독, 자체 페이지의 카드 입력란, POS 단말기는 지원하지 않습니다. 또한 Viva 대시보드에서 진행한 환불은 가져오지 않습니다.
주요 기능
Smart Checkout: 주문 통화로 주문 합계에 대한 Viva 결제 주문이 생성되며, 통화의 올바른 최소 단위가 적용됩니다.
Viva가 확인한 경우에만 결제 완료: Viva 웹훅은 서명되지 않으므로, 확장 기능은 모든 거래를 Viva API에서 다시 조회합니다. 거래는 이 주문의 결제 주문에 속하고, 완료된 상태이며, 주문 금액 및 통화와 일치해야 합니다.
웹훅과 복귀: 주문은 Viva 웹훅을 통해 또는 고객이 쇼핑몰로 돌아왔을 때 상태를 받습니다. Viva의 웹훅 URL 확인은 귀하의 Merchant ID와 API Key로 자동 응답됩니다.
이중 처리 방지: 반복되거나 동시에 들어오는 웹훅과 복귀 요청이 결제를 두 번 적용하는 일은 없습니다. 하나의 장바구니는 한 번만 결제되며, 늦게 도착한 결제가 취소되었거나 환불된 주문을 다시 열지 않습니다.
금액 및 통화 확인: 불일치하는 경우, 주문은 선택하신 검토 상태로 설정되고 메모가 남습니다.
데모 및 라이브 계정: 각각 별도의 인증 정보를 사용합니다. 이미 시작된 결제는 Test Mode를 전환한 후에도 결제가 이루어진 계정에서 확인되고 환불됩니다.
주문 페이지에서 환불: 주문의 VibeFox Viva Wallet Gateway 탭에서 Viva가 청구한 금액까지 전액 및 부분 환불을 할 수 있으며, 결제의 계정과 통화로 처리됩니다. 환불 내역, 결제 시도, Viva 메모도 함께 표시됩니다.
OpenCart 설정: 자체 주문 상태, 지역(Geo Zone), 최소 주문 금액, 정렬 순서. Viva 결제 페이지의 브랜드 색상, 키나 고객 데이터가 없는 로그.
요구 사항
OpenCart 3.0.x(3.0.5.0에서 테스트됨) 또는 OpenCart 4.0.2 이상(4.1.0.3에서 테스트됨), 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 라이선스 키(도메인당 하나).