USDT (Binance)
관리자 위치: Finance › Payment channels › USDT (
/payments/usdt). 스위치 및 수수료: Finance › Payment channels › Fees & limits (/payments/fees). 미매칭 입금: Finance › Payment channels › Gateway events › PayPal & USDT (/payments/events?tab=gateways).
작동 내용
고객이 고객님의 바이낸스 입금 주소로 USDT를 송금하면, NexCMP는 읽기 전용 바이낸스 API 키를 통해 입금 내역을 읽고 미결제 요청과 입금이 일치할 때 지갑을 충전합니다. 바이낸스에서 부과하는 수수료 외에는 결제 처리 수수료가 없으며, NexCMP는 어떠한 개인키도 보유하지 않습니다.
요구 사항
| 항목 | 요구 사항 |
|---|---|
| 바이낸스 계정 | 선택한 네트워크에서 USDT 입금이 활성화된 인증된 바이낸스 계정. |
| API 키 | Enable Reading 페이지만 허용된 바이낸스 API 키. Enable Withdrawals, Internal Transfer, Spot/Margin Trading은 반드시 꺼져 있어야 합니다. |
| IP 제한 | 강력히 권장됨: 키를 서버의 아웃바운드 IP로 제한하세요(Test & verify address 대화상자에 표시됨). |
| 네트워크 | api.binance.com(으)로의 아웃바운드 HTTPS. 인바운드 포트는 필요하지 않습니다. |
| 지원되는 네트워크 | TRX(Tron, TRC20), BSC(BNB Smart Chain, BEP20), SOL(Solana), ETH(Ethereum, ERC20). 코인은 USDT로 고정되어 있습니다. |
| 의존성 | 없음. |
네트워크를 한 번만 선택하세요
잘못된 네트워크로 송금한 고객은 자금을 잃게 됩니다. 고객의 거래소가 지원하는 수수료가 낮은 네트워크를 선택하고(TRX와 BSC가 일반적인 선택임), 자주 변경하지 마세요.
인프라 준비
- 바이낸스에서 Account › API Management을 열고 새 API 키를 생성합니다(시스템 생성). "NexCMP"와 같은 레이블을 지정하세요.
- 권한을 편집합니다: Enable Reading만 체크된 상태로 둡니다. 출금, 이체 또는 거래를 활성화하지 마세요.
- Restrict access to trusted IPs only 아래에 NexCMP 서버의 공인 IP 주소를 추가합니다. 아직 모르는 경우 제한 없이 키를 생성하고 NexCMP에서 첫 번째 테스트를 실행한 후(아웃바운드 IP가 출력됨) IP를 추가하세요.
- API key 및 Secret key를 복사합니다(시크릿은 한 번만 표시됨).
- Wallet › Deposit › Crypto를 열고 USDT 및 사용할 네트워크를 선택한 다음 입금 주소를 복사합니다(예: TRX의
T...주소 또는 BSC/ETH의0x...).
NexCMP에서 연결
- Finance › Payment channels › USDT를 엽니다(
/payments/usdt). - **API key (Binance › API Management)**에 API key와 API secret을 붙여넣습니다. 둘 다 함께 입력해야 합니다.
- Deposit address에서 Network를 선택하고 선택한 네트워크의 USDT 입금 주소를 붙여넣습니다. 형식은 네트워크에 대해 검증됩니다(TRX의 경우
T+ 33자, BSC 및 ETH의 경우0x+ 40 1진수 문자, SOL의 경우 base58). - Save를 클릭합니다. 주소나 네트워크를 변경하면 검증이 초기화되며 다시 검증할 때까지 채널이 일시 중지됩니다. 페이지에서 확인을 요청합니다.
- Test & verify address를 클릭합니다. (저장되지 않은 변경 사항은 거부되며, 검증은 저장된 구성을 기준으로 실행됩니다.) 대화상자에 다음 정보가 표시됩니다.
- 키 권한(읽기, 출금, 내부 이체, 거래, IP 제한) — 위험한 권한에 대한 빨간색 경고;
- 서버의 아웃바운드 IP(바이낸스에 입력할 값);
- 네트워크(입금 열림 또는 닫힘, 필수 승인 수, 먼지(dust));
- 해당 네트워크에 대해 바이낸스가 발행한 주소 및 사용자의 주소와 일치하는지 여부.
- 주소가 일치하면 NexCMP는 검증 시간을 기록합니다. 그 후에야 Fees & limits를 열고 **USDT (Binance)**를 켜고 USDT fee %(기본값 1) 및 USDT request expires after (mins)(5~180, 기본값 30)를 확인한 후 Save channels & fees를 클릭할 수 있습니다.
결제가 일치되는 방식
- 고객이 Billing › Deposit › USDT에 금액을 입력하고 Get deposit address를 클릭합니다.
- NexCMP가 요청을 생성하고 주소, 네트워크, 소수점 이하 여섯 자리의 정확한 금액(예:
19.173742)을 표시합니다. 마지막 네 자리는 해당 요청에 대해 금액을 고유하게 만드는 무작위 넌스(nonce)입니다. - 고객은 해당 네트워크에서 정확히 그 금액을 전송해야 합니다. 일치하지 않는 결제(반올림된 금액, 잘못된 네트워크)는 자동으로 할당될 수 없습니다.
- 60초마다 NexCMP는 지난 24시간 동안의 바이낸스 입금을 읽습니다. 일치하는 입금은 요청을 confirming으로 이동시키며, 바이낸스에 필요한 승인이 완료되면 지갑에 크레딧이 적립됩니다. 자금이 확인된 요청은 승인이 대기되는 동안 절대 만료되지 않습니다.
- 만료 시간(기본값 30분) 내에 지불되지 않은 요청은 만료됨으로 표시됩니다.
확인
- 주소가 검증되고 USDT가 켜진 후 테스트 고객으로 로그인하여 소액 입금(최소 충전 금액)을 요청합니다.
- 다른 지갑이나 거래소에서 정확한 금액을 전송합니다. 몇 분 정도 기다려 주세요.
- 포털에 Transfer seen — confirming이 표시된 다음 USDT received — balance updated가 표시됩니다.
- USDT 페이지에 최근 Last poll 시간과 0인 Unmatched가 표시됩니다.
한도 및 참고 사항
- Rate. 1 USDT = 1.00 USD. **USDT fee %**의 수수료는 고객에게 표시되며 Customer pays top-up fee에 따라 금액에서 차감되거나 추가됩니다.
- No refunds. NexCMP는 USDT 결제를 소스 계정에 환불하지 않습니다(HTTP 409
usdt_no_refund). 필요한 경우 시스템 외부에서 수동으로 환불하세요. - Pending limit. 고객은 제한된 수의 오픈 요청을 가질 수 있으며, 이를 초과하면 서버가
too_many_pending(HTTP 429)으로 응답합니다. - Resellers는 자신만의 바이낸스 계정을 사용할 수 있습니다. Resellers를 참조하세요.
- Binance 계정을 다른 시스템과 공유하는 경우, 두 폴러(poller)가 절대 동일한 입금을 동시에 조회하지 않도록 각 시스템에 서로 다른 네트워크를 할당하세요.
일치하지 않는 입금
요청과 일치하지 않는 입금(잘못된 금액, 잘못된 네트워크, 만료된 요청)은 deposit.unmatched 이벤트 및 관리자 알림을 생성합니다. Payment channels › Gateway events › PayPal & USDT를 열고, 이벤트를 찾아 Binance에서 트랜잭션을 확인한 후 할당 작업을 클릭하여 올바른 고객에게 크레딧을 부여하세요. 그 후 USDT 페이지 및 채널 개요의 Unmatched 카운터가 0으로 떨어집니다.
Troubleshooting
| 증상 | 원인 | 해결 방법 |
|---|---|---|
| "API key와 secret은 함께 입력해야 합니다" | 하나의 필드만 입력됨 | 둘 다 입력하세요. |
| "주소가 네트워크 형식...이 아닙니다" | 주소가 선택한 네트워크와 일치하지 않음 | Binance에서 동일한 네트워크로 다시 복사하세요. |
| "저장되지 않은 변경 사항 — 먼저 저장한 후 테스트하세요" | 저장된 설정으로 테스트가 실행됨 | Save를 클릭한 후 테스트하세요. |
| 경고 "키에 출금 허용(Enable Withdrawals)이 설정되어 있음" | 초과된 권한 | Binance API 관리에서 제거하세요. |
| 경고 "키가 IP로 제한되지 않음" | ipRestrict이(가) 꺼져 있음 | 대화상자에 표시된 서버의 아웃바운드 IP를 추가하세요. |
| 경고 "키에 읽기 허용(Enable Reading)이 없음" | 권한 누락 | Enable Reading을 활성화하세요. |
| 경고 "Binance에서 해당 네트워크의 USDT 입금이 비활성화되어 있음" | 네트워크 일시 중단됨 | 다른 네트워크를 선택하거나 대기하세요. |
| "위험: 설정된 주소가 Binance가 발급한 주소와 다릅니다" | 잘못된 주소 또는 네트워크 | Binance에서 해당 네트워크의 주소를 다시 복사하세요. |
| Fees & limits에서 USDT 스위치가 비활성화됨 | 주소가 확인되지 않음 | 일치할 때까지 Test & verify address를 실행하세요. |
| 고객이 결제했으나 크레딧이 충전되지 않음 | 반올림된 금액 또는 잘못된 네트워크 | Gateway events에서 이벤트를 찾아 수동으로 할당하세요. |
| 입금은 확인되었으나 오랜 시간 대기 중 | 아직 충분한 컨펌이 이루어지지 않음 | 기다려 주세요. 컨펌 중에는 요청이 만료되지 않습니다. |