웹사이트에서 USDT 결제를 받는 방법
USDT 네트워크와 토큰을 선택하고 웹사이트 결제용 주소를 연결한 뒤 정확한 결제 정보를 표시하세요. 전송이 이루어진 사실과 주문의 결제 완료를 구분하는 방법도 설명합니다.
수정일:
웹사이트에서 USDT 결제를 받으려면 선택한 네트워크의 수신 주소를 준비하고, 해당 주소를 Cryptanio의 적절한 서비스에 연결한 뒤 구매자에게 개별 결제의 정보를 보여 주세요. 일회성 결제에는 결제 링크를 게시할 수 있습니다. 주문을 자동으로 관리하는 상점에는 구매마다 별도의 인보이스를 만드는 방식이 더 적합합니다.
이 가이드는 USDT의 특성에 초점을 맞춥니다. 네트워크, 토큰, 가격 표시 통화를 혼동하지 않고 입금을 올바르게 확인하는 방법을 설명합니다. 웹사이트 연동의 전체적인 흐름은 별도 가이드에서 확인할 수 있습니다.
먼저 어떤 USDT를 받을지 정하세요
USDT는 여러 블록체인에 존재합니다. 따라서 «USDT로 결제»라는 안내만으로는 부족하며, 네트워크도 명확히 표시해야 합니다. 두 앱에서 주소 형식과 티커가 같다고 해서 전송이 호환되는 것은 아닙니다.
선택한 방식에 대해 다음 세 조건을 모두 확인하세요.
- 수신자의 지갑이 해당 네트워크의 USDT를 지원하고 적절한 수신 주소를 제공해야 합니다.
- Cryptanio가 프로젝트의 해당 서비스에서 그 네트워크와 자산의 조합을 사용할 수 있도록 지원해야 합니다.
- 송금자의 지갑이나 서비스가 바로 그 USDT를 전송할 수 있어야 합니다.
이름과 로고만 믿지 말고 Tether 공식 안내에서 토큰 식별자를 대조하세요. 이 안내에는 지원이 종료된 프로토콜의 과거 정보도 있습니다. 오래된 항목이 남아 있다고 해서 현재도 해당 프로토콜을 지원한다는 뜻은 아닙니다. Cryptanio에서의 사용 가능 여부는 별도로 확인해야 합니다. 공식 안내는 2026년 11월 14일에 확인했습니다.
주소를 준비하고 올바른 자산을 연결하세요
관리 화면에서 인보이스용 Payments 또는 결제 링크용 Links 서비스가 활성화된 웹사이트 프로젝트를 선택하세요. 공개 수신 주소를 추가하거나 주소록에서 선택한 뒤 해당 서비스에 연결합니다. 주소록에 저장하는 것만으로는 그 서비스를 통한 결제 수신이 활성화되지 않습니다.
주소 사용 설정에서 «자산» 필드를 확인하세요. USDT를 받으려면 선택한 네트워크에서 지원하는 토큰을 지정해야 합니다. 빈 필드는 USDT가 아니라 네트워크의 기본 코인을 의미합니다. USDT와 같이 지원되는 명칭은 서비스의 카탈로그를 통해 해석됩니다. 컨트랙트나 mint를 지정할 때는 해당 네트워크의 정확한 식별자를 사용하세요. 다른 네트워크의 토큰 주소를 입력하지 마세요.
이 연결에는 시드 구문이나 자금을 사용할 수 있는 개인 키가 필요하지 않습니다. 주소가 본인의 지갑에 속하며 받은 USDT를 직접 관리할 수 있는지 확인하세요.
링크와 인보이스 중에서 선택하세요
웹사이트에서 서비스를 소개하고 결제를 수동으로 확인한다면 «결제 링크»를 열고 «새로운 결제 링크»를 누르세요. 고정 금액을 설정하고 사용 가능한 결제 수단에 원하는 USDT를 남겨 둡니다. 생성된 영구 링크를 웹사이트에 게시하세요. 프로젝트에는 Links에 직접 연결된 사용 가능한 주소가 있어야 합니다.
자동화된 상점은 서버에서 API v1을 통해 인보이스를 만드세요. 자산을 미리 선택하는 방식에서는 project, chain, asset과 USDT 단위의 문자열 amount를 지정합니다. 달러로 표시한 주문 가격과 예상 암호화폐 금액은 용도가 다릅니다. USD로 가격을 표시한다고 해서 달러를 받거나 수령한 토큰을 환전하는 것은 아닙니다.
주문과 인보이스 ID의 연결 관계를 저장하세요. 새로운 작업에는 고유한 Idempotency-Key를 사용하고, 오류 후 같은 요청을 재시도할 때는 기존 키를 유지합니다. 비밀 API 키는 서버에만 보관해야 합니다.
결제 정보를 반올림하거나 바꾸지 말고 보여 주세요
구매자에게는 현재 페이지나 인보이스 응답에 있는 네트워크, 자산, 주소, 정확한 금액과 결제 기한이 필요합니다. 필수 memo, destination tag 또는 기타 추가 정보가 지정되어 있다면 이 정보도 전달해야 합니다. QR에는 응답으로 받은 payment_uri가 있으면 그대로 사용하세요. 주소 하나만으로 다시 만들거나 추가 정보를 누락하지 마세요.
정확한 금액을 상품 페이지의 반올림된 가격으로 바꾸지 마세요. 가치가 비슷하다는 이유로 USDT 대신 USDC나 다른 토큰을 받을 수 있다고 약속해서는 안 됩니다. 구매자가 결제 수단을 변경했다면 이전에 저장한 주소가 아니라 현재 결제 시도의 최신 정보를 사용해야 합니다.
USDT 전송 수수료도 별도로 확인하세요. 지갑이 수수료를 내는 데 어떤 자산이 필요하며 판매자가 실제로 얼마를 받을지 살펴봐야 합니다. 수수료 때문에 주문에 필요한 입금액이 알리지 않은 채 줄어들어서는 안 됩니다.
인보이스를 기준으로 결제를 확인하세요
스크린샷, 구매자의 메시지, 감지된 트랜잭션만으로는 주문 금액이 전부 결제되었음을 확인할 수 없습니다. 자동 처리에서는 인보이스의 현재 상태를 확인하세요. 성공 상태는 paid입니다. 부족 입금, 일부 입금, 초과 입금 또는 늦은 전송은 별도의 판단이 필요할 수 있습니다.
서버는 서명된 webhook을 수신한 뒤 API로 결과를 대조하거나, webhook 없이 API로 상태를 조회할 수 있습니다. 같은 이벤트나 확인이 반복되어도 상품을 두 번 제공해서는 안 됩니다. 알림 처리기가 필요하다면 webhook 가이드를 참고하세요.
첫 주문 전에 확인할 사항
구매자의 입장에서 결제 화면을 열고 네트워크, 자산과 결제 정보를 대조하세요. 실제 전송으로 시험한다면 수수료를 고려하고 본인 자금을 사용해야 합니다. 페이지만 여는 것으로 입금이 확인되지는 않습니다.
전송은 되었지만 주문이 미결제 상태라면 TXID를 저장하고 네트워크, 정확한 토큰, 받은 금액과 확인 상태를 점검하세요. 부족 입금과 웹사이트 오류를 조사하는 절차는 미결제 주문 가이드에 설명되어 있습니다.