개요
VibeFox Square Gateway는 Square를 통한 신용카드 및 체크카드 결제를 OpenCart 3과 OpenCart 4에 추가합니다. Confirm Order 단계에서 고객은 Square의 보안 카드 양식(Square Web Payments SDK)에 카드를 입력합니다. 서버는 일회용 토큰만 받으며, 이 토큰은 Square Payments API를 통해 청구됩니다. 카드 데이터는 쇼핑몰에 전달되지 않습니다. OpenCart는 결제 전에 주문을 생성하지만, 주문은 Square가 응답한 후에야 상태를 받습니다. 따라서 거절된 시도는 누락된 주문으로 남습니다.
자체 체크아웃에서 카드 결제를 받고 싶은 Square 판매자에게 적합하며, 결제 통화는 Square 로케이션의 통화(USD, CAD, AUD, JPY, GBP 또는 EUR)여야 합니다. 이 확장 프로그램은 일회성 카드 결제를 받으며, 결제는 즉시 승인됩니다. 저장된 카드, 구독, Apple Pay, Google Pay, Cash App Pay, Afterpay 또는 Square 기프트 카드는 지원하지 않으며, 승인만 하는 결제와 Square 웹훅도 지원하지 않습니다.
주요 기능
3-D Secure / SCA: 카드를 토큰화할 때 구매자 인증이 실행되며, 주문 총액, 통화, 결제 주소가 Square에 전달됩니다.
Square가 확인한 경우에만 결제 완료: 결제 상태가 COMPLETED이고 금액, 통화, 주문 참조, 로케이션이 주문과 정확히 일치할 때만 주문이 결제 완료 상태가 됩니다. 예상과 다른 값이 있으면 주문은 메모와 함께 검토 상태가 됩니다.
이중 청구 방지: 장바구니당 한 번에 한 번의 결제 시도만 허용되며, 요청은 멱등성을 갖습니다. 응답이 유실된 시도는 카드를 다시 청구하지 않고 Square에서 조회합니다.
자격 증명 및 통화 확인: 저장할 때 액세스 토큰과 로케이션을 Square와 확인합니다. Square 로케이션이 청구할 수 없는 통화의 주문에는 결제 방법이 표시되지 않습니다.
주문 페이지에서 환불: 주문의 VibeFox Square Gateway 탭에서 전액 및 부분 환불이 가능하며, 항상 실제 결제가 이루어진 환경, 로케이션, 금액, 통화를 사용합니다. 전액 환불 시 주문 상태는 Refunded로 설정됩니다.
주문 페이지의 Square 탭: Square 대시보드 링크가 포함된 결제 ID, 카드 정보, 영수증, 환불 내역, 메모를 표시합니다.
명확한 메시지: 고객에게는 짧은 메시지가 표시됩니다(카드 거절, CVV 오류, 3-D Secure 필요 등). 오류는 항상 기록되며, 키나 카드 데이터는 포함되지 않습니다.
OpenCart 조건: 직접 설정한 주문 상태, 지역 그룹, 최소 주문 금액 및 정렬 순서.
요구 사항
OpenCart 3.0.x(3.0.5.0에서 테스트됨) 또는 OpenCart 4.0.2 이상(4.1.0.3에서 테스트됨), PHP 8.0 이상. 다운로드 파일 하나에 두 버전용 패키지가 모두 들어 있습니다. Square Developer Dashboard에서 애플리케이션을 만든 Square 계정(Application ID, Access Token, Location ID). 주문 통화는 Square 로케이션의 통화와 같아야 합니다: USD, CAD, AUD, JPY, GBP 또는 EUR. vibefox.net에서 받은 VibeFox 라이선스 키(도메인당 키 하나).