개요
VibeFox Square Gateway는 Square를 통한 신용카드 및 체크카드 결제를 PrestaShop에 추가합니다. 결제 단계에서 고객은 결제 수단 아래에 표시되는 안전한 Square 카드 양식(Square Web Payments SDK)에 카드를 입력합니다. 쇼핑몰 서버는 일회용 토큰만 받으며, 이 토큰은 Square Payments API를 통해 청구됩니다. 카드 정보는 쇼핑몰에 전달되지 않으며, 주문은 Square가 결제를 확인한 후에만 생성됩니다.
미국, 캐나다, 호주, 일본, 영국, 아일랜드, 프랑스, 스페인에서 Square를 사용하며 자체 결제 페이지에서 카드 결제를 받고 싶은 판매자에게 적합합니다. 이 모듈은 즉시 매입(capture)되는 일회성 카드 결제만 지원합니다. 저장된 카드, 구독, Apple Pay, Google Pay, Cash App Pay, Afterpay, Square 기프트카드는 지원하지 않으며, 승인 전용 결제와 Square 웹훅도 지원하지 않습니다.
주요 기능
3-D Secure / SCA: 카드를 토큰화할 때 구매자 인증이 진행되며, 장바구니 총액, 통화, 청구지 주소가 Square에 전달됩니다.
Square가 확인한 경우에만 결제 완료: 주문은 장바구니 총액, 통화, 장바구니 참조 번호, 위치가 정확히 일치하는 COMPLETED 결제가 있을 때만 Payment accepted 상태가 됩니다. 예상과 다른 상황이 발생하면 주문은 메모와 함께 Square payment on hold 상태가 됩니다.
이중 청구 방지: 장바구니당 동시에 하나의 결제 시도만 진행되며, 요청은 멱등성을 갖습니다. 응답이 유실된 시도는 카드를 다시 청구하는 대신 Square에서 조회됩니다.
자격 증명 및 통화 확인: 액세스 토큰과 위치는 저장 시 Square에서 확인됩니다. Square 위치가 청구할 수 없는 통화의 장바구니에서는 결제 수단이 표시되지 않습니다.
주문 페이지에서 환불: 주문의 Square 블록에서 전액 및 부분 환불이 가능하며, 항상 실제 결제와 같은 환경, 위치, 금액, 통화로 처리됩니다. 전액 환불 시 주문은 Refunded 상태가 됩니다.
주문 페이지의 Square 블록: Square Dashboard 링크가 포함된 결제 ID, 카드, 영수증, 환불 내역 및 메모.
명확한 메시지: 고객에게는 간단한 메시지(거절, 잘못된 CVV, 3-D Secure 필요)가 표시됩니다. 오류는 항상 기록되며, 키나 카드 데이터는 포함되지 않습니다.
요구 사항
PrestaShop 8.0 ~ 9.x, PHP 8.0 이상. Square Developer Dashboard에 애플리케이션이 등록된 Square 계정(Application ID, Access Token, Location ID). 장바구니 통화는 Square 위치의 통화와 같아야 합니다: USD, CAD, AUD, JPY, GBP 또는 EUR. vibefox.net에서 발급받은 VibeFox 라이선스 키(도메인당 키 1개).