개요
VibeFox Pin Payments Gateway는 Pin Payments를 통한 카드 결제를 PrestaShop에 추가합니다. 결제 단계에서 고객은 체크아웃 페이지의 카드 양식에 Visa, Mastercard 또는 American Express 카드 정보를 입력합니다. Pin Payments의 브라우저 라이브러리인 Pin.js가 이를 일회용 카드 토큰으로 변환하며, 쇼핑몰 서버에는 이 토큰만 전달됩니다. 이후 모듈은 장바구니 총액을 청구하고 Pin Payments의 응답에 따라 주문을 생성하므로, 거절된 카드로 인해 결제되지 않은 주문이 남지 않습니다.
자체 사이트에서 카드 양식을 제공하려는 Pin Payments 가맹점 계정(호주 및 뉴질랜드 사업자)을 보유한 쇼핑몰에 적합합니다. 고객은 어디에서든 결제할 수 있습니다. 모듈은 즉시 처리되는 일회성 카드 결제만 지원합니다. 3-D Secure, 저장된 카드, 구독, 승인과 매입의 분리, Apple Pay, Google Pay, 웹훅은 지원하지 않습니다.
주요 기능
Pin.js 토큰화 카드 양식: 카드 정보는 쇼핑몰 서버로 전송되지 않으며, 일회용 Pin 카드 토큰만 전송됩니다.
Pin Payments 응답 후에만 주문 생성: 주문은 Pin Payments가 성공한 청구를 보고한 후에 생성됩니다. 청구 금액과 통화가 장바구니와 정확히 일치할 때만 Payment accepted 상태가 됩니다. 차이가 있으면 주문은 메모와 함께 Pin Payments payment on hold 상태가 됩니다.
장바구니당 한 번 청구: 중복 제출이나 두 번째 탭으로 같은 장바구니에 두 번 청구되지 않습니다. 각 시도는 요청을 보내기 전에 기록되므로, 장바구니가 무조건 다시 청구되는 일은 없습니다.
시간 초과 시에도 안전: Pin Payments가 응답하지 않으면, 결제 없이 보류 상태의 주문이 생성되며, Pin Payments 대시보드에서 확인할 위치를 알려 주는 메모가 함께 기록됩니다.
명확한 거절 메시지: 고객은 카드 거절, 잔액 부족, 카드 만료, CVC 오류에 대해 쉬운 메시지를 보고, 다른 카드로 다시 시도할 수 있습니다.
주문 페이지에서 환불: 주문의 Pin Payments 블록에서 실제로 청구된 금액까지 전액 및 부분 환불이 가능하며, 환불은 항상 주문이 결제된 모드(테스트 또는 운영)로 전송됩니다.
14개 통화: AUD, USD, NZD, SGD, EUR, GBP, CAD, HKD, JPY, MYR, THB, PHP, ZAR, IDR. 다른 통화에서는 이 결제 수단이 숨겨집니다.
테스트 모드 및 로그: 테스트와 운영에 각각 별도의 키를 사용합니다. 오류는 항상 기록되며, 키, 카드 정보, 고객 정보는 포함되지 않습니다.
요구 사항
PrestaShop 8.0 ~ 9.x, PHP 8.0 이상. 공개(publishable) 및 비밀(secret) API 키가 있는 Pin Payments 가맹점 계정. vibefox.net에서 받은 VibeFox 라이선스 키(도메인 하나당 키 하나).