개요
VibeFox Adyen Gateway는 Adyen 결제 링크(Adyen Payment Links)를 통한 결제를 PrestaShop에 추가합니다. 결제 단계에서 고객은 Adyen을 선택하고, Adyen이 호스팅하는 결제 페이지로 이동하여, Adyen 가맹점 계정에서 활성화된 모든 수단(카드, 전자 지갑 및 현지 결제 수단)으로 결제한 다음 쇼핑몰로 돌아옵니다. 카드 정보는 쇼핑몰 사이트를 거치지 않습니다. 주문은 Adyen이 서명된 웹훅으로 결제를 확인한 후에만 생성되므로, 결제를 중단한 경우 미결제 주문이 남지 않습니다.
이 모듈은 Adyen 가맹점 계정이 있고, 자체 사이트에 결제 양식을 만들지 않고 그 계정의 결제 수단을 사용하려는 쇼핑몰에 적합합니다. 모듈에는 구독이나 정기 결제, 저장된 카드, 사이트 내 카드 입력 필드(Drop-in 또는 Components), PrestaShop의 캡처 또는 취소 버튼이 없습니다. 캡처는 Adyen 계정 설정을 따릅니다.
주요 기능
Adyen Payment Links: 장바구니 합계에 대해 장바구니 통화로 결제 링크를 생성하며, 각 통화에 대해 Adyen이 요구하는 최소 단위를 사용합니다(JPY, KRW, IDR 등은 소수점 없음, KWD, BHD 등은 소수점 3자리).
Adyen이 확인한 후에만 결제 처리: 주문은 HMAC 서명된 AUTHORISATION 웹훅으로만 생성됩니다. 쇼핑몰로 돌아온다고 해서 주문이 생성되거나 결제되지는 않습니다.
금액 및 통화 검증: Adyen이 확인한 금액과 통화를 장바구니와 비교합니다. 불일치하면 주문이 수동 검토를 위해 Adyen payment on hold 상태가 되고 메모가 추가됩니다.
중복 처리 방지: 반복되거나 동시에 도착한 웹훅 전송으로 두 번째 주문이 생성되거나 결제가 두 번 기록되지 않습니다. 새 결제 시도는 이전 결제 링크를 만료시키며, 이미 결제된 주문에 두 번째 성공 결제가 들어오면 경고 메모가 추가됩니다.
테스트 모드 및 운영 모드: 환경마다 별도의 API 키와 HMAC 키를 사용합니다. 환불은 항상 결제가 이루어진 환경과 가맹점 계정으로 전송됩니다.
주문 페이지에서 환불: 주문의 Adyen payment 블록에서 전액 또는 부분 환불을 할 수 있으며, 금액과 통화는 Adyen이 청구한 것과 같습니다. Adyen이 웹훅으로 결과를 확인합니다. 전액 환불하면 주문이 Refunded 상태가 됩니다.
원하는 주문 상태: 결제 성공 후 수동 검토를 위해 Payment accepted, Delivered 또는 Adyen payment on hold 중 하나를 선택할 수 있습니다.
주문 페이지의 Adyen 블록: PSP 참조 번호, 결제 링크, 가맹점 계정, 금액 및 환불 내역. API 키나 고객 개인 정보가 없는 로그.
요구 사항
PrestaShop 8.0 ~ 9.x, PHP 8.0 이상. API 키가 있는 Adyen 가맹점 계정, HMAC 키가 있는 Standard 웹훅, 그리고 운영 결제의 경우 운영 URL 접두사. vibefox.net에서 받은 VibeFox 라이선스 키(도메인당 키 1개).