개요
VibeFox MercadoPago Gateway는 MercadoPago Checkout API를 통해 OpenCart 3 및 OpenCart 4에 신용카드 및 체크카드 결제를 추가합니다. 대상 계정은 아르헨티나, 브라질, 칠레, 콜롬비아, 멕시코, 페루, 우루과이의 MercadoPago 계정입니다. Confirm Order 단계에서 고객은 MercadoPago가 제공하는 보안 MercadoPago.js 필드에 카드 정보를 입력하므로 카드 데이터는 쇼핑몰 사이트에 전달되지 않습니다. MercadoPago는 카드를 일회용 토큰으로 바꾸고, 쇼핑몰은 서버에서 결제를 생성합니다. OpenCart는 결제 전에 주문을 생성하지만, 주문은 MercadoPago가 응답한 뒤에야 상태를 얻습니다. 따라서 거절된 카드는 상태가 없는 주문을 남깁니다.
MercadoPago 계정의 통화로 판매하면서 자체 결제 페이지에 카드 입력 양식을 표시하고 할부 결제도 제공하려는 쇼핑몰에 적합합니다. 이 확장 기능은 카드 결제만 받습니다. Checkout Pro 리디렉션, MercadoPago 월렛, 현금, Pix, PSE, Yape 결제는 지원하지 않으며, 저장된 카드나 구독, 승인과 매입의 분리, 통화 환전도 지원하지 않습니다.
주요 기능
결제 페이지의 카드 입력 양식: 카드 번호, 유효기간, 보안 코드는 MercadoPago 필드에 입력하며, 카드 소유자 이름, 국가에서 요구하는 경우의 소유자 신분증 정보, 필요한 경우의 카드 발급사, 그리고 주문 금액에 대해 MercadoPago가 제공하는 할부(cuotas, parcelas)를 선택할 수 있습니다. 할부 개월 수는 Maximum installments 설정으로 제한됩니다.
MercadoPago가 확인한 경우에만 결제 완료 처리: 금액과 통화가 일치하는 승인된 결제만 설정하신 결제 완료 상태로 바뀝니다. 검토 중인 결제는 MercadoPago 알림이 처리를 마칠 때까지 자체 상태로 대기합니다. 금액이 일치하지 않으면 주문은 메모와 함께 검토 상태가 됩니다. 이후 OpenCart는 일반적인 주문 이메일을 발송합니다.
안전한 알림 처리: 주문이 변경되기 전에 모든 알림을 MercadoPago API에서 다시 조회하며, 선택 사항으로 x-signature 서명 검증도 수행합니다.
이중 청구 방지: 장바구니별 잠금, 카드 토큰별 멱등성 키, 유실된 응답 조회를 통해 더블 클릭, 두 번째 탭, 시간 초과로 인한 이중 청구를 막습니다. 이미 결제된 장바구니에는 다시 청구하지 않습니다.
테스트 모드와 운영 모드: TEST- 및 APP_USR- 자격 증명을 각각 사용하며, 저장할 때 접두사와 계정 국가를 확인합니다. 환불과 알림은 결제가 이루어진 모드의 자격 증명을 사용합니다.
주문 페이지에서 환불: 주문의 VibeFox MercadoPago Gateway 탭에서 실제 청구된 금액까지 전액 환불과 부분 환불을 할 수 있으며, 결제 정보, 환불 내역, MercadoPago 메모를 함께 확인할 수 있습니다. 전액 환불을 하면 상태가 Refunded로 설정됩니다.
자체 주문 상태 및 OpenCart 조건: 결제 완료 주문, MercadoPago에서 검토 중인 결제, 보류된 결제, 실패한 결제, 취소된 주문, 환불된 주문에 대해 OpenCart 상태를 선택할 수 있습니다. 지역 구역, 최소 주문 금액, 정렬 순서를 설정할 수 있습니다. 토큰, 카드 또는 결제자 데이터 없이 로그를 기록합니다.
요구 사항
OpenCart 3.0.x(3.0.5.0에서 테스트됨) 또는 OpenCart 4.0.2 이상(4.1.0.3에서 테스트됨), PHP 8.0 이상. 하나의 다운로드에 두 버전용 패키지가 모두 들어 있습니다.MercadoPago 계정 통화와 같은 쇼핑몰 통화가 활성화되어 있어야 합니다(ARS, BRL, CLP, COP, MXN, PEN 또는 UYU). 테스트 및 운영용 Public Key와 Access Token이 있는 MercadoPago 애플리케이션. vibefox.net에서 받은 VibeFox 라이선스 키(도메인당 키 하나).