개요
VibeFox Pagar.me Gateway는 브라질의 쇼핑몰을 위해 PrestaShop을 Pagar.me(Stone) Core API v5에 연결합니다. 결제 단계에서 고객이 Pagar.me를 선택하면 Pagar.me 결제 페이지로 이동하여 신용카드, PIX, boleto 또는 체크카드로 결제합니다. 카드 정보는 쇼핑몰을 거치지 않습니다. 결제는 브라질 레알(BRL)로만 이루어집니다. 주문은 Pagar.me가 결제를 확인하거나 PIX 또는 boleto를 발급한 후에만 생성되므로, 결제를 중단한 경우 미결제 주문이 남지 않습니다.
주요 현지 결제 수단을 하나의 호스팅 페이지에서 제공하고 PrestaShop 주문 페이지에서 환불도 처리하고 싶은 브라질 쇼핑몰에 적합합니다. 이 모듈은 체크아웃 안에 카드 입력 양식을 제공하지 않으며, 저장된 카드, 구독 또는 정기 결제, 할부 규칙, 분할 결제, 승인 전용 카드 결제, Pagar.me Hub 연동을 지원하지 않습니다.
주요 기능
Pagar.me 결제 페이지: 신용카드, PIX, boleto, 체크카드. 제공할 결제 수단과 boleto의 유효 기간(1~30일)을 선택할 수 있습니다.
Pagar.me 확인 시에만 결제 완료: 웹훅과 고객의 복귀는 확인할 Pagar.me 주문이 무엇인지 쇼핑몰에 알려 줄 뿐입니다. 그 후 비밀 키를 사용하여 Pagar.me API에서 주문을 읽습니다.
금액 및 통화 확인: 결제된 청구 금액을 장바구니 합계와 비교합니다. 금액 차이, 일부만 결제된 boleto, 취소 후의 결제가 있으면 주문은 메모와 함께 Pagar.me payment on hold 상태가 됩니다.
PIX 및 boleto: 발급된 PIX 또는 boleto는 Pagar.me가 결제를 확인할 때까지 주문을 Awaiting Pagar.me payment 상태로 생성합니다. 만료된 경우 주문은 Payment error 상태가 됩니다.
안전한 재결제: 고객이 다시 결제하면 열려 있는 결제 페이지를 재사용하거나, 먼저 Pagar.me에서 닫습니다. 이전 페이지에서 이루어진 결제도 여전히 장바구니와 연결되며, 두 번째 결제는 환불 대상으로 표시됩니다.
주문 페이지에서 환불: Pagar.me payment 블록에서 카드 및 PIX 결제를 전액 또는 부분 환불할 수 있습니다. 환불 금액은 Pagar.me가 실제로 청구한 금액까지입니다. Pagar.me에서 이루어진 환불과 차지백은 주문에 표시됩니다.
테스트 및 운영: 테스트용과 운영용 비밀 키가 분리되어 있습니다. 상태 조회와 환불은 항상 결제가 생성된 모드의 키를 사용합니다.
주문 페이지의 Pagar.me 블록: Pagar.me 주문, 결제 수단, 상태, 결제 금액과 환불 금액, 환불 내역, 주문의 Pagar.me 메모를 표시합니다. 키나 고객 데이터를 기록하지 않는 선택적 로그를 제공합니다.
요구 사항
PrestaShop 8.0~9.x, PHP 8.0 이상. 쇼핑몰 통화는 브라질 레알(BRL)이어야 합니다. 테스트용과 운영용 비밀 키 및 웹훅이 있는 Pagar.me 계정. vibefox.net에서 발급받은 VibeFox 라이선스 키(도메인당 키 1개).