
OpenCart 연동
지정한 통화로 주문 대금을 받는 OpenCart 4 확장 프로그램입니다.
API 빠른 시작 보기요구 사항
- OpenCart 4.0.2.x와 bcmath, curl, openssl, json을 포함한 PHP 8.3 이상이 필요합니다. 런타임 Composer 패키지는 필요하지 않습니다.
- 외부에서 접근 가능한 HTTPS 쇼핑몰, 게이트웨이 공개 API URL, 정산 지갑이 필요합니다. 주문은 설정된 주문 통화를 사용해야 합니다.
설치와 설정
- make integrations-package로 저장소를 패키징하고 Extensions > Installer에서 suawave.ocmod.zip을 업로드하세요. 압축 파일 이름을 유지하세요.
- Extensions > Extensions > Payments에서 Suawave를 설치하고 Edit를 누르세요. 필요하면 관리자 사용자 그룹에 extension/suawave/payment/suawave 접근 권한을 부여하세요.
- 게이트웨이 URL, 티커, 정산 주소, 정확한 공개 쇼핑몰 origin, 주문 통화를 설정하세요. 공개 키를 비워 두고 저장하면 /pubkey/에서 가져오며, 유효한 RSA PEM 키를 직접 붙여 넣을 수도 있습니다.
- 결제 대기 및 결제 완료 주문 상태를 선택하고 결제 수단을 활성화하세요. 업데이트할 때는 extension/suawave에 새 파일을 덮어쓰고 설정을 저장하세요. 결제 모듈을 제거하면 설정도 삭제됩니다.
구매자에게 표시되는 화면
결제 화면에는 금액, 입금 주소, 번들에 포함된 브라우저 라이브러리가 로컬에서 그린 QR 코드가 표시됩니다. 쇼핑몰 자체 상태 엔드포인트를 폴링하며, 검증된 확정 입금이 주문 합계를 충족하면 완료 페이지로 이동합니다.
결제 처리 방식
- 환율을 조회하지 않습니다. 토큰 금액은 주문 합계와 일대일로 같으며, 설정된 통화에서만 이 결제 수단을 표시합니다.
- pending 입금은 감지된 상태로 표시하되 주문을 결제 완료로 처리하지 않습니다. 소액의 확정 입금은 합산합니다. 만료 후에는 주소를 숨기고, 입금이 이미 감지된 경우가 아니면 새 결제 시도를 허용합니다.