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