시스템 개요

이음(IEUM)은 Avalanche 블록체인 기반 원화(KRW) 스테이블코인 인프라를 파트너사(은행/기업)가 별도의 블록체인 전문 지식 없이도 자사 앱에 통합할 수 있도록 설계된 화이트라벨링 플랫폼입니다.

1.1 4-Layer 아키텍처

계층	명칭	역할
L0	Asset (CHAUM)	법정화폐 담보 및 스테이블코인 원장 관리. Mint/Burn 기초 계층.
L1	Settlement (PayChain)	정산 커널. Receipt를 배치(Batch)로 묶어 앵커링 — 법적 정산 최종성(Finality) 부여.
L2	Payment Credit (PayPoint)	결제 실행 레이어. 실시간 크레딧 승인 및 정책 집행. 오프체인 하이브리드 원장 기반.
L3	Incentive/Network (PIN/sPIN)	정산 인디케이터. 확정된 정산 상태를 표시하는 메타데이터 레이어.

1.2 핵심 원칙: Payment ≠ Settlement

• Payment (L2/PayPoint): UX 중심의 즉시 실행 이벤트. 가스비·체인 지연 없이 1초 내 승인.

• Settlement (L1/PayChain): 회계·감사 중심의 확정 이벤트. 배치 단위 영수증을 온체인 앵커링하여 단일 진실 원칙(SSOT) 확립.

1.3 지갑 타입 및 주요 기능

지갑 타입	용도	특징
NORMAL	일반 결제·충전 지갑	충전/환불/결제 모두 지원. 기본 결제 수단.
INCENTIVE	적립금 지갑	결제 시 NORMAL 지갑 사용분에 대해 인센티브 적립. 결제 시 우선 차감.
GOVERNMENT	정책 지갑	현재 정책상 0원 고정. 복합결제 워터폴 최우선 차감 대상.

1.4 인증 방식

모든 API 요청은 업체별로 발급된 API Key를 통해 인증됩니다.

• Authorization 헤더에 Bearer Token 형식으로 API Key를 포함합니다.

• API Key 만료 시 Secret Key를 사용하여 갱신하며, 이전 Key는 갱신 후 24시간 동안 유효합니다.

• API Key와 Secret Key는 클라이언트 사이드 코드에 절대 노출하지 마십시오.

Authorization: Bearer {API_KEY}

멱등성(Idempotency) 지원 송금·충전·결제 등 금융 API에는 X-Idempotency-Key 헤더 사용을 강력히 권장합니다. 동일한 키로 중복 요청 시 기존 결과를 반환하여 이중 처리를 방지합니다.