POST /v0.1/payment/onramp/sessions
# Payment API는 JSON + Bearer 인증입니다
POST /v0.1/payment/onramp/sessions
Host: api.inexkr.com
Authorization: Bearer <secret_key>
Idempotency-Key: 3f9a1c2e-8b40-4d2a-9f11-...
Content-Type: application/json
{
"partner_id": "PARTNER-XXXX-001",
"customer_reference": "CUST-88210",
"fiat_currency": "KRW",
"fiat_amount": "1000000", // 문자열 · 최소단위
"target_stablecoin": "USDT",
"destination_wallet": "INEX-WALLET-88210",
"kyc_level": "TIER2",
"vasp_purpose_code": "FIAT_TO_STABLE"
}
// 201 Created
{
"object": "onramp_session",
"id": "onramp_7F2A91C3",
"status": "pending_payment",
"redirect_url": "https://pay.inexkr.com/s/7F2A91C3",
"quote": {
"fiat_amount": "1000000",
"stablecoin_amount": "745.86",
"rate": "1340.50",
"expires_at": "2026-08-04T09:25:00Z"
},
"created_at": "2026-08-04T09:15:00Z"
}
// 4xx 오류 응답 (공통 형식)
{
"error": {
"code": "ECompliance:KYC level insufficient",
"message": "TIER2 이상 필요",
"request_id": "req_5c81f0"
}
}OnrampOfframp견적 고정실명계좌
가장 규제가 무거운 구간을 대신 맡습니다
양방향 전환
원화에서 스테이블코인으로, 스테이블코인에서 원화로 양방향 전환을 처리합니다.
견적 고정
세션 생성 시 환율과 수량을 만료 시각까지 고정해 고객에게 그대로 안내할 수 있습니다.
라이선스 기반 처리
램프 구간은 규제 리스크가 가장 크게 걸리는 지점입니다. 라이선스를 갖춘 사업자가 처리합니다.
동작 방식
- 01
세션 생성
전환 금액과 대상 자산을 지정해 세션을 만듭니다.
- 02
견적 확정
환율과 수량이 만료 시각까지 고정됩니다.
- 03
결제 · 전환
원화 결제가 확인되면 스테이블코인으로 전환됩니다.
- 04
오프램프
반대 방향은 정산 지급 엔드포인트로 처리합니다.
- 01
세션 생성
전환 금액과 대상 자산을 지정해 세션을 만듭니다.
- 02
견적 확정
환율과 수량이 만료 시각까지 고정됩니다.
- 03
결제 · 전환
원화 결제가 확인되면 스테이블코인으로 전환됩니다.
- 04
오프램프
반대 방향은 정산 지급 엔드포인트로 처리합니다.
엔드포인트와 사양
주요 엔드포인트
POST
/v0.1/payment/onramp/sessionsGET
/v0.1/payment/onramp/{id}POST
/v0.1/payment/payoutsPOST
/0/private/RampOnOffEVT
onramp.session.completedEVT
payout.succeeded주요 사양
- 방향
- KRW → 스테이블코인 (온램프) · 스테이블코인 → KRW (오프램프)
- 지원 자산
- USDT · USDC 등 (지원 범위는 협의)
- 견적
- 세션 생성 시 환율·수량 고정 · 만료 시각 명시
- 정산 계좌
- 원화 실명확인 계좌
- 컴플라이언스
- 거래목적 코드 · KYC 등급 검증 필수
- 연동
- 일별 Net 청산 배치에 자동 합류
자주 묻는 질문
견적은 얼마 동안 유효한가요?
세션 생성 응답에 만료 시각이 함께 반환됩니다. 만료 후에는 세션을 새로 생성해야 합니다.
어떤 스테이블코인을 지원하나요?
USDT와 USDC를 중심으로 지원하며 대상 자산은 규제 환경과 파트너 요건에 따라 협의합니다.
환전과 무엇이 다른가요?
외국환 거래로서의 환전과는 법적 성격이 다릅니다. 원화와 스테이블코인 사이의 교환으로 이해하시는 것이 정확하며, 적용 법령은 사업 구조에 따라 검토가 필요합니다.
오프램프도 같은 API인가요?
오프램프는 정산 지급(Payouts) 엔드포인트로 처리하며, 결과는 온램프와 동일한 정산 배치로 합류합니다.
Get Started
INEX와 함께 시작하십시오
도입 검토 단계에 맞춰 필요한 자료와 논의를 제공합니다. 기술 검토와 규제 요건 정리를 함께 진행합니다.