개요
VibeFox ifthenpay Gateway는 포르투갈 고객을 위한 ifthenpay 결제를 PrestaShop에 추가합니다. 결제 시 설정에서 선택한 방법 하나가 제공됩니다: Multibanco 참조 번호, MB WAY 또는 신용카드. Multibanco를 선택하면 고객은 엔티티, 참조 번호와 결제 금액을 받아 ATM이나 인터넷뱅킹에서 결제합니다. MB WAY를 선택하면 고객은 MB WAY 앱에서 요청을 승인합니다. 신용카드를 선택하면 고객은 ifthenpay의 보안 카드 페이지에서 결제하며, 결제가 확인된 후에만 주문이 생성됩니다.
유로로 판매하고 선택한 방법의 키가 있는 ifthenpay 계정을 가진 포르투갈 쇼핑몰에 적합합니다. 이 모듈은 설치당 하나의 ifthenpay 방법을 제공합니다. PrestaShop에서의 환불, Payshop, Cofidis Pay, Apple Pay, Google Pay, PIX, Pay-by-Link를 지원하지 않으며, 구독이나 저장된 카드, 미결제 Multibanco 참조 번호의 자동 만료, 결제 상태 조회도 지원하지 않습니다.
주요 기능
Multibanco: 장바구니 합계에 대해 동적 참조 번호가 생성됩니다. 주문은 Awaiting ifthenpay payment 상태로 대기하며, 참조 번호는 주문 확인 페이지와 주문 확인 이메일에 표시됩니다.
MB WAY: 고객은 MB WAY에 연결된 휴대폰 번호(포르투갈 번호 또는 국제 형식 351#912345678)를 입력하고 앱에서 결제를 승인합니다.
신용카드: ifthenpay 카드 페이지에서 결제하며, 서명된 반환(Credit Card 키를 사용한 HMAC-SHA256) 또는 콜백으로 확인됩니다. 결제 전에는 주문이 존재하지 않습니다.
보호된 콜백: 콜백은 피싱 방지 키가 포함된 경우에만 수락됩니다. 위조된 요청은 주문을 절대 변경하지 않습니다.
금액 확인: 결제된 금액은 주문 합계와 센트 단위까지 대조됩니다. 금액이 다르면 주문은 ifthenpay payment on hold 상태가 되고 메모가 남습니다.
이중 처리 방지: 중복된 콜백과 반환은 아무 것도 변경하지 않습니다. 결제 1회, 메모 1건입니다. 취소된 주문이 결제되면 검토를 위해 보류되며, 환불된 주문은 다시 열리지 않습니다.
테스트 모드와 주문 상태: 신용카드와 Multibanco는 테스트 모드에서 ifthenpay 샌드박스를 사용합니다. 결제 후 주문은 Payment accepted 또는 Delivered 상태가 됩니다.
주문 페이지의 ifthenpay 블록: 참조 번호 또는 요청 ID가 포함된 결제 시도, 보류중 주문에 대한 경고, 모듈 메모를 표시합니다. 로그에는 키나 전화번호가 포함되지 않습니다.
요구 사항
PrestaShop 8.0 ~ 9.x, PHP 8.0 이상. 선택한 방법의 키가 있고 ifthenpay가 콜백을 활성화한 ifthenpay 계정. 장바구니 통화는 유로(EUR). vibefox.net에서 받은 VibeFox 라이선스 키(도메인당 키 하나).