개요
VibeFox Transbank Gateway는 칠레의 쇼핑몰을 위해 OpenCart 3 및 OpenCart 4에 Transbank Webpay Plus 결제를 추가합니다. 결제 마지막 단계에서 고객이 Confirm Order를 클릭하면 Webpay 결제 양식으로 이동하고, 신용카드, 체크카드 또는 선불카드로 결제한 뒤 쇼핑몰로 돌아옵니다. 카드 정보는 쇼핑몰 사이트를 거치지 않습니다. OpenCart는 결제 전에 주문을 만들지만, 주문은 Transbank가 결제를 확인한 후에야 상태를 받습니다. 따라서 취소되거나 거절된 결제는 누락된 주문으로 남습니다.
이 확장 기능은 칠레 페소(CLP)로 판매하고 표준 Webpay Plus 가맹점 코드를 가진 쇼핑몰에 적합합니다. Transbank에는 결제 웹훅이 없습니다. 고객이 Webpay에서 돌아올 때 서버 간에 결제가 확인됩니다. 이 확장 기능은 Webpay Plus Mall, Oneclick 저장 카드, 정기 결제, 지연 캡처, 통화 변환을 지원하지 않으며, Transbank 포털에서 처리한 환불은 가져오지 않습니다.
주요 기능
Webpay Plus 리디렉션: 주문 금액을 정수 페소 단위로 하여 Transbank 거래를 만들고, 고객은 Webpay 양식에서 결제합니다.
Transbank가 확인한 경우에만 결제 완료: 고객이 돌아오면 확장 기능이 Transbank와 함께 거래를 확정(commit)합니다. 주문은 Transbank가 승인한 경우에만 상태를 받습니다. 금액, buy order 또는 세션이 쇼핑몰이 보낸 내용과 일치하지 않으면, 주문은 메모와 함께 검토 상태로 바뀝니다.
변경된 주문에는 청구하지 않음: 주문이 더 이상 거래와 일치하지 않거나, 같은 장바구니가 이미 다른 주문으로 결제된 경우 거래는 확정되지 않으며, 고객에게 청구되지 않습니다.
최대 한 번만 확정: 반환 페이지를 새로고침하거나 브라우저 뒤로 가기 버튼을 누르거나 동시에 두 번 돌아와도 결제가 두 번 확정되지 않습니다.
오류 발생 시에도 안전: 확정 호출이 실패하면, 확장 기능은 주문에 상태를 설정하기 전에 Transbank에 실제 거래 상태를 조회합니다.
주문 페이지에서 환불: 주문의 VibeFox Transbank Gateway 탭에서 정수 페소 단위로 전액 및 부분 환불을 할 수 있으며, 항상 결제가 이루어진 환경에서 처리됩니다.
자격 증명 없이 테스트: 통합 환경은 Transbank의 공개 테스트 가맹점 코드를 자동으로 사용합니다.
자체 주문 상태와 OpenCart 조건: 결제 완료, 검토 완료, 환불 완료된 주문의 상태를 선택하고, 지역(Geo Zone), 최소 주문 금액, 정렬 순서를 설정할 수 있습니다. 오류는 항상 기록되며, 자세한 내용은 요청 시 확인할 수 있습니다. 카드 데이터나 키는 기록되지 않습니다.
요구 사항
OpenCart 3.0.x(3.0.5.0에서 테스트됨) 또는 4.0.2 이상(4.1.0.3에서 테스트됨), PHP 8.0 이상. 다운로드 하나에 두 버전용 패키지가 모두 들어 있습니다. 쇼핑몰에 설정된 칠레 페소(CLP) 통화, 소수점 자리수 0. 실결제를 하려면 Transbank에서 받은 운영용 Webpay Plus 커머스 코드(Commerce Code)와 API Key Secret이 필요합니다. vibefox.net에서 받은 VibeFox 라이선스 키(도메인 하나당 키 하나).