Sign in
소개/참조

References

2328.io API 전반에서 사용되는 네트워크 코드, 통화-네트워크 매핑 및 결제 상태 값.

이 페이지는 API 요청과 응답에서 사용되는 모든 참조 값을 나열합니다.

네트워크 코드

다음 코드는 network 필드가 등장하는 모든 곳에서 사용됩니다:

CodeNetwork
TRX-TRC20Tron TRC-20
BSC-BEP20BNB Smart Chain
ETH-ERC20Ethereum (ERC-20)
AVAX-CAvalanche C-Chain
POL-MATICPolygon (Matic)
TONTON
BTCBitcoin
LTCLitecoin
DASHDash
SOLSolana
DOGEDogecoin

통화-네트워크 매핑

각 통화는 일부 네트워크에서만 사용할 수 있습니다. 다음 표를 활용해 유효한 조합을 선택하세요:

Currency허용 네트워크
USDTTRX-TRC20, BSC-BEP20, ETH-ERC20, AVAX-C, POL-MATIC, TON, SOL
USDCBSC-BEP20, ETH-ERC20, AVAX-C, POL-MATIC, SOL
BTCBTC
ETHETH-ERC20
BNBBSC-BEP20
TRXTRX-TRC20
LTCLTC
DASHDASH
TONTON
AVAXAVAX-C
POLPOL-MATIC
SOLSOL
DOGEDOGE

결제 상태

결제의 payment_status 필드와 /v1/payment/list 필터는 다음 값을 가질 수 있습니다:

Status설명
pending생성됨, 초기화 대기 중
check고객의 결제 대기 중
paid결제 성공
underpaid_check부족 결제 (추가 입금 가능)
underpaid부족 결제
overpaid초과 결제 (입금 처리됨)
cancel취소됨 / 만료됨
aml_lockAML로 인한 거래 차단

결제 성공을 수신할 때는 paidoverpaid를 모두 성공 상태로 처리하고 고객의 주문에 반영해야 합니다.

출금 상태

/v1/payout/v1/payout/status/{uuid}status 필드는 다음 중 하나의 값을 가집니다:

Status설명
pending생성됨, 처리 대기 중
completed정상적으로 완료됨 — txid가 설정됨
failed전송 오류 — error_type 참조
cancelled취소됨

출금 오류 유형

출금이 status = failed 상태일 때 error_type 필드는 사유를 설명합니다:

Code설명
aml_riskAML 리스크 검사로 인해 출금이 차단됨 (수신자 주소가 고위험으로 표시됨)