개요
VibeFox Worldline Gateway는 PrestaShop을 Worldline Direct(구 Ingenico Direct)의 호스티드 결제 페이지에 연결합니다. 결제 단계에서 고객은 Worldline을 선택하고, 안전한 Worldline 결제 페이지로 이동하여 카드, 전자지갑 또는 Worldline 계정에서 활성화된 다른 결제 수단으로 결제한 뒤 쇼핑몰로 돌아옵니다. 카드 정보는 쇼핑몰 사이트를 거치지 않으며, 중단된 결제가 미결제 주문으로 남지 않습니다.
이미 Worldline Direct 가맹점 계정이 있고, 자체 사이트에 카드 입력 양식 없이 호스티드 결제 페이지를 사용하려는 쇼핑몰에 적합합니다. 이 모듈은 일회성 결제를 직접 판매(direct sale)로 처리합니다. 저장된 카드, 구독, 임베디드 카드 양식, PrestaShop에서 승인 후 캡처 또는 취소하는 승인 전용 모드, 추가 수수료(surcharge), 웹훅 자동 등록은 지원하지 않습니다.
주요 기능
Worldline Direct 호스티드 결제 페이지: 장바구니 통화로 장바구니 금액에 대한 결제 페이지가 생성됩니다. JPY처럼 소수점이 없는 통화와 KWD처럼 소수점 셋째 자리까지 쓰는 통화도 지원합니다. Merchant Portal에서 만든 선택 사항인 페이지 템플릿을 사용할 수 있습니다.
Worldline이 확인한 경우에만 주문 생성: 주문은 고객이 돌아왔을 때 서버에서 상태를 확인하거나, 유효한 Worldline 서명이 포함된 웹훅을 받은 후에만 만들어집니다.
금액 및 결제 시도 확인: 결제는 이 장바구니의 결제 시도에 속해야 하며, 금액과 통화가 장바구니와 일치해야 합니다. 그렇지 않으면 주문은 메모와 함께 Worldline payment on hold 상태가 됩니다.
중복 처리 방지: 반복된 복귀나 웹훅으로 주문이 두 번 만들어지는 일은 없습니다. 늦게 도착한 결제가 취소된 주문을 다시 열지 않으며, 이미 결제 완료된 주문에 대한 두 번째 결제는 주문 메모에 표시됩니다.
테스트 계정과 실결제 계정 분리: 테스트 모드는 사전 프로덕션 환경과 테스트 자격 증명을, 실결제 모드는 프로덕션 환경과 실결제 자격 증명을 사용합니다. Check credentials 버튼으로 각 자격 증명 세트를 확인할 수 있습니다.
주문 페이지에서 환불: 주문의 Worldline payment 블록에서 전액 및 부분 환불을 할 수 있습니다. Worldline이 청구한 금액을 기준으로, 원래 결제와 같은 환경에서 처리되며, 이중 환불로부터 보호됩니다.
원하는 주문 상태 선택: 캡처된 결제 후 Payment accepted 또는 Delivered를 선택할 수 있습니다. 승인된 결제는 Awaiting Worldline capture 상태에서 대기합니다.
주문 페이지의 Worldline 블록: 결제 ID, 참조 번호, 환불 내역 및 메모를 표시합니다. 오류는 항상 기록되며, 키, 카드 정보, 개인정보는 마스킹됩니다.
요구 사항
PrestaShop 8.0 ~ 9.x, PHP 8.0 이상. 가맹점 ID(PSPID), API 키, 웹훅 키가 있는 Worldline Direct 가맹점 계정(테스트 및 실결제). vibefox.net에서 발급받은 VibeFox 라이선스 키(도메인당 키 1개).