Suawave와 CoinPayments 비교: 결제 API 이전

출처 확인일

선택 기준 요약

필요한 결제 흐름에 따라 선택하세요
Suawave: 이런 경우에 선택하세요CoinPayments: 이런 경우에 선택하세요
주문 연결을 새로 만들 때마다 정산 주소와 콜백 URL을 지정하는 입금 주소 기반 흐름이 필요한 경우영구 주소 또는 임시 주소를 사용하는 문서화된 지갑 모델이 필요한 경우

CoinPayments 문서는 새 플랫폼에서 영구 주소 또는 임시 주소를 사용하는 지갑을 설명합니다. [cp-wallet]

CoinPayments 대안을 검토하기 전에 애플리케이션이 어떤 API를 사용하는지 확인하세요. 레거시 cmd 흐름과 새 JSON API를 별도 어댑터로 취급해야 합니다. 이전 대상인 Suawave 연동은 티커, 정산 주소, 콜백 URL을 사용합니다.

Suawave로 구현하기

API 차이점

문서에 명시된 API 동작
지원 범위SuawaveCoinPayments
레거시 요청/{ticker}/create/부터 지원되는 GET 경로를 직접 사용하세요.CoinPayments 레거시 요청은 form 인코딩된 cmd 작업을 POST /api.php로 전송합니다. [cp-legacy]
새 결제 생성GET /{ticker}/create/는 결제 화면용 address_in을 반환합니다.CoinPayments 문서에는 새 결제 생성 흐름으로 JSON을 사용하는 POST Invoice가 명시되어 있습니다. [cp-create]
요청 서명Suawave 공개 GET 엔드포인트에는 인증이 필요하지 않습니다. 콜백 검증은 별도 단계입니다.CoinPayments는 HMAC-SHA256과 X-CoinPayments-Client, X-CoinPayments-Timestamp, X-CoinPayments-Signature로 보호된 호출을 인증합니다. [cp-auth]
통화 식별자Suawave의 생성된 자산 목록에서 티커를 선택하고 해당 네트워크를 유지하세요.CoinPayments 새 플랫폼은 통화를 심볼 대신 ID로 참조합니다. [cp-currency]
주소 모델처리 가능한 입금을 하나의 정산 주소로 전송하는 고정 티커/콜백 연결을 생성합니다.CoinPayments 문서는 새 플랫폼에서 영구 주소 또는 임시 주소를 사용하는 지갑을 설명합니다. [cp-wallet]

서비스 제공자 필드, 입금 주소, 콜백 식별 정보를 별도로 저장하는 Suawave 어댑터를 구현하세요. 결제 화면 표시, 예상 금액 저장, 누적 확정 입금액이 주문 금액을 충족하는지 판단하는 일은 애플리케이션이 담당합니다. Suawave는 정산용 입금 주소를 생성하며 기존 지갑이나 인보이스 내역을 가져오지 않습니다.

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

이전 단계

  1. 기존 어댑터를 확인하고 결제 처리 범위 교체

    모든 미결 주문의 서비스 제공자와 API 버전을 기록하세요. 새 Suawave 주문에는 생성된 티커 목록에서 정확한 자산과 네트워크를 선택하고 최소 금액을 확인하세요. 서비스의 인보이스 식별자를 이전 가능한 값으로 취급하지 말고 내부 주문 참조값을 콜백 URL과 연결하세요.

  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 로그를 폴링해 보완하세요.

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

수수료와 최소 금액

CoinPayments는 To Balance, ASAP, Nightly 처리 모드를 안내하며 ASAP와 Nightly의 네트워크 수수료를 별도로 명시합니다. [cp-fees]

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

자주 묻는 질문

이 비교는 어떤 CoinPayments 버전을 다루나요?

표에서 레거시 요청 방식과 새 결제 흐름을 구분합니다. 변경을 계획하기 전에 실제 운영 중인 어댑터에 해당하는 행을 확인하세요. 어느 경우든 이전 대상인 Suawave 흐름은 같습니다.

서비스를 바꾸면 지갑 내역도 복사되나요?

이 가이드는 새 Suawave 입금 주소와 주문 처리를 다룹니다. 과거 결제는 원래 서비스에서 대조하고, 해당 주문에 기존 서비스 식별자와 기록을 유지하세요.

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

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

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

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

출처와 비교 방법

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

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