개요
VibeFox MercadoPago Gateway는 아르헨티나, 브라질, 칠레, 콜롬비아, 멕시코, 페루, 우루과이를 위해 MercadoPago Checkout API를 통한 카드 결제를 PrestaShop에 추가합니다. 고객은 결제 단계에서 MercadoPago 보안 입력란에 카드 정보를 입력하고, 쇼핑몰은 서버에서 일회용 카드 토큰으로 결제를 실행합니다. 카드 데이터는 사이트에 전달되지 않습니다. 주문은 MercadoPago가 응답한 후에만 생성되므로, 거절된 카드로 미결제 주문이 남지 않습니다.
자체 체크아웃 페이지에서 할부가 포함된 카드 양식을 제공하려는 라틴 아메리카 쇼핑몰에 적합합니다. 이 모듈은 신용카드와 체크카드만 받습니다. Checkout Pro 리디렉션, MercadoPago 월렛, 현금, Pix, PSE, Yape 결제, 저장된 카드나 구독, 승인과 캡처의 분리, 3-D Secure 인증, 통화 변환은 지원하지 않습니다.
주요 기능
보안 카드 입력란: 카드 번호, 유효기간, 보안 코드는 결제 단계에서 MercadoPago 입력란에 입력합니다. 국가에서 요구하는 경우 카드 발급사와 카드 소유자 문서(DNI, CPF, RUT, CC 등)도 입력합니다.
할부: 장바구니 금액에 대해 MercadoPago가 반환하는 할부 옵션과 이자를 표시합니다. 설정한 최대 할부 개월 수는 서버에서도 적용됩니다.
MercadoPago가 확인한 경우에만 결제 완료: 승인된 각 결제의 금액과 통화를 장바구니와 비교합니다. 차이가 있으면 주문은 메모와 함께 MercadoPago payment on hold 상태가 됩니다.
결제 알림: 검토 중인 결제는 Awaiting MercadoPago payment 상태로 대기하다가 자동으로 완료됩니다. 각 결제는 MercadoPago API에서 다시 조회됩니다. 선택적 서명 확인을 지원합니다.
이중 청구 없음: 주문이 있는 장바구니는 다시 청구되지 않으며, 같은 카드 토큰은 항상 같은 멱등성 키를 사용합니다. 시간 초과 후 다음 시도에서는 먼저 결제를 조회합니다.
테스트 및 실서비스 자격 증명: 키를 따로 관리하며, 저장할 때 접두사와 계정 국가를 확인합니다. 환불은 항상 결제할 때 사용한 자격 증명으로 처리됩니다.
주문 페이지에서 환불: 주문의 MercadoPago payment 블록에서 MercadoPago가 청구한 금액 한도 내에서 전액 및 부분 환불이 가능합니다. 전액 환불하면 주문이 Refunded 상태가 됩니다.
주문 페이지의 MercadoPago 블록: 결제 ID, 상태, 할부 개월 수, 환불 내역, 모듈 메모를 표시합니다.
요구 사항
PrestaShop 8.0–9.x, PHP 8.0 이상. 테스트 및 실서비스 자격 증명(Public Key와 Access Token)이 있는 MercadoPago 애플리케이션. 쇼핑몰 통화는 MercadoPago 계정 국가의 통화와 같아야 합니다. vibefox.net에서 받은 VibeFox 라이선스 키(도메인 하나당 키 하나).