
Suawave와 NOWPayments 비교: 결제 API 이전
출처 확인일
선택 기준 요약
| Suawave: 이런 경우에 선택하세요 | NOWPayments: 이런 경우에 선택하세요 |
|---|---|
| 자체 결제 화면에 입금 주소를 표시하고 처리 가능한 각 입금을 하나의 정산 주소로 받으려는 경우 | 서비스가 생성하는 고객용 인보이스 URL이 필요한 경우 NOWPayments의 POST /v1/invoice는 고객용 invoice_url을 반환합니다. [n-invoice] |
NOWPayments 대안을 검토할 때는 결제 화면에 필요한 것이 직접 표시할 입금 주소인지, 호스팅된 인보이스 링크인지부터 확인하세요. Suawave는 주소와 서명된 콜백을 제공하며 주문과 결제 화면은 애플리케이션에서 관리합니다.
Suawave로 구현하기API 차이점
| 지원 범위 | Suawave | NOWPayments |
|---|---|---|
| 주소 생성 | GET /{ticker}/create/에 address와 callback을 전달합니다. 인증은 필요하지 않습니다. | NOWPayments는 JSON과 x-api-key 헤더를 사용하는 POST /v1/payment로 직접 결제를 생성합니다. [n-create] |
| 주문 참조값 | callback에 주문 참조값과 nonce를 넣고 반환된 address_in을 영구 저장하세요. | NOWPayments 결제 생성은 price_amount, price_currency, pay_currency, ipn_callback_url, order_id를 받습니다. [n-fields] |
| 생성 응답 | address_in을 티커, 정산 주소, 콜백, 서비스 제공자와 함께 저장하세요. | NOWPayments는 직접 결제 생성 시 payment_id와 pay_address를 반환합니다. [n-result] |
| 구매자 화면 | 결제 화면에 반환된 주소, 선택한 자산과 네트워크, 금액, QR을 표시하세요. | NOWPayments의 POST /v1/invoice는 고객용 invoice_url을 반환합니다. [n-invoice] |
| 결제 대조 | GET /{ticker}/logs/는 저장된 콜백 URL로 조회합니다. | NOWPayments는 결제 상태 조회를 위한 GET /v1/payment/{payment_id}를 제공합니다. [n-status] |
| 콜백 검증 | Suawave 공개 키로 원본 URL 또는 원본 POST 본문의 RSA-SHA256 서명을 검증하세요. | NOWPayments는 IPN secret과 정렬된 JSON에 대한 HMAC-SHA512, x-nowpayments-sig를 사용해 IPN을 검증합니다. [n-signature] |
Suawave의 티커와 콜백 쌍을 기준으로 결제 어댑터를 다시 구성하세요. 주문 금액은 애플리케이션 상태로 관리합니다. create는 인보이스 생명주기 대신 입금 주소를 반환합니다. 기존 상태 기반 주문 이행 로직을 검증된 입금별 콜백으로 교체하고 십진수 연산으로 부분 결제를 추적하세요.
지원 자산: bep20/usdc (BSC), bep20/usdt (BSC), trc20/usdt (TRON). 현재 요청과 응답 규격은 개발 문서에서 확인하세요. 티커와 네트워크 · API 레퍼런스
이전 단계
결제 화면과 금액 처리 방식 결정
생성된 Suawave 티커 목록에서 구매자가 보낼 정확한 자산과 네트워크를 선택하고 최소 금액을 확인하세요. 자체 결제 UI를 표시하고 주문에 예상 금액을 저장하세요. 환율 견적이 필요하면 별도의 환산 문서를 확인하세요. 견적이 입금된 자금을 실제로 교환하지는 않습니다.
정산 주소와 콜백으로 새 주문 생성
address와 URL 인코딩된 HTTPS callback을 GET /{ticker}/create/로 보내세요. 콜백 URL에 주문 참조값과 추측할 수 없는 nonce를 넣어 서버에 저장하세요. 반환된 address_in을 서비스 제공자 및 티커와 함께 영구 저장하세요. 다른 서비스의 입금 주소를 재사용하지 마세요.
콜백 검증과 주문 이행 로직 교체
Suawave의 GET /pubkey/ 엔드포인트에서 받은 키로 x-ca-signature를 검증하세요. GET 콜백은 원본 URL 전체를, POST는 파싱 전 원본 본문을 보존하세요. 주문, nonce, 자산, 주소, 금액을 확인한 뒤 uuid로 중복을 제거하세요. pending이 0일 때만 주문을 이행하고 HTTP 200과 *ok*로 수신 확인하세요.
새 주문을 전환하고 기존 주문 대조
기존 주문은 원래 서비스와 연결한 상태로 유지하고 해당 콜백 핸들러도 계속 운영하세요. 새로 생성되는 주문만 Suawave로 연결하세요. 구매자에게 공개하기 전에 정상 및 변조 서명, 중복 전달, 확정 후 도착한 pending, 부족 입금, 콜백 실패를 확인하세요. 콜백이 누락되면 Suawave 로그를 폴링해 보완하세요.
수수료와 최소 금액
NOWPayments는 요금 페이지에 서비스 수수료를 공개합니다. [n-fees]
예상 자산과 입금 규모를 기준으로 아래 서비스 요금 출처와 Suawave 수수료 문서를 확인하세요. 수수료와 최소 금액
자주 묻는 질문
Suawave가 인보이스 링크를 반환하나요?
Suawave create 응답에는 결제 화면에 표시할 입금 주소가 들어 있습니다. 애플리케이션에서 결제 안내를 표시하고 주문 생명주기를 관리합니다. 주소와 QR 처리 흐름은 빠른 시작을 참고하세요.
기존 입금 주소도 함께 이전할 수 있나요?
새 티커와 콜백 쌍마다 Suawave를 통해 새 입금 주소를 생성하세요. 기존 결제 안내와 미결 주문은 대조가 끝날 때까지 원래 서비스에서 유지하세요.
쇼핑몰에서 언제 주문을 결제 완료로 처리해야 하나요?
Suawave 서명이 유효하고 주문, nonce, 자산, 주소, 금액이 일치하는지 확인한 뒤 pending이 0인 확정 콜백을 처리하세요. 재시도로 같은 작업이 반복되지 않도록 주문 이행 전에 uuid를 저장하세요.
전체 비용은 어떻게 비교하나요?
정확한 자산과 예상 입금 규모를 기준으로 링크된 서비스의 요금 자료 및 Suawave의 수수료와 최소 금액을 확인하세요. 표시된 요율만 보지 말고 서비스 수수료, 네트워크 수수료, 최소 금액을 모두 포함하세요.
출처와 비교 방법
Suawave가 공개 문서를 바탕으로 작성한 비교입니다. 선택 안내는 문서에 명시된 기능을 기준으로 하며 결제 성능 벤치마크는 아닙니다. 각 각주에는 서비스의 공식 공개 문서 또는 요금 페이지 링크와 확인 날짜를 기록합니다.
- [n-invoice] NOWPayments: API 및 엔드포인트 설명. 출처 확인일 .
- [n-create] NOWPayments: API 및 엔드포인트 설명. 출처 확인일 .
- [n-fields] NOWPayments: API 및 엔드포인트 설명. 출처 확인일 .
- [n-result] NOWPayments: API 및 엔드포인트 설명. 출처 확인일 .
- [n-status] NOWPayments: API 및 엔드포인트 설명. 출처 확인일 .
- [n-signature] NOWPayments: IPN과 설정 방법. 출처 확인일 .
- [n-fees] NOWPayments: 요금. 출처 확인일 .