개요
VibeFox dLocal Payment는 PrestaShop을 dLocal의 셀프 서비스 제품인 dLocal Go에 연결합니다. 결제 단계에서 고객이 dLocal Go를 선택하면 dLocal Go 결제 페이지로 이동하고, 자국의 결제 수단(현지 카드, 은행 송금, 현금 결제 바우처 또는 전자지갑)으로 결제한 뒤 쇼핑몰로 돌아옵니다. 카드 데이터는 쇼핑몰 사이트를 거치지 않습니다. 주문은 dLocal Go가 결제를 확인한 후에만 생성되므로, 결제를 중단하더라도 미결제 주문이 남지 않습니다.
이 모듈은 라틴아메리카, 아프리카, 아시아에 판매하며 dLocal Go 계정이 있는 쇼핑몰에 적합합니다. 모듈은 일회성 결제만 받습니다. 쇼핑몰 사이트의 카드 입력 양식, 저장된 카드, 구독, 승인과 캡처의 분리는 지원하지 않으며, 엔터프라이즈용 dLocal Payments API(X-Login / X-Trans-Key 자격 증명)와는 함께 작동하지 않습니다.
주요 기능
dLocal Go 결제 페이지: 장바구니 총액에 대해 장바구니 통화와 고객의 국가로 결제가 생성됩니다. 금액은 통화의 소수 자릿수에 맞춰 처리됩니다. 예를 들어 CLP와 JPY는 정수 금액이 됩니다.
dLocal Go 확인 시에만 결제 완료: 결제 알림은 서명으로 확인되며, 주문이 변경되기 전에 상태, 금액, 통화를 항상 dLocal Go API에서 다시 읽어옵니다. 고객이 돌아올 때도 상태를 확인합니다.
금액 및 통화 확인: 장바구니와 일치하지 않는 결제는 주문을 결제 완료로 표시하는 대신, 검토를 위해 dLocal payment on hold 상태로 둡니다.
이중 처리 방지: 알림이나 고객의 재방문이 반복되어도 두 번째 주문이 생성되거나 결제가 두 번 기록되지 않습니다.
샌드박스와 운영: 환경마다 별도의 자격 증명을 사용합니다. 알림과 환불은 항상 해당 결제 환경의 자격 증명을 사용합니다.
주문 페이지에서 환불: 주문의 dLocal Go payment 블록에서 전액 및 부분 환불이 가능하며, 금액과 통화는 dLocal Go가 청구한 것을 따릅니다. 전액 환불을 하면 주문이 Refunded 상태가 됩니다.
고객 친화적인 재시도: 결제하지 않고 dLocal Go 페이지를 떠난 고객은 체크아웃에서 메시지를 보고 다시 시도하거나 다른 결제 수단을 선택할 수 있습니다.
주문 페이지의 dLocal Go 블록: 결제 ID, 환경, 상태, 결제 금액과 환불 금액, 환불 내역과 메모. 결제된 주문의 자동 완료(선택 사항)와 자격 증명이 없는 로그를 제공합니다.
요구 사항
PrestaShop 8.0부터 9.x까지, PHP 8.0 이상. API 키와 API 시크릿이 있는 dLocal Go 계정. 인터넷에서 접근할 수 있고 운영 환경에서 HTTPS를 사용하는 쇼핑몰. vibefox.net에서 받은 VibeFox 라이선스 키(도메인 하나당 키 하나).