개요
VibeFox dLocal Payment는 OpenCart 3 및 OpenCart 4를 dLocal의 셀프 서비스 제품인 dLocal Go에 연결합니다. 고객은 체크아웃의 마지막 단계에서 Confirm Order를 클릭하면 dLocal Go 결제 페이지로 이동하고, 자국의 현지 결제 수단(카드, 계좌이체, 현금 바우처 또는 전자지갑)으로 결제한 뒤 쇼핑몰로 돌아옵니다. 카드 정보는 쇼핑몰 서버를 거치지 않습니다. OpenCart는 결제 전에 주문을 생성하지만, 주문은 dLocal Go가 결제를 확인한 후에야 상태를 얻습니다. 따라서 결제되지 않은 시도는 누락된 주문으로 남습니다.
라틴 아메리카, 아프리카, 아시아에서 판매하며 dLocal Go 계정을 가진 쇼핑몰에 적합합니다. 이 확장 프로그램은 일회성 결제만 지원합니다. 쇼핑몰에는 카드 입력 양식이 없고, 카드 저장, 정기 구독, 승인과 매입의 분리도 지원하지 않습니다. 또한 dLocal Payments 엔터프라이즈 API(X-Login / X-Trans-Key 자격 증명)와는 함께 작동하지 않습니다.
주요 기능
dLocal Go 결제 페이지: 주문 통화로 된 주문 합계 금액과 고객의 국가에 맞춰 결제가 생성됩니다. 금액은 통화의 소수점 자릿수를 따르며, 예를 들어 CLP와 JPY는 정수 금액을 사용합니다.
dLocal Go가 확인한 경우에만 결제 완료: 결제 알림은 서명으로 검증되며, 상태·금액·통화는 항상 dLocal Go API에서 다시 확인합니다. 고객이 돌아올 때도 상태를 확인합니다. 그런 다음 OpenCart가 일반 주문 이메일을 보냅니다.
금액 및 통화 확인: 주문과 일치하지 않는 결제는 결제 완료로 표시하지 않고, 메모와 함께 검토 상태로 둡니다.
중복 처리 방지: 반복된 알림이나 복귀 요청이 같은 결제를 두 번 반영하는 일은 없습니다. 새 결제를 시작하기 전에 같은 고객 세션의 미완료 결제를 확인하므로, 이미 결제된 건은 다시 청구하지 않고 확인 처리됩니다.
샌드박스와 운영 환경: 환경마다 별도의 자격 증명을 사용합니다. 결제의 알림과 환불은 항상 해당 결제가 이루어진 환경의 자격 증명을 사용합니다.
주문 페이지에서 환불: 주문의 VibeFox dLocal Payment 탭에서 전액 및 부분 환불을 할 수 있으며, 금액과 통화는 dLocal Go가 청구한 것과 같습니다. 전액 환불을 하면 Refunded 상태가 설정되고, dLocal Go가 보낸 최종 환불 상태가 메모에 추가됩니다.
고객 친화적인 재시도: 결제하지 않고 dLocal Go 페이지를 떠난 고객은 체크아웃에서 메시지를 보고, 다시 시도하거나 다른 결제 수단을 선택할 수 있습니다.
OpenCart 조건과 상태: 지오존, 최소 주문 금액, 정렬 순서, 그리고 결제 완료, 처리 완료, 검토, 환불 주문에 대한 사용자 지정 상태. 자격 증명이나 개인 정보가 없는 선택적 로그를 제공합니다.
요구 사항
OpenCart 3.0.x(3.0.5.0에서 테스트됨) 또는 OpenCart 4.0.2 이상(4.1.0.3에서 테스트됨), PHP 8.0 이상. 하나의 다운로드 파일에 두 버전용 패키지가 모두 들어 있습니다. API 키와 API 시크릿이 있는 dLocal Go 계정. 알림을 받을 수 있도록 인터넷에서 HTTPS로 접근 가능한 쇼핑몰. vibefox.net에서 발급받은 VibeFox 라이선스 키(도메인당 키 하나).