개요
VibeFox Iugu Gateway는 브라질의 쇼핑몰을 위해 PrestaShop에 Iugu 결제를 추가합니다. 결제 단계에서 고객이 Iugu를 선택하면 모듈이 장바구니 합계에 대한 Iugu 청구서를 생성하고 고객을 Iugu 청구서 페이지로 보내며, 고객은 그곳에서 신용카드, boleto bancário 또는 PIX로 청구서를 결제합니다. 카드 정보는 귀하의 사이트를 거치지 않습니다. 주문은 Iugu가 결제를 알려왔을 때, 또는 고객이 발행된 boleto나 PIX를 가지고 돌아왔을 때에만 생성됩니다.
브라질 레알(BRL)로 판매하고 Iugu 계정이 있는 브라질 쇼핑몰에 적합합니다. 이 모듈은 일회성 결제만 지원합니다. PrestaShop에서 사이트 내 카드 입력 양식, 저장된 카드, 구독 또는 정기 결제, carnê(분할 납부 용지), 분할 결제, 할부 설정은 제공하지 않습니다.
주요 기능
Iugu 청구서 페이지: 장바구니 합계에 대해 BRL 청구서가 생성됩니다. 고객은 Iugu 계정에서 활성화된 모든 결제 수단(신용카드, boleto 또는 PIX)으로 결제할 수 있습니다.
Iugu가 확인한 경우에만 결제 완료: 알림과 고객의 복귀는 쇼핑몰에 확인할 청구서가 무엇인지만 알려줍니다. 청구서는 항상 Iugu API에서 다시 조회되며, 상태, 금액, 통화가 장바구니와 대조됩니다. 불일치하면 주문이 Iugu payment on hold 상태가 됩니다.
Iugu에서 설정할 것 없음: 모든 청구서에 쇼핑몰의 알림 URL이 포함됩니다.
이중 처리 방지: 각 청구서 상태는 한 번만 적용되므로, 반복되는 알림이나 복귀로 주문이 두 개 생기거나 결제가 두 번 기록되지 않습니다. 새로운 결제 시도는 열려 있는 청구서를 재사용하거나, 먼저 Iugu에서 해당 청구서를 취소합니다. 중복 결제는 환불 대상으로 표시됩니다.
boleto 및 PIX 지원: boleto 또는 PIX 코드를 가지고 돌아온 고객은 Awaiting Iugu payment 상태의 주문을 받게 되며, Iugu가 입금을 알려오면 Payment accepted로 바뀝니다.
테스트 및 운영 토큰: 모드마다 별도의 API 토큰을 사용합니다. 상태 조회와 환불은 항상 청구서가 생성된 모드의 토큰을 사용합니다.
주문 페이지에서 환불: 주문의 Iugu payment 블록에서 신용카드는 전액 또는 부분 환불, PIX는 전액 환불만 가능합니다. Iugu 대시보드에서 진행한 환불은 주문을 Refunded로 설정합니다.
주문 페이지의 Iugu 블록: Iugu 링크가 포함된 청구서, 결제 수단, 결제 금액과 환불 금액, 환불 내역, 모듈 메모를 표시합니다. 토큰이나 고객 데이터가 없는 선택 사항인 로그도 제공합니다.
요구 사항
PrestaShop 8.0 ~ 9.x, PHP 8.0 이상. 장바구니 통화는 브라질 레알(BRL)이어야 합니다. 테스트 및 운영 API 토큰이 있는 Iugu 계정. vibefox.net에서 구입한 VibeFox 라이선스 키(도메인당 키 1개).