개요
VibeFox TrustPay Gateway는 finby(구 TrustPay)를 통한 카드 결제를 PrestaShop에 추가합니다. 결제 단계에서 고객은 카드 결제를 선택하고, 3-D Secure가 적용된 finby의 보안 카드 결제 페이지로 이동하여 카드로 결제한 뒤 쇼핑몰로 돌아옵니다. 카드 정보는 귀사의 사이트를 거치지 않습니다. 주문은 finby가 서명된 알림으로 결제를 확인한 후에만 생성되므로, 중단된 결제로 미결제 주문이 남지 않습니다.
사이트에 자체 카드 양식을 구축하지 않고 finby 프로젝트로 카드를 받고 싶은 쇼핑몰에 적합합니다. 카드 결제만 처리합니다. 계좌이체나 finby의 다른 결제 수단, 사이트의 Apple Pay 또는 Google Pay 버튼, 카드 저장, 정기 구독, 승인과 매입의 분리, 상태 조회 기능은 지원하지 않습니다.
주요 기능
finby 결제 페이지: 장바구니 금액에 대해 장바구니 통화로 카드 결제 요청이 생성됩니다(EUR, CZK, HUF, GBP, PLN, NOK, SEK, DKK, BGN, RON, CHF 또는 USD). finby가 지원하는 경우 결제 페이지는 쇼핑몰 언어로 열리며, 지원하지 않으면 영어로 열립니다.
finby 확인 시에만 결제 완료: 주문은 finby가 서버 간에 보낸 서명된 알림을 통해 생성됩니다. 고객이 돌아오는 것만으로는 결제가 완료로 표시되지 않습니다.
금액 및 통화 확인: 결제된 금액과 통화는 결제 요청 및 장바구니와 비교됩니다. 불일치하면 주문은 메모와 함께 TrustPay payment on hold 상태가 됩니다.
중복 처리 방지: 반복된 알림으로 두 번째 주문이 생성되거나 결제가 두 번 기록되지 않습니다. 이미 결제 완료된 주문에 대한 두 번째 결제는 메모로만 남습니다.
테스트 및 실서비스 프로젝트: 테스트(playground) 프로젝트와 실서비스 프로젝트에 각각 별도의 Project ID와 Secret key를 사용합니다. 테스트 결제가 실제 결제를 확정하는 일은 없으며, 환불은 항상 주문 결제에 사용된 프로젝트로 처리됩니다.
주문 페이지에서 환불: TrustPay / finby payment 블록에서 고객이 실제로 결제한 금액까지 전액 및 부분 환불이 가능합니다. 전액 환불 시 주문은 Refunded 상태가 됩니다.
원하는 주문 상태: 결제 성공 후 Payment accepted 또는 Delivered로 설정할 수 있으며, 한 단계로 적용됩니다.
주문 페이지의 결제 블록: 결제 요청, 프로젝트, 상태, 금액, 환불 내역, 메모를 표시합니다. 로그에는 키나 고객 데이터가 포함되지 않습니다.
요구 사항
PrestaShop 8.0 ~ 9.x, PHP 8.0 이상. 프로젝트와 그 Project ID 및 Secret key가 있는 finby(TrustPay) 계정, 그리고 테스트 결제를 위한 테스트(playground) 프로젝트. 쇼핑몰의 알림 URL은 인터넷에서 접근 가능해야 합니다. vibefox.net에서 받은 VibeFox 라이선스 키(도메인당 키 하나).