개요
VibeFox PagSeguro Gateway는 브라질의 쇼핑몰을 위해 OpenCart 3과 OpenCart 4를 PagBank(PagSeguro) Checkout API에 연결합니다. 고객은 체크아웃의 마지막 단계에서 Confirm Order를 클릭한 뒤 PagBank 결제 페이지로 이동하며, PagBank 계정에서 활성화된 결제 수단(예: 신용카드, PIX 또는 boleto)으로 결제합니다. 결제는 브라질 레알(BRL)로만 가능합니다. OpenCart는 결제 전에 주문을 생성하지만, 주문은 PagBank가 결제를 보고한 후에야 상태를 받습니다. 따라서 결제되지 않은 시도는 누락 주문으로 남습니다.
이 확장 기능은 OpenCart 주문 페이지에서 환불하면서 PagBank의 호스팅 결제 페이지를 사용하려는 브라질 쇼핑몰에 적합합니다. 쇼핑몰 안에는 카드 입력 양식이 없으며, 저장된 카드, 구독 또는 정기 결제, 분할 결제도 지원하지 않습니다. 결제 수단과 할부는 귀하의 PagBank 계정에서 설정된 것을 따릅니다.
주요 기능
PagBank 결제 페이지: 주문 합계를 BRL로 결제하는 하나의 체크아웃입니다. 결제 페이지는 120분 후 만료됩니다.
PagBank가 확인한 경우에만 결제 완료: 알림과 고객의 복귀는 확인 절차만 시작합니다. 체크아웃, PagBank 주문 및 그 청구는 결제가 생성된 환경의 토큰을 사용해 항상 PagBank API에서 읽어 옵니다.
서명된 알림: PagBank가 x-authenticity-token 헤더를 보내면 귀하의 토큰으로 확인합니다. 유효하지 않은 서명은 거부됩니다.
금액 및 통화 확인: 청구된 금액(PagBank 할부 이자 제외)과 통화를 주문과 비교합니다. 차이가 있거나 취소 후에 결제가 이루어지면 주문은 메모와 함께 검토 상태가 됩니다.
boleto, PIX 및 심사: 발급된 boleto나 PIX 또는 심사 중인 결제는, PagBank가 결제 완료를 보고할 때까지 주문을 대기 상태로 둡니다.
하나의 장바구니, 하나의 결제: 고객이 다시 결제하면 열려 있는 PagBank 체크아웃을 재사용하거나 먼저 비활성화합니다. 이전 페이지에서 이루어진 결제도 여전히 유효하며, 두 번째 결제는 환불 대상으로 표시됩니다.
주문 페이지에서 환불: 주문의 VibeFox PagSeguro Gateway 탭에서 PagBank가 실제로 청구한 금액까지 전액 및 부분 환불이 가능합니다. PagBank 대시보드에서 이루어진 환불은 주문에 기록됩니다.
샌드박스와 운영: 토큰이 분리되어 있습니다. 상태 확인과 환불은 항상 결제의 환경을 사용합니다. 각 경우에 대해 고유한 OpenCart 주문 상태를 설정할 수 있습니다.
요구 사항
OpenCart 3.0.x(3.0.5.0에서 테스트됨) 또는 4.0.2 이상(4.1.0.3에서 테스트됨), PHP 8.0 이상. 이 다운로드에는 두 버전용 패키지가 모두 들어 있습니다. 쇼핑몰에 브라질 레알(BRL) 통화가 설정되어 있어야 합니다. 운영 토큰과 테스트용 샌드박스 토큰이 있는 PagBank 계정. vibefox.net에서 받은 VibeFox 라이선스 키(도메인 하나당 키 하나).