개요
VibeFox Culqi Payment는 페루의 결제 서비스인 Culqi를 PrestaShop에 추가합니다. 결제 단계에서 고객은 Culqi Checkout 팝업에서 카드 또는 Yape로 결제하며, 상점을 벗어나지 않습니다. 카드 정보는 Culqi 창에 입력되며 상점 서버에는 전달되지 않습니다. 이후 상점 서버가 Culqi Charges API로 청구를 생성하며, 주문은 Culqi가 청구를 확인한 후에만 생성되므로 거절되었거나 중도에 포기된 결제로 미결제 주문이 남지 않습니다.
이 모듈은 페루 솔(PEN) 또는 미국 달러(USD)로 판매하고 Culqi 계정이 있는 페루 상점에 적합합니다. 모듈은 카드와 Yape를 통한 일회성 결제만 받습니다. PagoEfectivo 또는 CIP 코드, 은행 앱, 대리점, 지갑, Cuotéalo는 지원하지 않으며, 저장된 카드, 구독, 할부도 없습니다. Culqi 웹훅도 없고, 승인과 캡처를 분리하는 기능도 없습니다.
주요 기능
Culqi Checkout 팝업: 카드(Visa, Mastercard, American Express, Diners Club)와 선택 사항으로 Yape를 결제 페이지의 창에서 사용할 수 있습니다.
3-D Secure: 은행에서 요구하면 Culqi 3-D Secure가 자동으로 열리고, 인증 후 청구가 완료됩니다.
Culqi가 확인한 경우에만 결제 완료: Culqi가 청구에 성공했다고 응답한 후에 주문이 생성되며, 청구된 금액과 통화는 장바구니와 비교됩니다. 일치하지 않으면 주문은 메모와 함께 Culqi payment on hold 상태가 됩니다.
이중 청구 방지: 이미 주문이 있거나 이미 Culqi 청구가 있는 장바구니는 더블 클릭, 두 번째 탭, 재시도가 있어도 다시 청구되지 않습니다.
명확한 거절 안내: 고객에게 Culqi의 메시지가 표시되며, 다른 카드로 다시 시도할 수 있습니다. 거절 코드는 모듈 로그에 기록됩니다.
테스트 모드와 라이브 모드: 모드별로 공개 키와 비밀 키가 따로 있습니다. 환불에는 항상 결제가 이루어진 모드의 키가 사용됩니다.
주문 페이지에서 환불: 주문의 Culqi payment 블록에서 Culqi가 실제로 청구한 금액까지 전액 및 부분 환불이 가능합니다. 전액 환불하면 주문이 Refunded 상태가 됩니다.
안전한 설정과 로그: 접두사가 잘못된 키는 거부되며, 저장된 비밀 키는 다시 표시되지 않습니다. 선택형 로그에는 키, 카드 데이터, 고객 정보가 포함되지 않습니다.
요구 사항
PrestaShop 8.0 ~ 9.x, PHP 8.0 이상. 상점 통화는 PEN 또는 USD. 공개 및 비밀 API 키가 있는 Culqi 계정. vibefox.net에서 받은 VibeFox 라이선스 키(도메인 하나당 키 하나).