개요
VibeFox Braintree Gateway는 Braintree(PayPal)를 통한 신용카드 및 체크카드 결제를 PrestaShop에 추가합니다. 결제 단계에서 고객은 체크아웃 페이지에서 바로 Braintree가 제공하는 보안 양식인 Braintree Drop-in UI에 카드를 입력합니다. 카드 번호는 쇼핑몰 서버에 전달되지 않으며, 모듈은 일회용 결제 토큰만 받습니다. 주문은 Braintree가 결제를 승인한 후에만 생성되므로, 거절된 카드로 인해 미결제 주문이 남지 않습니다.
이 모듈은 자체 체크아웃에서 카드 결제를 받고 싶은 Braintree 가맹점 계정 보유 쇼핑몰에 적합하며, EEA 및 영국에서 강력한 고객 인증(SCA)을 위한 3-D Secure 2를 지원합니다. 모듈은 카드 결제만 받습니다. 저장된 카드, 구독, PayPal, Venmo, Apple Pay 또는 Google Pay 버튼은 지원하지 않으며, Braintree 웹훅도 사용하지 않습니다. 따라서 분쟁(차지백)과 정산 거절은 PrestaShop과 동기화되지 않습니다.
주요 기능
Braintree Drop-in UI: 카드 입력 양식은 PrestaShop 체크아웃 페이지의 결제 옵션 안에, 쇼핑몰의 언어로 표시됩니다.
3-D Secure 2: Enabled(실패한 인증은 차단됨) 또는 Required(책임 전환이 있는 결제만 허용됨), 결제 토큰은 서버 측에서 확인됩니다.
Sale 또는 Authorize only: 즉시 청구하거나, 금액을 예약해 두었다가 나중에 주문 페이지의 Braintree 블록에서 캡처하거나 무효화합니다.
Braintree가 승인한 후에만 주문 생성: 청구 금액과 통화는 장바구니와 대조됩니다. 통화나 금액이 잘못된 청구는 자동으로 무효화되며, 고객에게는 청구되지 않습니다.
이중 청구 방지: 장바구니별 잠금과 일회용 결제 토큰을 통해 같은 장바구니에 두 번 청구되지 않도록 합니다. 카드에는 청구되었지만 주문을 생성하지 못한 경우, 다음 시도에서는 다시 청구하지 않고 주문을 생성합니다.
주문 페이지에서 환불: Braintree payment 블록에서 전액 및 부분 환불이 가능하며, 금액과 통화는 Braintree가 실제로 청구한 것을 따릅니다. 아직 정산되지 않은 거래의 전액 환불은 무효화로 처리됩니다. 환불, 캡처 및 무효화는 결제가 이루어진 환경(샌드박스 또는 운영)을 사용합니다.
통화별 가맹점 계정: 선택 사항입니다(예: EUR=mystore_EUR, USD=mystore_USD). JPY, KRW 등 소수점이 없는 통화는 정수 단위로 청구됩니다.
샌드박스와 운영 환경을 나란히: 환경별로 별도의 자격 증명을 사용하며, 주문에서 Braintree Control Panel의 거래로 연결되는 링크와 키·카드·고객 데이터 없이 기록되는 로그를 제공합니다.
요구 사항
PrestaShop 8.0 ~ 9.x, PHP 8.0 이상. Merchant ID, Public Key, Private Key가 있는 Braintree 계정. 3-D Secure를 끄지 않는 한 계정에서 3-D Secure가 활성화되어 있어야 합니다. 웹훅은 필요하지 않습니다. vibefox.net에서 받은 VibeFox 라이선스 키(도메인 하나당 키 하나).