개요
VibeFox Adyen Gateway는 Adyen Payment Links를 통한 결제를 OpenCart 3 및 OpenCart 4에 추가합니다. 마지막 체크아웃 단계에서 고객은 Confirm Order를 클릭하고, Adyen이 호스팅하는 결제 페이지로 이동하여 Adyen 가맹점 계정에서 활성화된 모든 방법(카드, 간편결제, 현지 결제 수단)으로 결제한 뒤 쇼핑몰로 돌아옵니다. 카드 정보는 쇼핑몰을 거치지 않습니다. OpenCart는 결제 전에 주문을 생성하지만, 주문은 Adyen이 서명된 웹훅으로 결제를 확인한 후에야 상태를 갖게 됩니다. 따라서 결제되지 않은 시도는 누락된 주문으로 남습니다.
Adyen 가맹점 계정이 있고, 자체 사이트에 결제 양식을 만들지 않고 해당 계정의 결제 수단을 사용하려는 쇼핑몰에 적합합니다. 이 확장 기능은 구독이나 정기 결제, 저장된 카드, 사이트 내 카드 입력란(Drop-in 또는 Components), OpenCart 내 승인(capture) 또는 취소 버튼을 제공하지 않습니다. 승인은 Adyen 계정 설정을 따릅니다.
주요 기능
Adyen Payment Links: 주문 통화로 된 주문 합계에 대해 결제 링크를 만들며, 각 통화에 대해 Adyen이 요구하는 최소 단위로 금액을 전달합니다(JPY, KRW, IDR처럼 소수점이 없는 통화, KWD, BHD처럼 소수점 셋째 자리까지 있는 통화).
Adyen이 확인한 경우에만 결제 완료: 주문 상태는 HMAC으로 서명된 AUTHORISATION 웹훅에 의해서만 설정됩니다. 쇼핑몰로 돌아오는 것만으로는 주문이 결제되지 않습니다. 이후 OpenCart가 일반 주문 이메일을 보냅니다.
금액 및 통화 확인: Adyen이 확인한 금액과 통화를 주문과 비교합니다. 불일치하면 주문은 메모와 함께 검토 상태가 됩니다.
이중 처리 방지: 반복되거나 병렬로 전달된 웹훅 때문에 결제가 두 번 기록되는 일은 없습니다. 새로운 결제 시도가 발생하면 해당 주문과 장바구니의 이전 결제 링크는 만료됩니다. 이미 결제된 주문에 두 번째 결제가 성공하면 경고 메모가 추가됩니다.
테스트 및 운영 모드: 환경별로 별도의 API 키와 HMAC 키를 사용합니다. 테스트 알림이 운영 결제를 확인하는 일은 없으며, 환불은 항상 결제가 이루어진 환경과 가맹점 계정으로 보내집니다.
주문 페이지에서의 환불: 주문의 VibeFox Adyen Gateway 탭에서 Adyen이 승인한 금액과 통화로 전액 및 부분 환불을 할 수 있습니다. 결과는 웹훅으로 Adyen이 확인합니다. 전액 환불을 하면 Refunded 상태가 설정됩니다.
자체 주문 상태: 결제 완료된 주문, 검토 중인 결제, 취소된 결제, 전액 환불 각각에 대해 OpenCart 상태를 선택할 수 있습니다.
OpenCart 조건 및 로그: 지역(Geo Zone), 최소 주문 합계, 정렬 순서. API 키나 구매자 개인정보가 포함되지 않는 로그를 제공합니다.
요구 사항
OpenCart 3.0.x(3.0.5.0에서 테스트) 또는 OpenCart 4.0.2 이상(4.1.0.3에서 테스트), PHP 8.0 이상. 두 버전용 패키지가 하나의 다운로드 파일에 들어 있습니다. API 키가 있는 Adyen 가맹점 계정, HMAC 키가 있는 Standard 웹훅, 그리고 운영 결제를 위한 라이브 URL 접두어. vibefox.net에서 받은 VibeFox 라이선스 키(도메인 하나당 키 하나).