자주 묻는 질문
입금 주소 생성부터 확정 콜백 처리까지, Suawave로 암호화폐 결제를 받는 방법을 알아보세요.
시작하기
코인과 네트워크
수수료와 최소 금액
Suawave의 건별 결제 수수료는 얼마인가요?
Suawave는 각 입금에 최소 금액이 적용되는 서비스 수수료와 네트워크 수수료를 결제 토큰으로 부과합니다. 지난 30일 USD 결제 금액에 따른 서비스 수수료 구간은 $250,000 미만: 0.50%; $250,000 ~ $999,999: 0.45%; $1,000,000 ~ $2,499,999: 0.40%; $2,500,000 ~ $4,999,999: 0.35%; $5,000,000 ~ $9,999,999: 0.30%; $10,000,000 ~ $19,999,999: 0.20%; $20,000,000 이상: 0.13%입니다. 공개된 토큰별 수수료는 BNB Smart Chain BEP20 USDC: 최소 서비스 수수료 0.05 USDC, 네트워크 수수료 0.05 USDC; BNB Smart Chain BEP20 USDT: 최소 서비스 수수료 0.05 USDT, 네트워크 수수료 0.05 USDT; TRON TRC20 USDT: 최소 서비스 수수료 0.05 USDT, 네트워크 수수료 1.00 USDT입니다. 수수료는 입금별로 결정하며, fee_coin과 value_forwarded_coin에 실제 수수료와 정산액이 표시됩니다.
개발 문서 보기컨펌과 결제 확정
Suawave 결제를 언제 결제 완료로 처리할 수 있나요?
pending이 0인 Suawave 확정 콜백의 서명을 검증하고 주문, 토큰, 주소, 금액을 확인한 뒤에만 주문을 결제 완료로 처리하세요. 이 이벤트는 처리 대상 입금이 전송되고 정산 트랜잭션까지 확정되었음을 뜻합니다. pending 콜백만으로는 주문을 이행하면 안 됩니다.
개발 문서 보기콜백과 서명 검증
Suawave 웹훅을 JSON이나 form POST로 받을 수 있나요?
네. Suawave는 기본적으로 GET 콜백을 보내며, post=1이면 form POST, json=1이면 JSON POST를 보냅니다. 둘 다 설정하면 JSON이 우선합니다. 티커와 콜백 쌍의 옵션은 최초 create 호출에서 고정되며, 사용자 지정 쿼리 파라미터는 콜백 URL에 유지됩니다.
개발 문서 보기Suawave 웹훅 서명을 어떻게 검증하나요?
GET /pubkey/에서 받은 Suawave 공개 키로 x-ca-signature 헤더의 base64 RSA-SHA256 PKCS#1 v1.5 서명을 검증하세요. GET 콜백은 원본 요청 URL 전체에, POST 콜백은 원본 본문의 정확한 바이트에 서명합니다. 필드를 파싱하거나 신뢰하기 전에 검증하세요. 키는 캐시하고, 검증에 실패하면 한 번 갱신한 뒤 다시 검증하고, 그래도 검증에 실패하는 경우에만 요청을 거부하세요.
개발 문서 보기부족 입금, 초과 입금, 지연 입금
고객이 주문 금액보다 적게 보내면 어떻게 하나요?
확정된 금액이 주문 금액을 충족하는지는 쇼핑몰에서 판단합니다. Suawave의 공개 create 엔드포인트에는 청구 금액을 전달하지 않습니다. 총입금액 기준이면 value_coin을, 순수령액 기준이면 value_forwarded_coin을 사용해 처리 대상 확정 입금을 합산하고 콜백 UUID로 중복을 제거하세요. 추가 입금도 각각 최소 입금액을 충족해야 하며 수수료가 별도로 부과됩니다.
개발 문서 보기정산과 전송
보안과 자금 보관
플러그인, SDK, MCP
WooCommerce, Magento, OpenCart, PrestaShop에서 암호화폐 결제를 받을 수 있나요?
Suawave는 WooCommerce, Magento 2, OpenCart, PrestaShop용 쇼핑몰 연동을 제공합니다. 각 연동 가이드에 따라 플러그인을 설치하고 설정하여 입금 주소와 QR 코드를 표시하고 서명된 결제 콜백을 처리하세요.
개발 문서 보기CryptAPI에서 이전하기
제한, 만료, 환불
Suawave는 API 요청이나 새 입금 주소 생성을 제한하나요?
네. Suawave는 클라이언트 IP 및 콜백 호스트별 요청 제한과 새 티커 및 콜백 쌍 생성에 대한 별도 할당량을 적용합니다. HTTP 429 응답을 받으면 재시도 간격을 늘리고, Retry-After가 있으면 따르세요. 기존 쌍을 재사용하면 신규 생성 할당량은 소모하지 않지만 요청 제한에는 포함됩니다.
개발 문서 보기