개요
VibeFox Moyasar Payment Gateway는 Moyasar의 호스팅 결제 페이지를 통한 결제를 PrestaShop에 추가합니다. 결제 단계에서 고객은 Moyasar를 선택하고, 장바구니를 위해 생성된 Moyasar 결제 페이지로 이동하여 mada, Visa, Mastercard, Apple Pay, STC Pay 또는 Moyasar 계정에서 활성화된 다른 결제 수단으로 결제한 뒤 쇼핑몰로 돌아옵니다. 주문은 Moyasar가 결제를 확인한 후에만 생성되므로, 중간에 중단된 결제로 미결제 주문이 남지 않습니다.
Moyasar 계정으로 국내 및 국제 결제를 받고자 하는 사우디아라비아 및 GCC 지역 쇼핑몰에 적합합니다. 이 모듈은 일회성 결제만 지원합니다. 자체 체크아웃에는 카드 입력 양식이 없으며, 저장된 카드, 구독, 별도의 승인 및 매입(capture)은 지원하지 않습니다. Moyasar 페이지에 표시되는 결제 수단은 모듈이 아니라 Moyasar 계정에서 설정합니다.
주요 기능
Moyasar 결제 페이지: 장바구니 금액에 대해 장바구니 통화(SAR, AED, USD, EUR, KWD, BHD 또는 OMR)로 인보이스가 생성됩니다. 소수점 셋째 자리까지 쓰는 통화도 fils 단위로 올바르게 변환됩니다.
Moyasar가 확인한 경우에만 결제 완료: 모듈은 주문을 생성하기 전에 시크릿 키로 Moyasar API에서 인보이스를 조회합니다. 고객의 복귀, 인보이스 알림, 선택 사항인 웹훅도 같은 방식으로 검증됩니다.
금액 및 통화 확인: 결제된 금액과 통화를 장바구니와 비교합니다. 일치하지 않으면 주문이 메모와 함께 Moyasar payment on hold 상태가 됩니다.
중복 처리 방지: 확인 정보가 동시에 도착하더라도 각 결제는 한 번만 적용됩니다. 장바구니 금액이 변경되면 이전 결제 페이지가 닫힙니다.
테스트 모드와 실서비스 모드: 모드별로 별도의 시크릿 키를 사용합니다. 각 결제는 결제가 이루어진 모드의 키로 검증되고 환불됩니다.
주문 페이지에서 환불: Moyasar payment 블록에서 Moyasar가 청구한 금액 한도 내에서 전액 및 부분 환불이 가능합니다. 2시간 이내에 이루어진 카드 결제의 전액 환불은 취소(void)로 전송됩니다. Moyasar Dashboard에서 이루어진 환불은 주문에 기록됩니다.
원하는 주문 상태 선택: 결제가 성공하면 Payment accepted, Delivered 또는 Moyasar payment on hold 중 원하는 상태로 한 번의 상태 변경으로 설정됩니다.
주문 페이지의 Moyasar 블록: 인보이스, 결제, 카드, 환불 내역 및 모듈 메모를 표시합니다. 로그에는 키, 카드 정보, 고객 정보가 기록되지 않습니다.
요구 사항
PrestaShop 8.0 ~ 9.x, PHP 8.0 이상. 비밀 API 키가 있는 Moyasar 계정이 필요하며, Moyasar Dashboard에서 웹훅 설정을 권장합니다. vibefox.net에서 받은 VibeFox 라이선스 키(도메인 하나당 키 하나)가 필요합니다.