소개/참조
References
2328.io API 전반에서 사용되는 네트워크 코드, 통화-네트워크 매핑 및 결제 상태 값.
이 페이지는 API 요청과 응답에서 사용되는 모든 참조 값을 나열합니다.
네트워크 코드
다음 코드는 network 필드가 등장하는 모든 곳에서 사용됩니다:
| Code | Network |
|---|---|
TRX-TRC20 | Tron TRC-20 |
BSC-BEP20 | BNB Smart Chain |
ETH-ERC20 | Ethereum (ERC-20) |
AVAX-C | Avalanche C-Chain |
POL-MATIC | Polygon (Matic) |
TON | TON |
BTC | Bitcoin |
LTC | Litecoin |
DASH | Dash |
SOL | Solana |
DOGE | Dogecoin |
통화-네트워크 매핑
각 통화는 일부 네트워크에서만 사용할 수 있습니다. 다음 표를 활용해 유효한 조합을 선택하세요:
| Currency | 허용 네트워크 |
|---|---|
USDT | TRX-TRC20, BSC-BEP20, ETH-ERC20, AVAX-C, POL-MATIC, TON, SOL |
USDC | BSC-BEP20, ETH-ERC20, AVAX-C, POL-MATIC, SOL |
BTC | BTC |
ETH | ETH-ERC20 |
BNB | BSC-BEP20 |
TRX | TRX-TRC20 |
LTC | LTC |
DASH | DASH |
TON | TON |
AVAX | AVAX-C |
POL | POL-MATIC |
SOL | SOL |
DOGE | DOGE |
결제 상태
결제의 payment_status 필드와 /v1/payment/list 필터는 다음 값을 가질 수 있습니다:
| Status | 설명 |
|---|---|
pending | 생성됨, 초기화 대기 중 |
check | 고객의 결제 대기 중 |
paid | 결제 성공 |
underpaid_check | 부족 결제 (추가 입금 가능) |
underpaid | 부족 결제 |
overpaid | 초과 결제 (입금 처리됨) |
cancel | 취소됨 / 만료됨 |
aml_lock | AML로 인한 거래 차단 |
결제 성공을 수신할 때는 paid와 overpaid를 모두 성공 상태로 처리하고 고객의 주문에 반영해야 합니다.
출금 상태
/v1/payout 및 /v1/payout/status/{uuid}의 status 필드는 다음 중 하나의 값을 가집니다:
| Status | 설명 |
|---|---|
pending | 생성됨, 처리 대기 중 |
completed | 정상적으로 완료됨 — txid가 설정됨 |
failed | 전송 오류 — error_type 참조 |
cancelled | 취소됨 |
출금 오류 유형
출금이 status = failed 상태일 때 error_type 필드는 사유를 설명합니다:
| Code | 설명 |
|---|---|
aml_risk | AML 리스크 검사로 인해 출금이 차단됨 (수신자 주소가 고위험으로 표시됨) |