
PrestaShop 연동
PrestaShop 8과 1.7.8용 모듈입니다. 나누어 보낸 결제 금액을 주문 합계에 도달할 때까지 합산합니다.
API 빠른 시작 보기요구 사항
- PrestaShop 8.1.x 또는 1.7.8.x, bcmath, curl, openssl, json을 포함한 PHP 8.3 이상, InnoDB를 사용하는 MySQL이 필요합니다.
- 유지보수 모드가 아닌 공개 HTTPS 쇼핑몰, 게이트웨이 공개 API URL, 정산 지갑이 필요합니다. 모듈은 PrestaShop 8.1.7 쇼핑몰에서 실행 확인했으며, 1.7.8 쇼핑몰에서는 실행하지 않았습니다.
설치와 설정
- make integrations-package로 저장소를 패키징해 suawave.zip을 사용하거나, 모듈 폴더를 modules/suawave에 복사하세요.
- Module Manager에서 압축 파일을 업로드하고 Suawave를 설치한 뒤 설정하세요.
- 게이트웨이 URL, 티커, 정산 주소, 정확한 공개 쇼핑몰 origin, 주문 통화를 설정하세요. 콜백 공개 키를 비워 두고 저장하면 /pubkey/에서 가져옵니다. 키를 고정하려면 직접 붙여 넣으세요.
- 모듈에 설정된 주문 통화를 사용하세요. 환산은 수행하지 않으며 토큰 금액은 장바구니 합계와 일대일로 같습니다.
구매자에게 표시되는 화면
주문 확인 및 상세 페이지에 금액, 입금 주소, 게이트웨이가 생성한 QR 코드, 기한을 표시합니다. 검증된 확정 입금이 합계를 충족할 때까지 주문은 Awaiting crypto payment 상태로 대기하다가 Payment accepted로 전환됩니다. 고객이 페이지를 새로 고치거나 주문 내역을 확인해야 하며, 확인 페이지는 자동 갱신되지 않습니다.
결제 처리 방식
- 소액의 확정 입금은 합산합니다. pending 콜백은 감지 사실만 기록하고, 중복 콜백 UUID는 금액에 다시 반영하지 않습니다.
- 만료된 안내에서는 주소와 QR 코드를 숨기고 기존 미결제 주문에서 새 결제 시도를 제공합니다. 만료 메모는 페이지 요청이나 cron 모듈에 의존하므로 방문이 없는 쇼핑몰에서는 늦게 기록될 수 있습니다.