개요
VibeFox Eupago Gateway는 포르투갈용 Eupago 결제를 PrestaShop에 추가합니다. 체크아웃에서 Multibanco, MB WAY, 신용카드 중 하나의 결제 방법을 선택합니다. Multibanco를 선택하면 고객은 ATM 또는 인터넷뱅킹에서 결제할 수 있도록 기관 번호(entity)와 참조 번호를 받습니다. MB WAY를 선택하면 고객은 MB WAY 앱에서 결제 요청을 승인합니다. 신용카드를 선택하면 고객은 Eupago 카드 결제 페이지에서 결제한 뒤 쇼핑몰로 돌아옵니다.
유로로 판매하며 Eupago 계정이 있는 쇼핑몰에 적합합니다. 모듈은 설치당 하나의 Eupago 결제 방법만 제공하며, 일회성 결제만 지원합니다. PrestaShop에서의 환불(Eupago 백오피스에서 환불), 카드 저장, 구독, 사전 승인은 지원하지 않습니다. 또한 PayShop, Cofidis Pay, Bizum 등 다른 Eupago 결제 방법, SMS 알림, Multibanco 만료일, 상태 폴링도 지원하지 않습니다.
주요 기능
Multibanco, MB WAY 또는 카드: Multibanco 참조 번호는 주문 확인 페이지와 주문 확인 이메일에 표시됩니다. 체크아웃에서 MB WAY 전화번호를 입력받으며, 포르투갈 번호는 +351 없이 입력할 수 있습니다.
Eupago 확인 시에만 결제 완료: 주문은 검증된 Eupago 알림으로만 결제 완료 처리됩니다. 서명된 Webhook 2.0 또는 API 키로 인증된 기존 콜백이 해당합니다. 카드 결제의 경우 Eupago가 결제를 확인한 후에만 주문이 생성됩니다.
엄격한 검사: 금액(센트 단위까지)과 통화가 주문과 일치해야 하고, 결제 참조 번호는 해당 장바구니를 위해 생성된 것이어야 하며, 알림은 같은 환경(샌드박스 또는 운영)에서 와야 합니다. 그 밖의 경우 주문은 메모와 함께 Eupago payment on hold 상태가 됩니다.
이중 처리 방지: 반복된 알림은 한 번만 적용되므로 중복 주문, 메모, 상태 이메일이 생기지 않습니다. 취소된 주문에 대한 늦은 결제는 유실되지 않고 검토를 위해 보류됩니다.
샌드박스와 운영: 모드별로 API 키와 웹훅 키가 따로 있습니다. 모드를 전환하면 키와 Eupago 호스트도 함께 전환됩니다.
원하는 주문 상태: 결제 후 Payment accepted 또는 Delivered로 설정하며, 상태 변경은 한 번만 이루어집니다.
주문 페이지의 Eupago 블록: 결제 방법, 참조 번호 또는 마스킹된 전화번호, Eupago 거래 ID와 상태, 모듈 메모를 포함한 결제 시도 내역을 보여줍니다. 키, 이메일, 전체 전화번호를 기록하지 않는 선택적 로그를 제공합니다.
요구 사항
PrestaShop 8.0부터 9.x, PHP 8.0 이상. 채널의 API 키와 Webhook 2.0 키가 있는 Eupago 계정(샌드박스와 운영은 별도 계정입니다). 장바구니 통화 EUR. vibefox.net에서 받은 VibeFox 라이선스 키(도메인 하나당 키 하나).