POST /v0.1/wallets
{
"partner_id": "PARTNER-XXXX-001",
"wallet_type": "CUSTOMER",
"customer_reference": "CUST-88210",
"kyc_level": "TIER2",
"assets": ["KRW", "USDT", "USDC"]
}
→ 201 Created
{
"wallet_id": "INEX-WALLET-88210",
"status": "active",
"balances": { "KRW": "0", "USDT": "0" }
}사용자 지갑가맹점 지갑다중 자산
계정 구조를 직접 만들지 않아도 됩니다
사용자 지갑
고객 단위로 지갑을 발급하고 KYC 등급과 연결해 관리합니다.
가맹점 정산 지갑
정산 대상 가맹점·판매자별 지갑을 분리해 자금 흐름을 명확히 구분합니다.
다중 자산 잔액
원화와 스테이블코인 잔액을 하나의 지갑에서 함께 관리합니다.
동작 방식
- 01
발급
고객 또는 가맹점 단위로 지갑을 생성합니다.
- 02
입금
입금 주소를 발급하거나 온램프로 충전합니다.
- 03
운영
잔액과 거래 내역을 API와 대시보드에서 확인합니다.
- 04
정산
정산 시 지갑 잔액이 자동으로 반영됩니다.
- 01
발급
고객 또는 가맹점 단위로 지갑을 생성합니다.
- 02
입금
입금 주소를 발급하거나 온램프로 충전합니다.
- 03
운영
잔액과 거래 내역을 API와 대시보드에서 확인합니다.
- 04
정산
정산 시 지갑 잔액이 자동으로 반영됩니다.
엔드포인트와 사양
주요 엔드포인트
POST
/v0.1/walletsGET
/v0.1/wallets/{id}GET
/v0.1/wallets/{id}/balancesGET
/v0.1/wallets/{id}/transactionsPOST
/0/private/DepositAddressesWS
balances주요 사양
- 지갑 유형
- CUSTOMER (사용자) · MERCHANT (가맹점 정산)
- 지원 자산
- KRW · USDT · USDC 등 (지원 범위는 협의)
- 보관 구조
- MPC 기반 커스터디 위에서 운영
- KYC 연동
- 지갑 단위로 KYC 등급을 연결해 한도 정책 적용
- 실시간 통지
- 잔액 변동을 WebSocket balances 채널로 전달
자주 묻는 질문
지갑은 몇 개까지 발급할 수 있나요?
기술적 상한보다는 파트너 등급과 운영 정책에 따라 조정합니다. 대량 발급이 필요한 경우 도입 검토 시 함께 설계합니다.
지갑별로 한도를 다르게 줄 수 있나요?
KYC 등급과 연결해 한도 정책을 적용합니다. 세부 정책은 파트너 요건에 맞춰 설정합니다.
잔액 변동을 실시간으로 받을 수 있나요?
WebSocket balances 채널로 잔액 변동을 실시간 수신할 수 있습니다.
가맹점 지갑과 사용자 지갑은 무엇이 다른가요?
가맹점 지갑은 정산 대상 자금을 담고 정산 배치와 연결됩니다. 사용자 지갑은 개인 고객의 보유 자산을 관리하며 KYC 등급 정책이 적용됩니다.
Get Started
INEX와 함께 시작하십시오
도입 검토 단계에 맞춰 필요한 자료와 논의를 제공합니다. 기술 검토와 규제 요건 정리를 함께 진행합니다.