개요
VibeFox PagSeguro Gateway는 PagBank Checkout API를 통해 PrestaShop을 PagBank(구 PagSeguro)와 연결합니다. 결제 단계에서 고객이 PagBank를 선택하면, 모듈은 장바구니 금액과 정확히 같은 금액으로 PagBank 결제를 만들고 고객을 PagBank 결제 페이지로 보냅니다. 고객은 그곳에서 PagBank 계정에 활성화된 결제 수단(신용카드, PIX 또는 boleto 등)으로 결제한 뒤 쇼핑몰로 돌아갑니다. 결제는 브라질 레알(BRL)로만 받을 수 있습니다. 주문은 PagBank가 결제를 확인한 후에만 생성되므로, 중단된 결제로 인해 미결제 주문이 남지 않습니다.
PagBank의 호스팅 결제 페이지를 사용하면서 PrestaShop 주문 페이지에서 환불도 처리하고 싶은 브라질 쇼핑몰에 적합합니다. 이 모듈에는 사이트 내 카드 입력 양식, 카드 저장, 구독이나 정기 결제, 분할 결제 기능이 없습니다. 결제 수단과 할부는 PagBank 계정에서 설정한 것을 사용하며, 모듈에서 선택하지 않습니다.
주요 기능
PagBank 호스팅 결제 페이지: 카드 정보가 서버에 저장되지 않습니다. 쇼핑몰에 고객의 이름, 이메일, 브라질 전화번호, CPF/CNPJ 정보가 있으면 PagBank 페이지에 자동으로 채워집니다.
PagBank가 확인한 경우에만 결제 완료: 알림과 고객의 복귀는 API를 통해 결제와 PagBank 주문(상태, 센타보 단위 금액, 통화)을 읽어 확인합니다. 서명이 올바르지 않은 알림은 거부됩니다.
PagBank에서 설정할 것이 없음: 알림 URL은 모든 결제와 함께 전송됩니다.
금액 확인: 결제 금액이나 통화가 장바구니와 일치하지 않으면 메모와 함께 PagBank payment on hold로 보류됩니다. 고객이 부담한 할부 이자도 반영됩니다.
명확한 상태: 결제가 완료된 주문은 Payment accepted로, 생성된 PIX 또는 boleto와 검토 중인 결제는 Awaiting PagBank payment로 이동합니다. 나중에 거절된 결제는 Payment error로, 취소된 결제는 Canceled로 이동합니다.
중복 결제 방지: 다시 결제하면 열린 PagBank 결제를 재사용하거나 이전 결제를 비활성화합니다. 반복된 알림과 복귀로 두 번째 주문이 생성되거나 결제가 두 번 기록되지 않습니다.
샌드박스와 운영 환경: 토큰이 각각 다릅니다. 주문의 상태 확인과 환불은 항상 그 결제가 이루어진 환경을 사용합니다.
주문 페이지에서 환불: PagBank payment 블록에서 전액 및 부분 환불을 할 수 있으며, PagBank가 청구한 금액까지 가능합니다. PagBank가 확인한 경우에만 기록됩니다. 전액 환불 시 주문은 Refunded로 변경됩니다.
요구 사항
PrestaShop 8.0~9.x, PHP 8.0 이상. 장바구니 통화는 브라질 레알(BRL). 인터넷에서 HTTPS로 접속 가능한 쇼핑몰. 운영 토큰이 있는 PagBank 계정과 테스트용 샌드박스 토큰. vibefox.net에서 구매한 VibeFox 라이선스 키(도메인당 키 하나).