쇼핑몰에도, 새로운 서비스 연동에도

HTTP 호출 한 번으로 암호화폐 결제를 받으세요

가입 없이, 계정 없이, API 키 없이. 정산 주소와 콜백 URL을 보내고 암호화폐로 결제를 받으세요.

결제 한 건의 전체 흐름HTTP

입금 주소 요청

curl -G "https://api.suawave.com/trc20/usdt/create/" \
  --data-urlencode "address=TXyzPayoutAddressExample0000000000000" \
  --data-urlencode "callback=https://shop.example/hook?order=1001&nonce=7f3a9c"

정산 후 전송되는 콜백

{
  "coin": "trc20_usdt",
  "pending": "0",
  "value_coin": "100.000000",
  "value_forwarded_coin": "98.500000"
}
판매자 지갑 수령액98.50 USDT

결제 예제입니다. 주요 콜백 필드만 표시합니다.

  1. 커피 카트에서 휴대폰으로 QR 코드를 스캔해 결제하는 고객

    결제 중100.00 USDT

  2. 주황빛 빨간 케이스를 씌운 휴대폰을 든 손
    결제 전송 완료100.00 USDTtrc20/usdt
  3. 화면에 뜬 반가운 소식에 웃는 도자기 가게 주인

    +98.50 USDT수령

  4. 탁 트인 푸른 하늘 아래 옥상에서 함께 웃는 친구들

    콜백200 OK

  5. 배송 상자를 테이프로 마무리하며 휴대폰을 보고 웃는 판매자

    주문 결제 완료100.00 USDT

  6. 카페 테라스에서 반가운 소식에 웃는 일러스트레이터

    정산금 도착98.50 USDT

  7. 그릴 위로 QR 코드 안내판을 들어 보이는 길거리 음식 판매자

    스캔하여 결제trc20/usdt

  8. 꽃 시장에서 휴대폰으로 QR 코드를 스캔하는 여성

    결제 확정컨펌 21회

하늘을 배경으로 든 휴대폰 화면에 표시된 결제 안내
결제 금액100.00 USDTtrc20/usdtTDepos…0000결제 대기 중

결제부터 정산까지

  1. 입금 주소 요청

    지갑 주소와 쇼핑몰에서 결제 알림을 받을 URL을 보내세요. 고객에게 안내할 입금 주소와 정산 가능한 최소 결제 금액을 반환합니다.

  2. 고객 결제

    고객은 해당 주소로 결제 금액을 보내면 됩니다.

  3. 지갑으로 정산

    입금을 감지하고 네트워크에서 확정되기를 기다립니다. 이후 수수료를 뺀 금액을 판매자 지갑으로 전송하고 쇼핑몰에 알립니다.

  4. 수신 확인

    쇼핑몰은 결제 알림이 Suawave의 서명을 포함하고 주문과 일치하는지 확인합니다. 알림을 한 번만 처리하고 수신을 확인합니다.

쇼핑몰에 바로 연동하세요

각 플러그인은 고객에게 결제 금액, 주소, QR 코드를 표시합니다. 서명이 검증된 확정 콜백을 받은 뒤에만 주문을 결제 완료로 처리합니다.

쇼핑몰 플러그인

  • Woo

    WooCommerce

    WordPress 플러그인입니다. 주문 완료 페이지와 주문 이메일에 금액, 주소, QR 코드를 표시합니다.

  • Magento 2

    결제 단계에서 주문 합계를 토큰 금액으로 환산하고, 결제가 완료되면 인보이스를 발행합니다.

  • OpenCart

    지정한 통화로 주문 대금을 받는 OpenCart 4 확장 프로그램입니다.

  • PrestaShop

    PrestaShop

    PrestaShop 8과 1.7.8용 모듈입니다. 나누어 보낸 결제 금액을 주문 합계에 도달할 때까지 합산합니다.

개발 도구

  • Model Context Protocol

    MCP 서버

    AI 에이전트가 공개 API로 입금 주소를 생성하고 결제 로그를 조회하며 수수료를 추산할 수 있습니다.

  • Go

    Go 클라이언트

    표준 라이브러리만 사용합니다. 입금 주소를 생성하고 각 콜백의 서명을 검증합니다.

  • JavaScript

    JavaScript 클라이언트

    타입을 제공하며 런타임 의존성이 없습니다. Node나 브라우저에서 API를 호출하고 Node에서 콜백을 검증합니다.

호출 한 번으로 결제부터 정산까지

고객 결제 금액
100.00 USDT
판매자 지갑 수령액
98.50 USDT
수수료
1.50 USDT
입금 주소 요청
curl -G "https://api.suawave.com/trc20/usdt/create/" \
  --data-urlencode "address=TXyzPayoutAddressExample0000000000000" \
  --data-urlencode "callback=https://shop.example/hook?order=1001&nonce=7f3a9c" \
  --data-urlencode "pending=1"
응답 내용
{
  "status": "success",
  "address_in": "TDepositAddressExample0000000000",
  "address_out": "TXyzPayoutAddressExample0000000000000",
  "callback_url": "https://shop.example/hook?order=1001&nonce=7f3a9c",
  "minimum_transaction_coin": "10.000000",
  "fee_percent": "0.50",
  "fee_fixed_coin": "0.050000",
  "fee_network_coin": "1.000000"
}
정산 후 전송되는 콜백
{
  "uuid": "8c4e2a61-5b3d-47f9-a0e2-1d6c9b7f3e45",
  "address_in": "TDepositAddressExample0000000000",
  "address_out": "TXyzPayoutAddressExample0000000000000",
  "txid_in": "9f2c1a0e5b7d4c3a8e6f1b2d3c4a5e6f7a8b9c0d1e2f30415263748596a7b8c9",
  "txid_out": "1a2b3c4d5e6f708192a3b4c5d6e7f8091a2b3c4d5e6f708192a3b4c5d6e7f809",
  "coin": "trc20_usdt",
  "pending": "0",
  "confirmations": "21",
  "value_coin": "100.000000",
  "value_forwarded_coin": "98.500000",
  "fee_coin": "1.500000"
}

100.00 USDT 결제 시 수수료를 차감한 나머지 금액이 판매자 지갑으로 전송됩니다. 위 금액은 고객 결제액, 판매자 수령액, 총수수료를 보여 줍니다.

전체 요청 옵션과 결제 세부 정보는 API 레퍼런스를 참고하세요.

결제 규모가 커질수록 낮아지는 수수료

지난 30일 동안 받은 결제 금액에 따라 서비스 수수료율이 낮아집니다. 초기 비용, 월 이용료, 숨겨진 수수료가 없습니다.

적용 수수료율

0.50%지난 30일 결제 금액이 $250,000 미만인 경우

0.45%지난 30일 결제 금액이 $250,000 ~ $999,999인 경우

0.40%지난 30일 결제 금액이 $1,000,000 ~ $2,499,999인 경우

0.35%지난 30일 결제 금액이 $2,500,000 ~ $4,999,999인 경우

0.30%지난 30일 결제 금액이 $5,000,000 ~ $9,999,999인 경우

0.20%지난 30일 결제 금액이 $10,000,000 ~ $19,999,999인 경우

0.13%지난 30일 결제 금액이 $20,000,000 이상인 경우

자산별 고정 네트워크 수수료가 별도로 부과됩니다. 자산별 네트워크 수수료

결제 금액 상세 trc20/usdt

고객 결제 금액
100.00 USDT
수수료
1.50 USDT
판매자 지갑 수령액
98.50 USDT

기본 서비스 수수료율과 네트워크 수수료를 적용한 예시: 0.50%

월 결제 금액 선택
지난 30일 결제 금액서비스 수수료
$250,000 미만0.50%
$250,000 ~ $999,9990.45%
$1,000,000 ~ $2,499,9990.40%
$2,500,000 ~ $4,999,9990.35%
$5,000,000 ~ $9,999,9990.30%
$10,000,000 ~ $19,999,9990.20%
$20,000,000 이상0.13%

수수료 비교

수수료율 너머의 비용까지 확인하세요

경쟁사 정보 확인 시점:

거래량 할인과 최소 서비스 수수료 적용 전 기본 서비스 수수료율입니다. Suawave: 0.50% · cryptapi.io: 1%

TRON TRC20

Suawave

1.00USDT

고정 네트워크 수수료

최소 입금액
10.00 USDT
최소 서비스 수수료
0.05 USDT

cryptapi.io

≈12.90USDT

예상 네트워크 비용

최소 입금액
10 USDT

BNB Smart Chain BEP20

Suawave

0.05USDT

고정 네트워크 수수료

최소 입금액
1.00 USDT
최소 서비스 수수료
0.05 USDT

cryptapi.io

≈0.01USD

예상 네트워크 비용

최소 입금액
1 USDT

Ethereum ERC20

Suawave

현재 지원 자산 목록에 없습니다.

cryptapi.io

≈0.58USD

예상 네트워크 비용

최소 입금액
2 USDT

cryptapi.io 수치는 특정 시점의 API 응답을 기준으로 하며, 스테이블코인 1 USD, 거래량 할인 없음, 정산 트랜잭션 1건을 가정합니다. 실제 네트워크 비용은 달라집니다. 위 Suawave 요율과 최소 금액은 현재 공개된 수수료 데이터에서 가져오며, 최소 서비스 수수료가 적용됩니다. 표시된 TRC20 네트워크 비용을 적용하면 해당 서비스가 안내하는 최소 결제 금액에서 양수의 정산액이 남지 않습니다.

cryptapi.io 수수료 정보 보기

결제를 받을 때만 수수료가 발생합니다

하늘색과 흰색 동전 더미에 주황색 동전 하나가 기대어 있는 모습
  • bep20/usdcBSC

    최소 입금액
    1.00 USDC
    최소 서비스 수수료
    0.05 USDC
    네트워크 수수료
    0.05 USDC
  • bep20/usdtBSC

    최소 입금액
    1.00 USDT
    최소 서비스 수수료
    0.05 USDT
    네트워크 수수료
    0.05 USDT
  • trc20/usdtTRON

    최소 입금액
    10.00 USDT
    최소 서비스 수수료
    0.05 USDT
    네트워크 수수료
    1.00 USDT

각 결제에는 결제 규모 구간에 따른 서비스 수수료와 지갑 전송을 위한 고정 네트워크 수수료가 부과됩니다. 서비스 수수료에는 소액의 최저 금액이 적용됩니다. 두 수수료 모두 결제 금액에서 차감되며, 각 결제 알림에 총수수료가 표시됩니다.

수수료는 결제 건별로 계산합니다. 전체 요금 체계는 수수료와 최소 금액을, 통화별 최소 결제 금액은 티커와 네트워크를 참고하세요.

쇼핑몰로 전달되는 결제 알림

결제 금액이 판매자 지갑에 도착하면 결제 세부 정보, 총수수료, 수령액을 쇼핑몰에 알립니다.

햇살이 비치는 시장에서 휴대폰을 함께 보며 웃는 과일 가게 주인과 고객

콜백 200 OK+98.50 USDT 전송 완료

쇼핑몰은 콜백 URL로 결제 알림을 받습니다. 확정 전 입금이 처음 감지되는 시점에 사전 알림을 받도록 요청할 수도 있습니다.

모든 알림에는 디지털 서명이 포함되어 있어 Suawave가 보낸 알림인지 검증할 수 있습니다. 쇼핑몰이 30초 안에 수신 확인을 보내지 않으면 다시 전송합니다.

같은 알림이 여러 번 도착할 수 있습니다. 주문 이행이 한 번만 이루어지도록 처리한 알림을 기록하세요. 실행 가능한 코드는 콜백 서명 검증을, 전달과 재시도 방식은 콜백 동작 방식을 참고하세요.

연동 전에 알아 두세요

  • 주문마다 고유한 입금 주소

    콜백 URL에 주문 번호를 넣으세요. 예: https://shop.example/hook?order=1001. Suawave는 해당 주문에 고유한 입금 주소를 제공합니다. 같은 통화와 같은 URL로 다시 요청하면 같은 주소를 반환하므로, 페이지를 새로 고쳐도 주소가 추가로 생성되지 않습니다. 입금이 도착하면 해당 URL로 알림을 보내 어떤 주문이 결제되었는지 알 수 있습니다.

    주문 URLhttps://shop.example/hook?order=1001
    입금 주소TDepos…0000
    콜백 동작 방식
  • 주문별 정산 지갑 지정

    특정 주문의 결제 금액을 다른 지갑으로 받으려면 입금 주소 요청 시 새 콜백 URL을 사용하세요.

    개발 문서에서 자세히 보기
  • 최소 입금액을 미리 안내하세요

    최소 금액 미만의 입금은 지갑으로 전송되지 않으며, 쇼핑몰에도 결제 알림이 전달되지 않습니다.

    최소 금액 기준은 입금이 처음 감지된 시점의 값을 적용합니다.

    개발 문서에서 자세히 보기
  • 통화와 네트워크를 정확히 지정하세요

    각 입금 주소는 지정한 통화와 네트워크만 받습니다. 다른 토큰은 전송되지 않으며, 쇼핑몰에도 결제 알림이 전달되지 않습니다.

    개발 문서에서 자세히 보기
  • 입금은 건별로 처리됩니다

    입금 주소는 그대로 유지됩니다. 여러 입금이 동시에 도착해도 각 입금의 수수료, 전송, 알림은 개별적으로 처리됩니다.

    개발 문서에서 자세히 보기

첫 결제 전에 궁금한 점

입금 주소 생성부터 확정 콜백 처리까지, Suawave로 암호화폐 결제를 받는 방법을 알아보세요.

결제 관련 질문 전체 보기
계정 없이 USDT TRC20 결제를 받으려면 어떻게 하나요?

Suawave는 가입이나 계정, API 키 없이 USDT TRC20 결제를 받을 수 있습니다. 정산 주소와 외부에서 접근 가능한 HTTPS 콜백 URL을 넣어 GET /trc20/usdt/create/를 호출하세요. 반환된 address_in과 minimum_transaction_coin을 선택한 티커의 자산 및 네트워크 정보와 함께 결제자에게 안내하면 됩니다.

개발 문서 보기
Suawave는 어떤 코인과 네트워크를 지원하나요?

Suawave에서 활성화된 결제 경로는 BNB Smart Chain BEP20의 USDC (bep20/usdc); BNB Smart Chain BEP20의 USDT (bep20/usdt); TRON TRC20의 USDT (trc20/usdt)입니다. 선택한 토큰과 네트워크에 해당하는 소문자 티커를 정확히 사용하세요. 지갑 주소만으로는 토큰 표준을 구분할 수 없습니다.

개발 문서 보기
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에서 받을 수 있는 최소 암호화폐 결제 금액은 얼마인가요?

Suawave는 토큰과 네트워크별로 최소 입금액을 적용합니다: BNB Smart Chain BEP20 USDC: 1.00 USDC; BNB Smart Chain BEP20 USDT: 1.00 USDT; TRON TRC20 USDT: 10.00 USDT. 결제 안내를 표시하기 전에 create 또는 info의 minimum_transaction_coin을 확인하세요. 각 입금에 적용되는 최소 금액은 해당 입금이 처음 감지될 때 저장됩니다.

개발 문서 보기
Suawave 결제를 언제 결제 완료로 처리할 수 있나요?

pending이 0인 Suawave 확정 콜백의 서명을 검증하고 주문, 토큰, 주소, 금액을 확인한 뒤에만 주문을 결제 완료로 처리하세요. 이 이벤트는 처리 대상 입금이 전송되고 정산 트랜잭션까지 확정되었음을 뜻합니다. pending 콜백만으로는 주문을 이행하면 안 됩니다.

개발 문서 보기
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로 중복을 제거하세요. 추가 입금도 각각 최소 입금액을 충족해야 하며 수수료가 별도로 부과됩니다.

개발 문서 보기
Suawave는 결제 금액을 판매자 지갑으로 어떻게 보내나요?

Suawave는 수수료와 체인 검증을 거친 뒤 처리 가능한 각 입금을 create에 지정한 단일 정산 주소로 개별 전송합니다. 확정 콜백에는 txid_out과 value_forwarded_coin이 포함되므로 서버에서 정산 트랜잭션과 순수령액을 확인할 수 있습니다.

개발 문서 보기