개요
VibeFox Iugu Gateway는 브라질의 쇼핑몰을 위해 OpenCart 3 및 OpenCart 4에 Iugu 결제를 추가합니다. 마지막 체크아웃 단계에서 고객이 Confirm Order를 클릭하면, 확장 프로그램이 Iugu 청구서를 생성하고 고객을 Iugu 청구서 페이지로 보냅니다. 고객은 그곳에서 신용카드, boleto 또는 PIX로 결제합니다. OpenCart는 결제 전에 주문을 생성하지만, 주문은 Iugu API에서 청구서를 다시 읽어 온 후에야 상태를 얻습니다. 따라서 결제되지 않은 시도는 누락된 주문으로 남습니다.
브라질 헤알로 판매하면서, 자체 사이트에 결제 양식을 두지 않고 카드, boleto, PIX 결제를 받고 싶은 쇼핑몰에 적합합니다. 이 확장 프로그램은 일회성 결제만 지원합니다. 사이트 내 카드 양식, 저장된 카드, 구독, carnê(할부 납부서), 분할 결제는 지원하지 않습니다.
주요 기능
Iugu 청구서 페이지: 주문 금액에 대한 BRL 청구서 1건을 생성하며, 기한은 3일이고, Iugu 계정에서 활성화된 방법(신용카드, boleto, PIX)으로 결제할 수 있습니다.
Iugu가 확인한 경우에만 결제 완료: 알림에는 쇼핑몰이 신뢰할 수 있는 결제 데이터가 포함되지 않습니다. 청구서는 항상 Iugu API에서 다시 읽으며, 금액과 통화를 주문과 비교합니다. 불일치하면 주문은 메모와 함께 검토 상태가 됩니다. 이후 OpenCart가 일반적인 주문 이메일을 발송합니다.
Boleto와 PIX: boleto 또는 PIX 코드를 생성한 고객은 입금 대기 상태를 받습니다. Iugu가 입금을 보고하면 주문은 결제 완료 상태로 바뀝니다.
중복 처리 방지: 반복되는 알림과 복귀는 결제를 두 번 적용하지 않습니다. 하나의 장바구니는 한 번만 결제됩니다. 새 청구서를 만들기 전에, 장바구니의 미결 청구서는 재사용되거나 Iugu에서 취소됩니다.
테스트 및 라이브 토큰: 모드별로 별도의 API 토큰을 사용합니다. 상태 조회와 환불은 항상 청구서가 생성된 모드의 토큰을 사용합니다.
주문 페이지에서의 환불: 주문의 VibeFox Iugu Gateway 탭에서 신용카드 전액 및 부분 환불, PIX 전액 환불을 할 수 있습니다. 환불은 Iugu가 확인한 경우에만 반영됩니다. 전액 환불을 하면 Refunded 상태가 설정됩니다.
자체 주문 상태: 결제 완료, 대기, 검토, 만료, 취소, 환불된 청구서에 대해 사용할 OpenCart 상태를 선택할 수 있습니다.
OpenCart 조건: 지역(Geo Zone), 최소 주문 금액, 정렬 순서. CPF/CNPJ는 CPF 또는 CNPJ라는 이름의 사용자 정의 필드에서 가져옵니다. 토큰이나 고객 데이터를 포함하지 않는 선택적 로그를 제공합니다.
요구 사항
OpenCart 3.0.x(3.0.5.0에서 테스트됨) 또는 OpenCart 4.0.2 이상(4.1.0.3에서 테스트됨), PHP 8.0 이상. 하나의 다운로드에 두 버전용 패키지가 모두 들어 있습니다. 쇼핑몰 통화로 브라질 헤알(BRL). 테스트 및 운영 API 토큰이 있는 Iugu 계정. vibefox.net에서 받은 VibeFox 라이선스 키(도메인당 키 1개).