PULSE Developer Center
Guides
API Reference
Guides
API Reference
  1. KYC System
  • Overview
  • Quickstart
    • Sign Up
    • 첫 토큰 발행하기(ST)
    • 첫 토큰 발행하기(DT)
  • Auth - API Key
    • API Key
  • KYC System
    • KYC System
  • Token System
    • Token System
    • Operator
    • Locker
    • Partition
    • Document
    • DT (Deposit Token)
  • Swap System
    • Swap System
  1. KYC System

KYC System

PULSE에서 KYC(Know Your Customer) 는 투자자 신원확인 및 토큰 이동을 제어하는 핵심 보안 시스템입니다.
이 가이드에서는 KYC 등록 방법과 주소 준비 방식에 대해 안내합니다.

🤔 KYC란?#

KYC(Know Your Customer) 는 금융기관이 고객의 신원을 확인하고 검증하는 프로세스입니다.

💡 쉬운 이해를 위한 비유#

은행에서 계좌를 개설할 때 신분증을 확인하는 것과 같습니다. PULSE에서도 토큰을 받기 전에 투자자의 지갑 주소를 KYC 레지스트리에 등록하여 안전하고 규제에 맞는 거래환경을 제공합니다.

이유설명
규제 준수시큐리티 토큰은 금융 규제 대상으로 신원 확인 필수
투자자 보호적격 투자자 확인 및 관리로 투자자 안전 보장
토큰 이동 제어등록된 주소로만 토큰 이동을 허용하여 보안 강화

⚡ PULSE KYC 특징 (Global KYC)#

특징설명
글로벌 레지스트리모든 토큰이 단일 공용 KYC 레지스트리를 공유. 한 번 등록하면 모든 PULSE 토큰에서 사용
토큰별 등록 불필요요청 시 토큰 심볼을 지정하지 않음 (일괄 등록/해제)
API 기반 관리PULSE API를 통한 효율적인 KYC 등록 및 관리

🏗️ 투자자 주소 준비#

투자자(홀더) 주소는 미리 준비된 EOA 주소를 사용합니다. 토큰 발행·전송 시 홀더 주소는 시스템이 자동 유도하지 않고 직접 지정합니다.
권장 방식은 안전하게 관리되는 지갑/키 관리 인프라(HSM·KMS 등) 에서 발급받은 주소를 사용하는 것입니다.

🔑 간편 생성 옵션#

빠르게 주소가 필요할 때는 회원관리 → EOA 주소 생성 탭에서 간편하게 EOA 주소를 만들 수도 있습니다.
⚠️ 이 탭에서 만든 EOA 주소와 개인키는 브라우저에서만 생성되어 서버로 전송되지 않습니다. 개인키를 직접 안전하게 보관해야 하며 분실 시 복구할 수 없습니다. 실운영에서 키를 직접 보관하는 부담·위험을 피하려면 보안 키 관리 인프라 사용을 권장합니다.

member-keygen.png#

🔧 회원사 코드 vs 발행사 코드#

📋 코드 구분#

PULSE에서는 두 가지 다른 코드를 사용합니다:
구분용도확인 가능 여부설명
회원사 코드PULSE 플랫폼 내 회원사 식별, 블록체인 식별에 사용✅ 확인 가능영문+숫자 조합 (예: WE7M6D5XMZ)
발행사 코드예탁원 코드 도입 예정 (현재 미사용·미확정)❌ 확인 불가아직 확정되지 않음

🔍 회원사 코드 확인 방법#

1.
PULSE Web 좌측 메뉴에서 회원관리 클릭
2.
회원 정보 탭 선택
3.
회원정보 화면에서 회원사 코드 항목 확인 (예: WE7M6D5XMZ)

🔄 KYC 등록 프로세스#

1️⃣ 투자자 EOA 주소 확보#

발행사가 투자자의 지갑 주소(EOA)를 확보합니다.

2️⃣ 발행사 KYC 심사 및 등록#

발행사에서 자체 기준에 따라 KYC 심사 진행 후, PULSE API로 KYC 레지스트리에 등록합니다.

3️⃣ 토큰 이동 가능#

KYC 등록이 완료된 주소로만 토큰 이동이 허용됩니다.
PULSE Web에서는 KYC관리 화면에서 등록/해제/조회를 처리할 수 있습니다.
kyc.png

📚 KYC API 사용법#

글로벌 레지스트리라 토큰 심볼 없이 주소 배열만 전달합니다.

🟢 KYC 등록#

Request Body#

{
  "holders": ["0xFE3B557E8Fb62b89F4916B721be55cEb828dBd73"]
}

🔍 KYC 등록 여부 확인#

🔴 KYC 등록 해제#

요청·응답 필드와 상세 스펙은 API Reference → KYC 를 참고하세요. 인증 방식은 API Key 가이드를 참고하세요.

⚠️ 토큰 이동 제한사항#

✅ 토큰 이동 조건#

송신자·수신자 모두 KYC 레지스트리에 등록된 상태여야 함 (온체인에서 강제)

❌ KYC 미등록 시 제한사항#

토큰 수신 불가#

KYC 레지스트리에 등록되지 않은 주소는 토큰 수신 불가
전송 시도 시 시스템에서 자동 차단

거래 제한#

모든 토큰 거래는 KYC 등록된 주소 간에만 가능

🤔 자주 묻는 질문#

Q: 토큰마다 따로 KYC를 등록해야 하나요?#

A: 아니요. 글로벌 레지스트리에 한 번 등록하면 모든 PULSE 토큰에서 사용됩니다. 요청 시 토큰 심볼을 지정하지 않습니다.

Q: 투자자 주소는 어떻게 만드나요?#

A: 외부 지갑의 EOA 주소를 사용하거나, 회원관리 → EOA 주소 생성 탭에서 생성합니다.

Q: 주소를 잘못 등록했을 때는 어떻게 하나요?#

A: 해제 후 올바른 주소를 다시 등록하면 됩니다. 이미 토큰이 잘못된 주소로 이동한 경우, Operator/Controller 강제 전송으로 자산 복구가 가능합니다.

Next Step 👉 Token System 가이드
수정일 2026-07-02 01:23:49
이전
API Key
다음
Token System
Built with