개요
VibeFox Midtrans Payment Gateway는 인도네시아 루피아(IDR)로 Midtrans Snap 결제를 PrestaShop에 추가합니다. 결제 단계에서 고객은 Midtrans를 선택하고 Midtrans Snap 결제 페이지로 이동하여, Midtrans 계정에서 활성화된 결제 수단 중 원하는 방법으로 결제합니다. GoPay, QRIS, ShopeePay, 카드, 은행 가상계좌, 편의점 결제 등이 포함됩니다. 주문은 Midtrans가 결제를 확인한 후에만 생성되므로, 결제를 중간에 포기해도 미결제 주문이 남지 않습니다.
IDR로 판매하면서 모든 Midtrans 결제 수단을 하나의 결제 수단으로 묶고 싶은 인도네시아 쇼핑몰에 적합합니다. 이 모듈은 IDR만 지원하며 통화 환산은 하지 않습니다. Snap 팝업, 쇼핑몰 사이트의 카드 입력 양식, 카드 저장, 할부 또는 프로모션 설정, 구독은 제공하지 않으며, 승인(authorize)과 캡처를 나누는 기능도 없습니다.
주요 기능
Snap Redirect: Midtrans 계정의 모든 결제 수단을 제공하는 하나의 Midtrans 결제 페이지. 장바구니 금액을 정수 루피아 단위로, 주문 항목, 배송비, 할인, 세금을 포함하여 처리합니다.
Midtrans 확인 시에만 결제 완료로 표시: 각 결제 알림의 서명을 검증하고, 상태를 Midtrans 상태 API에서 다시 조회한 뒤, 결제 금액과 통화를 장바구니와 대조합니다. 일치하지 않으면 주문은 메모와 함께 Midtrans payment on hold 상태가 됩니다.
지연 결제: 가상계좌와 편의점 결제는 Awaiting Midtrans payment 상태의 주문을 생성합니다. Midtrans가 결제를 알리면 결제 완료 상태가 되고, 결제 기한이 지나면 취소됩니다.
안전한 재시도: 같은 금액의 미사용 또는 대기 중인 Snap이 있으면 재사용합니다. 중복 알림이나 고객의 복귀로 주문이 두 번 만들어지거나 결제가 두 번 기록되는 일은 없습니다. 이미 결제된 주문에 대한 두 번째 결제는 메모로 표시됩니다.
Sandbox 및 Production: 환경별로 별도의 Server Key를 사용합니다. 각 결제는 자신이 이루어진 환경을 기억하므로, 실서비스 전환 후에도 샌드박스 결제의 환불과 알림은 계속 작동합니다.
양방향 환불: 주문의 Midtrans payment 블록에서 정수 루피아 단위로 전액 및 부분 환불이 가능합니다. Midtrans 대시보드에서 처리한 환불은 자동으로 주문에 기록됩니다.
원하는 주문 상태: 결제 확인 후 Payment accepted, Delivered, Midtrans payment on hold 중에서 선택할 수 있습니다. 주문 번호 접두어를 사용하면 여러 쇼핑몰이 하나의 Midtrans 계정을 공유할 수 있습니다.
주문 페이지의 Midtrans 블록: Midtrans 대시보드 링크가 포함된 거래 정보, 결제 수단, 환불 내역, 메모를 표시합니다. 키나 고객 데이터 없이 기록되는 선택 로그를 사용할 수 있습니다.
요구 사항
PrestaShop 8.0 ~ 9.x, PHP 8.0 이상. 쇼핑몰에 IDR 통화가 설정되어 있어야 합니다. Sandbox와 운영 Server Key를 갖추고, Midtrans 대시보드에 결제 알림 URL을 설정한 Midtrans 계정. vibefox.net에서 받은 VibeFox 라이선스 키(도메인 하나당 키 하나).