개요
VibeFox Transbank Gateway는 칠레 쇼핑몰을 위해 Transbank Webpay Plus 결제를 PrestaShop에 추가합니다. 결제 단계에서 고객은 Webpay Plus를 선택하고 Webpay 결제 양식으로 이동하여 신용카드, 체크카드 또는 선불카드로 결제한 뒤 쇼핑몰로 돌아옵니다. 카드 정보는 쇼핑몰 사이트를 거치지 않습니다. 주문은 Transbank가 결제를 확인한 후에만 생성되므로, 취소되었거나 거절된 결제로 인해 미결제 주문이 남지 않습니다.
칠레 페소(CLP)로 판매하고 표준 Webpay Plus 커머스 코드를 보유한 쇼핑몰에 적합합니다. Transbank에는 결제 웹훅이 없습니다. 고객이 Webpay에서 돌아올 때 서버 간 통신으로 결제가 확인됩니다. 모듈은 Webpay Plus Mall, Oneclick 저장 카드, 정기결제, 지연 캡처, 통화 변환을 지원하지 않으며, Transbank 포털에서 처리한 환불은 가져오지 않습니다.
주요 기능
Webpay Plus 리디렉션: 장바구니 총액을 정수 페소로 하여 Transbank 거래를 생성하고, 고객은 Webpay 양식에서 결제합니다.
Transbank가 확인한 경우에만 결제 완료: 고객이 돌아오면 모듈이 Transbank와 거래를 확정(commit)합니다. 주문은 Transbank가 승인한 경우에만 생성됩니다. 금액, buy order 또는 세션이 쇼핑몰이 보낸 내용과 일치하지 않으면 주문은 검토를 위해 Transbank payment on hold 상태가 됩니다.
변경된 장바구니에는 청구하지 않음: 결제가 시작된 후 장바구니 총액이 바뀌면(다른 탭에서 변경되었거나 쿠폰이 만료된 경우), 거래는 확정되지 않으므로 고객에게 요금이 청구되지 않고 새 총액을 결제하게 됩니다.
최대 한 번만 확정: 반환 페이지를 새로고침하거나, 브라우저 뒤로 가기 버튼을 누르거나, 같은 순간에 두 번 돌아오더라도 결제가 두 번 확정되거나 두 번째 주문이 생성되지 않습니다.
오류 시 안전: 확정 요청이 실패하면 모듈은 주문을 생성하기 전에 Transbank에 실제 거래 상태를 요청합니다.
주문 페이지에서 환불: 주문의 Transbank Webpay Plus 블록에서 정수 페소 단위의 전액 및 부분 환불이 가능합니다. 항상 결제가 이루어진 환경에서 처리됩니다. 전액 환불하면 주문이 Refunded 상태가 됩니다.
자격 증명 없이 테스트: 통합 환경은 Transbank의 공개 테스트 커머스 코드를 자동으로 사용합니다.
주문 블록 및 로그: 결제 정보, 장바구니의 모든 Webpay 시도 기록, 주문 페이지의 Transbank 메모. 오류는 항상 기록되며, 자세한 내용은 요청 시 확인할 수 있습니다. 카드 정보와 키는 기록되지 않습니다.
요구 사항
PrestaShop 8.0 ~ 9.x, PHP 8.0 이상. 장바구니 통화는 칠레 페소(CLP)여야 합니다. 실제 결제를 받으려면 Transbank에서 발급받은 운영용 Webpay Plus 커머스 코드(Commerce Code)와 API Key Secret이 필요합니다. vibefox.net에서 받은 VibeFox 라이선스 키(도메인 하나당 키 하나).