개요
VibeFox Cashfree Payments는 Cashfree Payments(인도)를 통한 결제를 PrestaShop에 추가합니다. 결제 단계에서 고객이 Cashfree를 선택하면 Cashfree 호스팅 체크아웃이 열리고, 고객은 카드, UPI, 넷뱅킹, 전자지갑 또는 Cashfree 계정에서 활성화된 기타 결제 수단으로 결제한 다음 쇼핑몰로 돌아옵니다. 카드 정보는 쇼핑몰 사이트에 전혀 전달되지 않습니다. 주문은 Cashfree가 결제를 확인한 후에만 생성되므로, 중단된 결제로 미결제 주문이 남지 않습니다.
이 모듈은 카드, UPI, 넷뱅킹을 하나의 결제 수단으로 제공하고 Cashfree 계정을 사용하려는 인도 쇼핑몰에 적합합니다. 모듈은 일회성 결제만 처리합니다. 저장된 카드, 구독 또는 정기 결제, 별도의 승인 및 캡처, Cashfree 오퍼 위젯, Cashfree를 통한 결제 링크 또는 COD, 통화 환전은 지원하지 않습니다.
주요 기능
Cashfree 호스팅 체크아웃: 장바구니 통화로 된 장바구니 합계에 대해 Cashfree 주문이 생성되며, 해당 통화에 Cashfree가 요구하는 소수점 자릿수로 만들어지고, 고객에게 Cashfree 결제 페이지가 열립니다.
Cashfree 확인 시에만 결제 완료: 주문은 Secret Key로 서명된 웹훅을 받거나, 고객이 쇼핑몰로 돌아올 때 서버 측에서 결제를 확인한 후에 생성됩니다. 복귀 링크만으로는 결제 완료된 주문이 생성되지 않습니다.
금액 및 통화 확인: 결제된 금액과 통화가 장바구니와 정확히 일치해야 합니다. 불일치하면 주문이 메모와 함께 Cashfree payment on hold 상태가 됩니다.
중복 처리 방지: 반복되거나 동시에 도착하는 웹훅과 복귀로 두 번째 주문이 생성되지 않습니다. Cashfree에서는 이미 결제되었지만 기록되지 않은 장바구니를 다음 결제 시도에서 감지하며, 다시 청구하지 않습니다.
재시도: 열려 있는 Cashfree 결제는 고객이 다시 시도할 때 재사용됩니다. 장바구니 합계가 바뀌었거나 세션이 곧 만료되는 경우 이전 Cashfree 주문은 닫히고 새 주문이 생성됩니다.
샌드박스 및 운영 모드: 모드별로 별도의 키를 사용하며, 체크아웃에 샌드박스 안내가 표시됩니다. 웹훅, 결제 확인, 환불은 항상 결제가 이루어진 모드를 사용합니다.
주문 페이지에서 환불: 주문의 Cashfree payment 블록에서 전액 및 부분 환불이 가능하며, Cashfree가 실제로 청구한 금액까지만 환불할 수 있습니다. 전액 환불 시 주문은 Refunded 상태가 됩니다. Cashfree의 환불 상태 업데이트는 메모로 추가됩니다.
주문 페이지의 Cashfree 블록: Cashfree 결제 정보, 환불 내역, 모듈 메모가 표시됩니다. 같은 Cashfree 계정을 사용하는 여러 쇼핑몰을 위한 주문 ID 접두사. 키나 고객 데이터 없이 기록하는 선택적 로그.
요구 사항
PrestaShop 8.0 ~ 9.x, PHP 8.0 이상. 샌드박스와 운영 결제를 위한 App ID 및 Secret Key가 있는 Cashfree 계정. 웹훅을 위한 HTTPS. vibefox.net에서 받은 VibeFox 라이선스 키(도메인 하나당 키 하나).