개요
VibeFox Niubiz Payment는 Niubiz의 공식 결제 양식(Botón de pago web)을 통한 페루 카드 결제를 PrestaShop에 추가합니다. 결제 단계에서 고객은 Niubiz를 선택하고 쇼핑몰의 결제 페이지로 이동하며, 그곳에서 Niubiz 양식이 열립니다. 고객은 Niubiz 양식에 카드를 입력하고, 쇼핑몰은 서버에서 결제를 승인합니다. 카드 정보는 쇼핑몰 사이트를 거치지 않습니다. 주문은 Niubiz가 응답한 뒤에만 생성되므로, 중간에 포기하거나 거절된 결제로 미결제 주문이 남지 않습니다.
PEN(페루 솔) 또는 USD(미국 달러)로 판매하고 Niubiz 가맹점 제휴가 있는 페루의 쇼핑몰에 적합합니다. 이 모듈은 일회성 카드 결제만 받습니다. PrestaShop에서의 환불이나 취소는 지원하지 않으며, 저장된 카드, 구독, 할부(cuotas), PagoEfectivo, Yape, QR 결제도 지원하지 않습니다.
주요 기능
Niubiz 결제 양식: Niubiz 제휴에서 허용하는 카드에 따라 Visa, Mastercard, American Express, Diners Club를 지원합니다. 양식에는 쇼핑몰 이름 또는 직접 설정한 로고가 표시됩니다.
Niubiz가 승인한 경우에만 결제 완료: Niubiz가 승인을 확인하고 응답이 장바구니(구매 번호, 금액, 통화)와 일치할 때만 주문이 Payment accepted 상태가 됩니다. 일치하지 않으면 주문은 메모와 함께 Niubiz payment on hold 상태가 됩니다.
응답이 유실되어도 안전: Niubiz에서 시간 초과가 발생하거나 응답을 읽을 수 없으면, 확인이 필요한 구매 번호와 함께 Niubiz payment on hold 상태의 주문이 생성되며, 고객에게는 다시 결제하지 말라는 안내가 표시됩니다.
카드 거절: 주문은 생성되지 않습니다. 고객은 결제 페이지에서 Niubiz의 사유를 확인할 수 있고, 즉시 다른 카드로 다시 시도할 수 있습니다. 시도할 때마다 새로운 구매 번호가 부여됩니다.
중복 처리 방지: 양식을 반복하거나 동시에 제출해도 승인이 두 번 이루어지지 않으며, 두 번째 주문이 생성되지 않습니다. 양식을 연 뒤 장바구니가 변경되면 카드에 청구되지 않습니다.
샌드박스 및 운영 환경: 환경마다 별도의 자격 증명을 사용합니다. 샌드박스 모드에서는 API 엔드포인트와 자격 증명이 모두 전환되며, 진행 중인 결제는 시작된 환경에 그대로 남습니다.
주문 페이지의 Niubiz 블록: 구매 번호, 환경, 거래 ID, 승인 코드, 마스킹된 카드 정보, 주문의 Niubiz 메모. 자격 증명, 토큰, 카드 또는 고객 데이터가 없는 선택형 로그를 제공합니다.
요구 사항
PrestaShop 8.0 ~ 9.x, PHP 8.0 이상. 장바구니 통화는 PEN 또는 USD. Niubiz 샌드박스 및 운영 자격 증명(merchant ID, API user, API password). Webhook은 필요하지 않습니다. vibefox.net에서 받은 VibeFox 라이선스 키(도메인 하나당 키 하나).