
Suawave와 Plisio 비교: 인보이스 및 입금 주소 API
출처 확인일
선택 기준 요약
| Suawave: 이런 경우에 선택하세요 | Plisio: 이런 경우에 선택하세요 |
|---|---|
| 자체 결제 화면에 입금 주소를 표시하고 콜백 URL로 주문을 추적하려는 경우 | 서비스가 반환하는 인보이스 URL이 필요한 경우 Plisio 문서에는 인보이스 생성 응답의 txn_id와 invoice_url이 명시되어 있습니다. [p-invoice] |
Plisio 대안을 검토할 때는 결제 화면이 어떤 응답을 사용하는지부터 확인하세요. Suawave는 입금 주소를 반환하고 QR 엔드포인트를 제공합니다. 주문 금액, 참조값, 이행 상태는 애플리케이션에서 관리하세요.
Suawave로 구현하기API 차이점
| 지원 범위 | Suawave | Plisio |
|---|---|---|
| 요청 | 공개 GET 엔드포인트에는 인증이 필요하지 않으며 JSON을 반환합니다. | Plisio 문서는 /api/v1 아래에서 쿼리에 api_key를 넣는 GET 요청과 JSON 응답을 설명합니다. [p-auth] |
| 주소 생성 | GET /{ticker}/create/는 address와 callback을 받습니다. | Plisio 문서에는 order_name, order_number, api_key를 사용하는 GET /api/v1/invoices/new가 명시되어 있습니다. [p-create] |
| 응답 식별 정보 | address_in을 티커, 콜백, 내부 주문 참조값과 함께 영구 저장하세요. | Plisio 문서에는 인보이스 생성 응답의 txn_id와 invoice_url이 명시되어 있습니다. [p-invoice] |
| 알림 | 기본은 GET 콜백입니다. post=1은 form POST, json=1은 JSON POST를 선택합니다. | Plisio는 인보이스 업데이트를 POST로 보내며, callback_url로 설정된 Status URL을 재지정할 수 있습니다. [p-callback] |
Suawave에서 콜백 URL은 단순한 알림 수신지가 아니라 고정 연결의 식별 정보입니다. 주문 참조값과 nonce를 인코딩해 넣고 정확한 URL을 저장하세요. 티커/콜백 쌍의 옵션은 최초 create 호출에서 고정됩니다. 새 주문 식별 정보에는 새 콜백 URL이 필요합니다.
지원 자산: bep20/usdc (BSC), bep20/usdt (BSC), trc20/usdt (TRON). 현재 요청과 응답 규격은 개발 문서에서 확인하세요. 티커와 네트워크 · API 레퍼런스
이전 단계
인보이스 처리와 결제 화면 교체
생성된 티커 목록에서 Suawave가 지원하는 자산과 네트워크를 선택하고 최소 금액을 확인하세요. 예상 금액은 자체 주문에 저장하세요. Suawave가 호스팅된 인보이스 URL을 제공할 것으로 기대하지 말고 반환된 주소와 QR을 직접 표시하세요. 이벤트 처리 전에 서명을 검증하는 별도 Suawave 콜백 핸들러를 구현하세요.
정산 주소와 콜백으로 새 주문 생성
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 로그를 폴링해 보완하세요.
수수료와 최소 금액
Plisio는 Gateway API와 White Label을 별도 요금 옵션으로 안내합니다. [p-fees]
예상 자산과 입금 규모를 기준으로 아래 서비스 요금 출처와 Suawave 수수료 문서를 확인하세요. 수수료와 최소 금액
자주 묻는 질문
기존 주문 번호를 계속 사용할 수 있나요?
네. 애플리케이션에 주문 번호를 저장하고 추측할 수 없는 nonce와 함께 URL 인코딩된 콜백에 넣으세요. Suawave는 사용자 지정 쿼리 파라미터를 콜백에 그대로 보내므로 저장된 주문과 대조하세요.
Suawave 콜백은 반드시 GET을 사용해야 하나요?
아니요. 연결을 생성할 때 post=1이면 form POST, json=1이면 JSON POST를 사용합니다. 둘 다 설정하면 JSON이 우선합니다. 서명 검증을 위해 원본 POST 본문을 보존하세요.
기존 입금 주소도 함께 이전할 수 있나요?
새 티커와 콜백 쌍마다 Suawave를 통해 새 입금 주소를 생성하세요. 기존 결제 안내와 미결 주문은 대조가 끝날 때까지 원래 서비스에서 유지하세요.
전체 비용은 어떻게 비교하나요?
정확한 자산과 예상 입금 규모를 기준으로 링크된 서비스의 요금 자료 및 Suawave의 수수료와 최소 금액을 확인하세요. 표시된 요율만 보지 말고 서비스 수수료, 네트워크 수수료, 최소 금액을 모두 포함하세요.
출처와 비교 방법
Suawave가 공개 문서를 바탕으로 작성한 비교입니다. 선택 안내는 문서에 명시된 기능을 기준으로 하며 결제 성능 벤치마크는 아닙니다. 각 각주에는 서비스의 공식 공개 문서 또는 요금 페이지 링크와 확인 날짜를 기록합니다.
- [p-invoice] Plisio: 인보이스 생성. 출처 확인일 .
- [p-auth] Plisio: 소개. 출처 확인일 .
- [p-create] Plisio: 인보이스 생성. 출처 확인일 .
- [p-callback] Plisio: 인보이스 업데이트와 입금 관리. 출처 확인일 .
- [p-fees] Plisio: 요금. 출처 확인일 .