내 웹사이트에서 암호화폐 결제를 받는 방법
암호화폐 결제 방식을 선택하고 수신 주소를 준비한 뒤 주문에 결제 확인을 연결하는 방법을 알아봅니다.
수정일:
암호화폐 결제를 받으려면 자산과 네트워크를 선택하고 수신 주소를 준비한 뒤, 사이트가 결제 결과를 확인할 방식을 정해야 합니다. Cryptanio에서는 결제 링크로 시작하거나 주문별 인보이스를 만들고 사용자 잔액 충전을 구성할 수 있습니다. 자금은 내 주소로 들어오며, 서비스는 송금과 상태 변화를 추적해 알려 줍니다.
어떤 방식이 내 서비스에 맞는지, 첫 결제 전에 무엇을 확인해야 하는지 살펴보겠습니다. USDT와 USDC도 전체 결제 과정 안에서 설명합니다. 코인 선택은 중요하지만 그것만으로 연동 방식이 정해지지는 않습니다.
결제 수신 방식을 선택하세요
일회성 판매나 서비스 대금에는 결제 링크가 적합합니다. 프로젝트에 내 주소를 연결하고 대시보드에서 페이지를 만든 뒤, 결제 목적과 허용할 결제 수단을 지정합니다. 이후 고객에게 링크를 보내면 됩니다. 별도의 결제 화면이나 서버 연동은 필요하지 않습니다.
주문이 있는 온라인 상점이나 앱에서는 구매마다 별도 인보이스를 만드는 방식이 편리합니다. 인보이스에는 금액, 유효 기간, 개별 상태가 있습니다. 내 서버가 주문과 인보이스의 관계를 저장하고 결제 알림을 받습니다. 이를 바탕으로 이용 권한을 자동으로 부여하거나 결제된 주문을 처리 단계로 넘길 수 있습니다.
입금 방식은 사용자가 서비스 내부 잔액을 먼저 충전하고 이후 서비스를 이용하며 차감하는 경우에 필요합니다. Cryptanio는 입금 사실을 알리고, 잔액의 적립·차감·표시 규칙은 내 애플리케이션이 구현합니다.
| 목적 | 시작할 곳 |
|---|---|
| 링크로 일회성 결제 받기 | 대시보드의 결제 페이지 |
| 주문별 결제를 자동 반영하기 | 인보이스와 webhook |
| 사용자 잔액 충전 받기 | 입금 주소와 서버 측 잔액 관리 |
사이트가 아직 서비스 소개만 제공한다면 결제 링크를 게시하는 것으로 충분합니다. 결제 결과가 제품 상태를 바꿔야 할 때 API 연동이 필요합니다.
프로젝트와 주소를 준비하세요
Cryptanio 대시보드에 로그인하고 사이트나 서비스용 프로젝트를 선택합니다. 프로젝트를 사용하면 제품별 주소, 설정, 이벤트를 구분할 수 있습니다.
선택한 네트워크의 지갑 주소를 준비합니다. 여기서 설명하는 USDT 또는 USDC 수신에는 공개 수신 주소가 필요합니다. 자금 사용 권한을 주는 시드 문구나 개인 키를 전달할 필요는 없습니다.
주소를 주소록에 저장하는 것 외에, 선택한 서비스에 사용할 수 있도록 프로젝트에 연결해야 합니다. 예를 들어 인보이스에는 «결제» 서비스의 주소를 사용하고, 링크 페이지에는 «사이트 맵»를 사용합니다. 결제를 받기 전에 연결이 활성화되어 있는지 확인하세요. 전체 주소 목록에 있다는 사실만으로 원하는 서비스에서 그 주소를 사용한다는 뜻은 아닙니다.
USDT 수신을 설정하세요
USDT에서는 먼저 지원되는 토큰과 네트워크의 조합을 선택합니다. 링크나 인보이스를 보내기 전에 결제자와 이를 확인하세요. 두 지갑에 모두 USDT라고 표시되어도 같은 네트워크로 전송된다는 보장은 없습니다.
결제 페이지에는 보낼 자산, 사용할 네트워크, 수신 주소가 분명하게 표시되어야 합니다. 자동 연동에서는 해당 인보이스가 반환한 금액과 주소를 보여 주세요. 결제 구분을 위해 금액에 추가 소수 자릿수가 포함될 수 있습니다.
토큰 컨트랙트를 직접 확인한다면 Tether의 지원 프로토콜 및 주소 목록을 사용하세요. 발행사가 네트워크를 지원하는 조건과 결제 서비스가 그 네트워크를 지원하는 조건은 서로 다릅니다. 수신하려면 두 조건을 모두 충족해야 합니다.
USDC 수신을 설정하세요
USDC를 선택할 때도 네트워크와 지원되는 정확한 토큰을 확인합니다. 같은 네트워크 안에도 이름이 비슷한 자산이나 브리지를 거친 버전이 있을 수 있습니다. 수신 설정에 명시된 정확한 자산 식별자를 기준으로 판단하세요.
공식 USDC 주소는 Circle 문서에 공개되어 있습니다. 이 정보는 토큰 확인에 도움이 되지만 Cryptanio에서 해당 토큰을 사용할 수 있는지 확인하는 절차를 대신하지는 않습니다.
USDT와 USDC를 모두 받는다면 각각 별도의 결제 옵션으로 표시하세요. 가치가 비슷하다는 이유만으로 다른 토큰으로 보낸 송금을 해당 인보이스의 결제로 인정해서는 안 됩니다.
주문 확인 방식을 정하세요
수동 처리에서는 대시보드의 이벤트를 확인하고 Telegram 또는 Discord로 메시지를 받을 수 있습니다. 네트워크, 자산, 주소, 실제 수신 금액, 송금 상태를 대조하세요. 고객의 스크린샷이나 미확정 거래의 표시만으로 상품을 제공해서는 안 됩니다.
자동 처리를 하려면 Cryptanio가 이벤트 데이터를 내 서버로 보내는 알림인 webhook을 설정합니다. 서버는 메시지 서명을 검증하고 연결된 주문을 찾은 뒤 인보이스 상태를 대조합니다. 같은 이벤트가 다시 전달되어도 상품 제공이나 잔액 적립이 중복되어서는 안 됩니다.
송금이 확정되었다는 사실과 주문이 전액 결제되었다는 사실은 다릅니다. 고객이 금액을 적게 보내거나 만료된 인보이스에 결제했을 수 있습니다. 이런 경우의 처리 절차를 미리 정하고, 블록체인 재구성으로 확정이 취소되는 상황도 고려하세요.
전체 결제 흐름을 확인하세요
결제 버튼을 게시하기 전에 결제자에게 올바른 정보가 보이는지, 원하는 프로젝트에서 결과를 찾을 수 있는지 확인합니다. 선택한 수신자에게 알림이 도착하고 필요한 검사를 마친 뒤에만 주문 상태가 바뀌어야 합니다.
실제 송금으로 확인하려면 자금과 네트워크 수수료가 필요합니다. 확인을 진행한다면 본인 지갑과 지원되는 네트워크를 사용하고, 선택한 방식의 제한을 고려한 소액을 보내세요. 결제 페이지를 여는 데서 끝내지 말고 실제 수신 금액과 상태까지 대조해야 합니다.
비용과 인보이스 표시 통화에 관해 알아둘 점
주문 금액을 계산 단위인 달러로 저장하면서 결제는 선택한 암호화폐로 진행할 수 있습니다. 이것이 은행 계좌로 달러를 받거나 수신한 코인을 법정화폐로 자동 환전한다는 뜻은 아닙니다.
API의 주문 가격 필드와 예상 암호화폐 금액 필드는 역할이 다릅니다. 해당 필드를 보낸다고 자금이 자동 환전되지는 않습니다. 결제 페이지에는 고객이 실제로 보내야 할 선택 자산의 금액을 보여 줘야 합니다.
Cryptanio 이용 조건은 요금 페이지에서 확인하세요. 블록체인 수수료도 별도로 고려해야 합니다. 수수료는 네트워크와 송신자 지갑에 따라 달라집니다. 부족 결제 처리 규칙을 명시적으로 정하지 않은 상태에서 예상 수수료만큼 인보이스 금액을 줄이지 마세요.
다음 단계 선택하기
수동으로 결제를 받으려면 「사이트나 프로그래밍 없이 암호화폐 결제 링크를 만드는 방법」부터 시작하세요. 알림은 이 모음의 Telegram 및 Discord 안내를 참고하면 됩니다.
구매 후 사이트가 상품을 자동으로 제공해야 한다면 「webhook으로 주문 결제를 자동 확인하는 방법」으로 진행하세요. 지원되는 공개 API는 Cryptanio 문서에 설명되어 있습니다.