개요
VibeFox Helcim Gateway는 Helcim Payment API를 통한 신용카드 결제를 PrestaShop에 추가합니다. 고객은 체크아웃의 결제 단계에서 카드를 입력하고, 쇼핑몰 서버는 이를 Helcim으로 전송하며, 주문은 동일한 요청 내에서 Helcim의 응답에 따라 생성됩니다. Visa, Mastercard, American Express, Discover, UnionPay 카드를 CAD 또는 USD로 사용할 수 있습니다.
자체 체크아웃에 카드 양식을 직접 두고자 하는 캐나다 및 미국의 Helcim 계정 보유 가맹점에 적합합니다. 카드 세부 정보가 쇼핑몰 웹 서버를 통과하므로 쇼핑몰에는 HTTPS 및 PCI DSS 준수 호스팅(SAQ D)이 필요합니다. 모듈에는 저장된 카드, 정기결제, ACH 또는 은행 결제, Apple Pay, Google Pay, 3-D Secure 기능이 없으며 Helcim 웹훅도 지원하지 않습니다. Helcim 대시보드에서 수행된 캡처, 환불, 무효화는 PrestaShop에 반영되지 않습니다.
주요 기능
체크아웃의 카드 입력 양식: 카드 번호, 유효기간, CVC, 카드 소유자 이름을 전송 전에 확인(카드 번호 체크섬, 과거 날짜가 아닌 유효기간, CVC 자릿수)하며 카드 브랜드 아이콘을 표시합니다.
즉시 결제 또는 사전 승인: 카드에 즉시 청구하거나, 금액만 보류해 두고 나중에 주문의 Helcim 블록에 있는 Capture payment로 캡처할 수 있습니다.
승인 후에만 주문 생성: Helcim이 거래를 승인한 후에만 주문이 생성됩니다. 거절된 카드는 주문을 남기지 않습니다. 승인된 금액이나 통화가 장바구니와 일치하지 않으면 주문은 메모와 함께 Helcim payment on hold 상태가 됩니다.
장바구니당 1회 청구: 동시 제출은 차단되고, 이미 결제된 장바구니는 다시 청구되지 않으며, 모든 시도에 멱등성 키가 사용됩니다. 따라서 시간 초과 후 재시도 시 카드에 이중 청구되는 대신 원래의 Helcim 결과가 반환됩니다.
주문 화면에서 환불: 주문의 Helcim 블록에서 전액 및 부분 환불이 가능하며, 환불 금액은 Helcim이 실제로 청구한 금액을 넘을 수 없습니다. 캡처되지 않은 사전 승인을 전액 환불하면 금액 보류가 해제됩니다.
운영 및 테스트 토큰: 운영 및 테스트 Helcim 계정에 대해 별도의 API 토큰을 제공합니다. 캡처와 환불은 항상 해당 주문이 결제된 계정을 사용합니다.
주문 화면의 Helcim 블록: 거래 ID, 카드 종류와 끝 4자리, 승인 금액, 환불 내역, 모듈 메모를 표시합니다. 카드 번호, CVC, 토큰, 개인정보가 포함되지 않는 오류 로그를 기록합니다.
요구 사항
PrestaShop 8.0 ~ 9.x, PHP 8.0 이상. Helcim 가맹점 계정(캐나다 또는 미국) 및 API 토큰. 쇼핑몰의 HTTPS 적용 및 PCI DSS 준수 호스팅. vibefox.net의 VibeFox 라이선스 키(도메인당 1개 키).