지갑을 API로 발급하고 관리합니다

사용자 지갑과 가맹점 정산용 지갑을 필요한 만큼 발급합니다. 잔액과 내역은 API와 대시보드 양쪽에서 확인합니다.

API 문서 보기
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 등급과 연결해 관리합니다.

가맹점 정산 지갑

정산 대상 가맹점·판매자별 지갑을 분리해 자금 흐름을 명확히 구분합니다.

다중 자산 잔액

원화와 스테이블코인 잔액을 하나의 지갑에서 함께 관리합니다.

동작 방식

  1. 01

    발급

    고객 또는 가맹점 단위로 지갑을 생성합니다.

  2. 02

    입금

    입금 주소를 발급하거나 온램프로 충전합니다.

  3. 03

    운영

    잔액과 거래 내역을 API와 대시보드에서 확인합니다.

  4. 04

    정산

    정산 시 지갑 잔액이 자동으로 반영됩니다.

엔드포인트와 사양

주요 엔드포인트

POST/v0.1/wallets
GET/v0.1/wallets/{id}
GET/v0.1/wallets/{id}/balances
GET/v0.1/wallets/{id}/transactions
POST/0/private/DepositAddresses
WSbalances

주요 사양

지갑 유형
CUSTOMER (사용자) · MERCHANT (가맹점 정산)
지원 자산
KRW · USDT · USDC 등 (지원 범위는 협의)
보관 구조
MPC 기반 커스터디 위에서 운영
KYC 연동
지갑 단위로 KYC 등급을 연결해 한도 정책 적용
실시간 통지
잔액 변동을 WebSocket balances 채널로 전달

자주 묻는 질문

지갑은 몇 개까지 발급할 수 있나요?

기술적 상한보다는 파트너 등급과 운영 정책에 따라 조정합니다. 대량 발급이 필요한 경우 도입 검토 시 함께 설계합니다.

지갑별로 한도를 다르게 줄 수 있나요?

KYC 등급과 연결해 한도 정책을 적용합니다. 세부 정책은 파트너 요건에 맞춰 설정합니다.

잔액 변동을 실시간으로 받을 수 있나요?

WebSocket balances 채널로 잔액 변동을 실시간 수신할 수 있습니다.

가맹점 지갑과 사용자 지갑은 무엇이 다른가요?

가맹점 지갑은 정산 대상 자금을 담고 정산 배치와 연결됩니다. 사용자 지갑은 개인 고객의 보유 자산을 관리하며 KYC 등급 정책이 적용됩니다.