CryptAPI에서 Suawave로 이전하기: API 차이점

출처 확인일

선택 기준 요약

필요한 결제 흐름에 따라 선택하세요
Suawave: 이런 경우에 선택하세요CryptAPI: 이런 경우에 선택하세요
주문당 정산 주소 하나를 사용하며 Suawave 지원 티커에 맞춰 결제 처리를 구현하려는 경우문서에 명시된 분할 정산이나 호출자가 지정하는 컨펌 수 제어가 필요한 경우

CryptAPI 문서에는 분할 정산, 호출자 지정 컨펌 수, priority, multi_token 옵션이 명시되어 있습니다. [c-options]

이 가이드는 cryptapi.io의 CryptAPI와 Suawave를 비교합니다. 비슷한 경로 이름만으로 호환성을 판단하지 마세요. 운영 중인 연동을 변경하기 전에 파라미터, 응답 형식, 콜백 검증 방식을 확인하세요.

Suawave로 구현하기

API 차이점

문서에 명시된 API 동작
지원 범위SuawaveCryptAPI
주소 생성GET /{ticker}/create/는 address와 callback을 받으며, 지원하지 않는 쿼리 옵션은 거부합니다.CryptAPI는 address와 callback 파라미터를 사용하는 GET /{ticker}/create/로 입금 주소를 생성합니다. [c-create]
주소 식별 기준정규화된 티커와 콜백 쌍으로 고정 주소를 식별합니다. 정산 설정을 변경하려면 새 콜백을 사용하세요.CryptAPI는 같은 콜백 URL에 같은 address_in을 반환하며, address_out을 변경하려면 새 콜백 URL이 필요합니다. [c-reuse]
정산 제어정산 주소는 하나입니다. 분할 정산, 호출자 지정 컨펌 수, 우선순위 선택, 여러 토큰 수신은 지원하지 않습니다.CryptAPI 문서에는 분할 정산, 호출자 지정 컨펌 수, priority, multi_token 옵션이 명시되어 있습니다. [c-options]
콜백x-ca-signature에 RSA-SHA256을 사용합니다. Suawave 공개 키를 가져오고 서명된 원본 바이트를 보존하세요.CryptAPI 문서는 x-ca-signature를 전체 GET URL 또는 원본 POST 본문에 대한 base64 RSA-SHA256 서명으로 설명합니다. [c-signature]

CryptAPI는 새 입금 주소에 검증된 콜백 도메인을 요구합니다. 기존 입금 주소는 계속 작동합니다. [c-domain]

Suawave는 티커와 콜백 쌍의 최초 create 호출에서 옵션을 고정합니다. 미지원 파라미터가 무시될 것으로 기대하지 말고 제거하세요. pending 감지는 인덱싱된 체인 데이터를 사용합니다. data URI 처리 방식이 다르므로 서버 호출과 함께 구매자 화면의 QR 표시도 확인하세요.

지원 자산: bep20/usdc (BSC), bep20/usdt (BSC), trc20/usdt (TRON). 현재 요청과 응답 규격은 개발 문서에서 확인하세요. 티커와 네트워크 · API 레퍼런스

엔드포인트 대응표

각 원본 경로에 대응하는 Suawave 문서의 경로를 표시합니다. 동일한 기능이 없으면 그 사실과 함께 가장 가까운 지원 대안을 안내합니다. 이전 전에 참고 사항을 확인하세요.

원본 경로와 Suawave 이전 범위
CryptAPI: 개발 문서Suawave: 경로이전 확인 사항
CryptAPI는 address와 callback 파라미터를 사용하는 GET /{ticker}/create/로 입금 주소를 생성합니다. [c-create]GET /{ticker}/create/모든 쿼리 옵션을 확인하고 정산 주소 하나와 인코딩된 HTTPS 콜백을 전달하세요.
CryptAPI는 callback을 조회 파라미터로 사용하는 GET /{ticker}/logs/를 제공합니다. [c-logs]GET /{ticker}/logs/이 서비스용으로 저장한 콜백으로 Suawave의 연결 정보를 조회하세요.
CryptAPI는 서비스 정보를 위한 GET /info/를 제공합니다. [c-info]동일한 기능 없음. 가장 가까운 대안: GET /{ticker}/info/Suawave에는 전체 자산을 조회하는 전역 info 엔드포인트가 없습니다. 생성된 자산 목록에서 지원 티커를 선택한 뒤 개별 정보를 요청하세요.
CryptAPI는 티커 정보를 위한 GET /{ticker}/info/를 제공합니다. [c-ticker-info]GET /{ticker}/info/현재 최소 금액을 확인하고 금액에는 십진수 문자열을 사용하세요.
CryptAPI는 GET /{ticker}/qrcode/를 제공하며, qr_code를 data URI 접두사 없는 base64 이미지 데이터로 설명합니다. [c-qr]GET /{ticker}/qrcode/Suawave는 qr_code를 완전한 data URI로 반환합니다. 접두사를 다시 붙이지 마세요.
CryptAPI는 서비스 수수료를 제외한 블록체인 수수료 추산을 위해 GET /{ticker}/estimate/를 제공합니다. [c-estimate]GET /{ticker}/estimate/Suawave는 네이티브 코인 단위의 보수적으로 설정된 상한값을 반환합니다. 입금에서 차감되는 금액이 아닙니다.
CryptAPI는 value, from, to 파라미터를 사용하는 GET /convert/를 제공합니다. [c-convert]GET /convert/Suawave의 지원 환산 통화쌍과 반올림 방식을 확인하세요. 환산 견적이 실제 자금 교환을 수행하지는 않습니다.
CryptAPI는 value와 from 파라미터를 사용하는 GET /{ticker}/convert/를 제공합니다. [c-ticker-convert]GET /{ticker}/convert/Suawave 티커를 사용하고 반환된 십진수 문자열을 검증하세요.
CryptAPI는 GET /pubkey/에서 콜백 검증 키를 공개합니다. [c-pubkey]GET /pubkey/캐시된 키를 Suawave 키로 교체하세요. 알고리즘이 같아도 키를 서로 바꿔 쓸 수는 없습니다.

이전 단계

  1. 현재 요청 옵션 정리

    애플리케이션이 보내는 모든 create 파라미터를 정리하세요. Suawave 흐름에서는 분할 정산 구문, confirmations, priority, multi_token을 제거하고, 나머지 선택적 파라미터도 Suawave API 레퍼런스와 대조하세요. 생성된 티커 목록에서 자산과 최소 금액을 확인하세요. Suawave에는 가입이나 계정, API 키가 필요하지 않습니다.

  2. 정산 주소와 콜백으로 새 주문 생성

    address와 URL 인코딩된 HTTPS callback을 GET /{ticker}/create/로 보내세요. 콜백 URL에 주문 참조값과 추측할 수 없는 nonce를 넣어 서버에 저장하세요. 반환된 address_in을 서비스 제공자 및 티커와 함께 영구 저장하세요. 다른 서비스의 입금 주소를 재사용하지 마세요.

  3. 콜백 검증과 주문 이행 로직 교체

    Suawave의 GET /pubkey/ 엔드포인트에서 받은 키로 x-ca-signature를 검증하세요. GET 콜백은 원본 URL 전체를, POST는 파싱 전 원본 본문을 보존하세요. 주문, nonce, 자산, 주소, 금액을 확인한 뒤 uuid로 중복을 제거하세요. pending이 0일 때만 주문을 이행하고 HTTP 200과 *ok*로 수신 확인하세요.

  4. 새 주문을 전환하고 기존 주문 대조

    기존 주문은 원래 서비스와 연결한 상태로 유지하고 해당 콜백 핸들러도 계속 운영하세요. 새로 생성되는 주문만 Suawave로 연결하세요. 구매자에게 공개하기 전에 정상 및 변조 서명, 중복 전달, 확정 후 도착한 pending, 부족 입금, 콜백 실패를 확인하세요. 콜백이 누락되면 Suawave 로그를 폴링해 보완하세요.

어댑터를 교체할 때 다음 가이드를 참고하세요. 빠른 시작 · 콜백 규격 · 서명 검증 예제

수수료와 최소 금액

CryptAPI는 결제 규모에 따른 서비스 수수료를 블록체인/네트워크 수수료와 별도로 안내합니다. [c-fees]

예상 자산과 입금 규모를 기준으로 아래 서비스 요금 출처와 Suawave 수수료 문서를 확인하세요. 수수료와 최소 금액

자주 묻는 질문

API 호스트 이름만 변경하면 되나요?

미지원 파라미터, 생성된 입금 주소, QR data URI 처리, 검증 키를 각각 검토하세요. 서명 검증을 위해 콜백의 정확한 원본 바이트를 보존하고 지원되는 Suawave 응답 필드에 대한 회귀 테스트를 추가하세요.

기존 입금 주소도 함께 이전할 수 있나요?

새 티커와 콜백 쌍마다 Suawave를 통해 새 입금 주소를 생성하세요. 기존 결제 안내와 미결 주문은 대조가 끝날 때까지 원래 서비스에서 유지하세요.

쇼핑몰에서 언제 주문을 결제 완료로 처리해야 하나요?

Suawave 서명이 유효하고 주문, nonce, 자산, 주소, 금액이 일치하는지 확인한 뒤 pending이 0인 확정 콜백을 처리하세요. 재시도로 같은 작업이 반복되지 않도록 주문 이행 전에 uuid를 저장하세요.

전체 비용은 어떻게 비교하나요?

정확한 자산과 예상 입금 규모를 기준으로 링크된 서비스의 요금 자료 및 Suawave의 수수료와 최소 금액을 확인하세요. 표시된 요율만 보지 말고 서비스 수수료, 네트워크 수수료, 최소 금액을 모두 포함하세요.

출처와 비교 방법

Suawave가 공개 문서를 바탕으로 작성한 비교입니다. 선택 안내는 문서에 명시된 기능을 기준으로 하며 결제 성능 벤치마크는 아닙니다. 각 각주에는 서비스의 공식 공개 문서 또는 요금 페이지 링크와 확인 날짜를 기록합니다.

USDT 결제 네트워크와 수수료 · 쇼핑몰 플러그인과 개발 도구 · 결제 연동 가이드