개요
VibeFox Omise Payment는 Omise(Opn Payments)를 통한 Visa, Mastercard, JCB 카드 결제를 PrestaShop에 추가합니다. 고객은 체크아웃의 결제 단계에 있는 카드 입력 양식에 카드를 입력합니다. Omise.js가 브라우저에서 카드 데이터를 Omise로 직접 전송하므로, 쇼핑몰은 일회용 토큰만 받고 서버에서 결제(청구)가 생성됩니다. 3-D Secure는 은행으로 이동했다가 쇼핑몰로 돌아오는 방식으로 처리됩니다. 주문은 Omise가 응답한 후에만 생성되므로, 거절된 카드는 실패한 주문을 남기지 않습니다.
태국, 일본, 싱가포르, 말레이시아 및 Omise가 지원하는 기타 시장의 쇼핑몰에 적합하며, 선택적 수동 캡처와 PrestaShop 주문 페이지에서의 환불을 포함한 카드 결제를 원하는 경우에 사용할 수 있습니다. 이 모듈은 카드 결제만 지원합니다. PromptPay, TrueMoney, 모바일 뱅킹, 할부 등 다른 Omise 결제 수단은 지원하지 않으며, 저장된 카드와 구독도 지원하지 않습니다. 부분 캡처도 지원하지 않습니다.
주요 기능
Omise.js 카드 양식: 결제 단계에서 카드 명의자, 카드 번호, 유효기간, 보안 코드를 입력합니다. 카드 정보는 쇼핑몰로 절대 전송되지 않습니다.
Omise 확인 후에만 결제 완료 처리: 결제 정보는 항상 Omise API에서 다시 읽으며, 금액과 통화를 장바구니와 비교합니다. 일치하지 않으면 주문은 메모와 함께 Omise payment on hold 상태가 됩니다.
3-D Secure와 웹훅: 고객이 3-D Secure 후 돌아오지 않으면 웹훅이 주문을 생성하며, Omise 대시보드에서 이루어진 캡처도 반영합니다. 웹훅 본문은 신뢰하지 않습니다.
즉시 캡처 또는 승인만: 승인된 주문은 주문의 Omise 블록에서 Capture payment 또는 Void authorization을 클릭할 때까지 Omise payment authorized 상태로 남습니다.
중복 청구 방지: 반복된 웹훅이나 반환이 두 번째 주문을 만들거나 결제를 두 번 기록하지 않습니다. 재시도는 이전에 결제된 청구로 주문을 완료하며, 완료되지 않은 3-D Secure 시도는 새 청구 전에 만료됩니다.
주문 페이지에서 환불: Omise가 청구한 금액과 통화로 전액 환불과 부분 환불을 할 수 있으며, 환불 내역도 기록됩니다. 캡처되지 않은 승인의 전액 환불은 승인을 취소합니다.
테스트 모드와 운영 모드: 키가 별도로 구분됩니다. 캡처, 환불, 상태 확인은 항상 주문이 결제된 모드의 키를 사용합니다. Sync payment status는 요청 시 청구를 다시 읽습니다.
13개 통화: THB, JPY, SGD, MYR, USD, EUR, GBP, AUD, CAD, CHF, CNY, DKK, HKD이며, JPY는 소수점 없이 처리합니다. 키, 토큰, 카드 데이터를 제외한 선택적 로그를 기록합니다.
요구 사항
PrestaShop 8.0 ~ 9.x, PHP 8.0 이상. 테스트 모드와 운영 모드용 공개 키와 비밀 키가 있는 Omise 계정과 Omise 대시보드의 웹훅(HTTPS). vibefox.net에서 발급받은 VibeFox 라이선스 키(도메인당 하나).