개요
VibeFox Moyasar Payment Gateway는 Moyasar의 호스팅 결제 페이지를 통한 결제를 OpenCart 3 및 OpenCart 4에 추가합니다. 마지막 결제 단계에서 고객이 Confirm Order를 클릭하면 주문을 위해 생성된 Moyasar 결제 페이지로 이동하고, mada, Visa, Mastercard, Apple Pay, STC Pay 또는 Moyasar 계정에서 활성화된 다른 방법으로 결제한 뒤 쇼핑몰로 돌아옵니다. OpenCart는 결제 전에 주문을 생성하지만, 주문은 Moyasar가 결제를 확인한 후에야 상태를 받으므로 결제되지 않은 시도는 누락 주문으로 남습니다.
Moyasar 계정으로 현지 및 해외 결제를 받으려는 사우디아라비아와 GCC 국가의 쇼핑몰에 적합합니다. 이 확장 프로그램은 일회성 결제만 지원합니다. 자체 결제 화면에 카드 입력 양식이 없으며, 저장된 카드, 구독, 승인과 캡처의 분리도 지원하지 않습니다. Moyasar 페이지에 표시되는 결제 수단은 확장 프로그램이 아니라 Moyasar 계정에서 설정합니다.
주요 기능
Moyasar 결제 페이지: 주문 통화(SAR, AED, USD, EUR, KWD, BHD 또는 OMR)로 주문 총액에 대한 인보이스가 생성됩니다. 소수점 셋째 자리까지 쓰는 통화는 fils로 올바르게 변환됩니다.
Moyasar가 확인한 경우에만 결제 완료: 확장 프로그램은 주문 상태를 설정하기 전에 비밀 키로 Moyasar API에서 인보이스를 읽습니다. 고객의 복귀, 인보이스 알림, 선택 사항인 웹훅도 같은 방식으로 검증됩니다. 이후 OpenCart는 일반적인 주문 이메일을 보냅니다.
금액 및 통화 확인: 결제된 금액과 통화를 주문과 비교합니다. 불일치가 있으면 주문은 메모와 함께 검토 상태가 됩니다.
중복 처리 없음: 확인 메시지가 동시에 도착해도 각 결제는 한 번만 적용됩니다. 새로운 시도는 장바구니의 열려 있는 결제 페이지를 재사용하거나 취소하므로, 두 번 결제될 수 없습니다.
테스트 및 실제 모드: 모드마다 별도의 비밀 키를 사용합니다. 모든 결제는 결제가 이루어진 모드의 키로 확인되고 환불됩니다.
주문 페이지에서 환불: 주문의 VibeFox Moyasar Payment Gateway 탭에서 전액 및 부분 환불이 가능하며, Moyasar가 청구한 금액을 초과할 수 없습니다. 2시간 이내에 이루어진 카드 결제의 전액 환불은 취소(void)로 전송됩니다. Moyasar 대시보드에서 이루어진 환불은 주문에 메모로 기록됩니다.
자체 주문 상태: 결제 완료 주문, Moyasar가 검토 중인 결제, 보류된 결제, 결제 오류, 전액 환불에 대해 OpenCart 상태를 선택할 수 있습니다.
OpenCart 조건: 지역(Geo Zone), 최소 주문 금액, 정렬 순서. 키, 카드 정보, 고객 정보가 없는 로그를 기록합니다.
요구 사항
OpenCart 3.0.x(3.0.5.0에서 테스트됨) 또는 OpenCart 4.0.2 이상(4.1.0.3에서 테스트됨), PHP 8.0 이상. 다운로드 파일 하나에 두 버전용 패키지가 모두 들어 있습니다.비밀 API 키가 있는 Moyasar 계정. Moyasar 대시보드에서 웹훅을 설정하는 것을 권장합니다. vibefox.net에서 발급받은 VibeFox 라이선스 키(도메인당 키 하나).