eSIMfly MCP

개발자를 위한 eSIM API: 자체 제품에서 eSIM 판매하기

200개 국가의 도매 eSIM 데이터 요금제를 앱, 플랫폼 또는 스토어에 단 하나의 REST API로 통합하세요 — 카탈로그, 주문, 충전, 사용량 및 전체 수명주기 관리가 가능합니다.

eSIM API를 활용하는 기업

기업들은 기존 제품에 연결 수익을 추가하기 위해 도매 eSIM 통합을 사용합니다.

여행 앱 및 OTA

예약 시점에 eSIM 업셀을 제공하세요. 여행자는 연결된 상태로 도착하고, 판매된 모든 요금제에서 수익을 유지할 수 있습니다.

리셀러 및 MVNO

도매 요금으로 eSIM을 공급받아 자체 채널을 통해 자체 가격과 패키징으로 판매하세요.

IoT 및 차량 관리 플랫폼

단일 통합으로 국경을 넘는 기기와 차량의 연결성을 프로비저닝하고 모니터링하세요.

슈퍼앱 및 핀테크

결제, 뱅킹 또는 로열티 제품 옆에 네이티브 기능으로 국제 데이터 요금제를 추가하세요.

API 기능

eSIM을 프로그래밍 방식으로 운영하는 데 필요한 모든 것

이 API는 도매 패키지 탐색부터 현장에서 활성 eSIM 관리까지 전체 여정을 다룹니다.

카탈로그 및 가격

200개 국가에 대한 도매 가격으로 사용 가능한 모든 데이터 패키지를 탐색하고, 주문 전에 계정 잔액을 확인하세요.

모든 패키지 조회잔액 조회

주문 및 충전

새 eSIM을 즉시 프로비저닝하고 기존 eSIM을 충전하세요. 주문 시 사용자에게 전달할 준비가 된 QR 코드와 활성화 세부 정보가 반환됩니다.

주문 생성패키지 및 주문 충전

eSIM 수명주기

발급한 모든 eSIM을 관리하세요: 상태 및 데이터 사용량 확인, 회선 일시중지 또는 취소, 네트워크 이벤트 검토, SMS 전송.

eSIM 조회 / 쿼리eSIM 상태취소 / 일시중지 / 활성화사용량 보고서네트워크 이벤트SMS 전송

웹훅

주문 및 eSIM 수명주기 이벤트에 대한 실시간 알림을 받을 엔드포인트를 등록하세요 — 폴링이 필요 없습니다.

웹훅 관리이벤트 알림

도매 eSIM 요금, 당신의 수익

API 파트너는 도매 가격으로 데이터 패키지를 구매하고 자체 소매 가격을 설정합니다. 카탈로그는 200개 국가와 450개 이상의 네트워크에 걸쳐 지역, 국가 및 글로벌 요금제를 포함하므로 단일 통합으로 사용자가 여행하는 모든 목적지를 커버합니다. 잔액 기반 청구는 정산을 간단하게 유지합니다: 계정에 자금을 충전하면 각 주문이 도매 요금으로 차감됩니다.

자체 구축 대신 완전한 스토어프론트를 원한다면, 화이트라벨 eSIM 리셀러 플랫폼이 동일한 인프라 위에 브랜드 웹사이트, 대시보드 및 모바일 앱을 제공합니다.

보안 설계: HMAC 서명 요청

모든 API 호출은 요청 타임스탬프, 고유 요청 ID, 액세스 코드 및 요청 본문에 대한 HMAC-SHA256 서명으로 인증됩니다 — 무결성 검증과 재생 공격 방지를 제공합니다. Node.js, Python 및 PHP용 준비된 서명 예제는 문서에 있습니다.

POST /api/v1/business/orders HTTP/1.1
Host: esimfly.net
Content-Type: application/json
RT-AccessCode: your-access-code
RT-RequestID: 6f1c2e4a-...        # unique UUID v4
RT-Timestamp: 1752403200000       # ms since epoch
RT-Signature: A3F0...             # HMAC-SHA256, see docs

{ "package_code": "...", "quantity": 1 }

세 단계로 API 액세스 받기

1. 비즈니스 계정 만들기

eSIMfly 비즈니스 계정에 가입하고 사용 사례와 예상 볼륨을 알려주세요.

2. API 키 생성

비즈니스 대시보드에서 액세스 자격 증명을 생성 및 관리한 후 잔액을 충전하세요.

3. 통합 및 출시

문서를 따라 패키지를 탐색하고 테스트 주문을 한 후, 비동기 프로비저닝된 eSIM을 위해 선택적으로 웹훅을 등록하세요.

FAQ

eSIM API 질문에 대한 답변

eSIMfly eSIM API란 무엇인가요?+

eSIMfly API는 도매 요금으로 eSIM을 프로그래밍 방식으로 구매, 프로비저닝 및 관리할 수 있는 REST API입니다. 패키지 카탈로그 탐색, 주문 생성, 요금제 충전, 사용량 모니터링 및 200개 국가, 450개 이상의 네트워크에서 전체 eSIM 수명주기(활성화, 일시중지, 취소)를 자체 애플리케이션에서 관리할 수 있습니다.

eSIM API는 누구를 위한 것인가요?+

이 API는 자체 제품에 eSIM 연결을 내장하려는 기업을 위해 구축되었습니다: 여행 앱 및 예약 플랫폼, 통신 리셀러 및 MVNO, IoT 및 차량 관리 플랫폼, 그리고 통신사 관계를 구축하지 않고 사용자에게 국제 데이터를 제공하려는 모든 서비스.

API 인증은 어떻게 작동하나요?+

요청은 HMAC-SHA256 서명으로 인증됩니다. 각 요청은 액세스 코드, 고유 요청 ID, 타임스탬프 및 비밀 키로 계산된 서명을 포함하며, 이는 요청 무결성 검증을 제공하고 재생 공격을 방지합니다. Node.js, Python 및 PHP용 코드 예제는 문서에서 확인할 수 있습니다.

eSIM API 액세스는 어떻게 받나요?+

eSIMfly 비즈니스 계정을 만든 후 비즈니스 대시보드에서 API 키를 생성하세요. 도매 가격 등급은 볼륨에 따라 다릅니다 — 예상 주문 볼륨에 대한 요금을 논의하려면 영업팀에 문의하세요.

API가 웹훅을 지원하나요?+

네. 웹훅은 비동기 프로비저닝된 eSIM이 준비되었을 때 알려줍니다 — 일부 통신사(예: KDDI Japan)는 몇 분이 걸리며, 폴링 대신 eSIM 세부 정보가 포함된 서명된 POST를 받게 됩니다. 대부분의 제공업체는 주문 응답에서 동기적으로 프로비저닝하며, 상태 및 사용량은 상태 및 사용량 엔드포인트를 통해 조회됩니다.

API 속도 제한은 무엇인가요?+

API는 계정당 시간당 1,000개의 요청을 허용합니다. 5분보다 오래된 요청은 재생 공격 방지의 일부로 거부됩니다. 통합에 더 높은 제한이 필요하면 영업팀에 문의하세요.

공식 SDK · NODE.JS / TYPESCRIPT

서명 코드 건너뛰기 — SDK 설치

npm install @esimfly/sdk는 전체 API에 대한 타입 기반 액세스를 제공합니다 — HMAC 서명, 새 요청 ID, 멱등 주문, 속도 조절 카탈로그 동기화 및 웹훅 서명 검증이 내장되어 있습니다. 제로 의존성, Node.js 18+, MIT 라이선스 및 오픈소스입니다. PHP 및 Python SDK는 다음으로 제공될 예정입니다.

AI 에이전트를 사용 중이신가요? 호스팅된 MCP 서버 https://mcp.esimfly.net/mcp를 Claude, ChatGPT 또는 Cursor에 추가하고 비즈니스 계정으로 로그인하세요 — 키를 붙여넣을 필요가 없습니다. 요금제 검색, 사용량 확인 및 라이브 API에 대한 eSIM 진단 — 기본적으로 읽기 전용이며, 주문 전 확인 단계가 있습니다. 로컬을 선호하시나요? npx -y @esimfly/mcp.

통합 튜토리얼

첫 요청부터 프로덕션 웹훅까지 작동하는 Node.js 코드.

[

여기서 시작 · 아키텍처 가이드

eSIM API 통합 가이드

네 가지 구성 요소, 서명된 인증, 동기식 vs 웹훅 프로비저닝, 제공업체 평가 체크리스트 및 프로덕션에서만 나타나는 함정.

가이드 읽기](https://esimfly.net/esim-api/integration-guide)

[

파트 1 · 약 30분

Node.js로 앱에서 eSIM 판매하기

HMAC 인증, 패키지 카탈로그, 주문 생성 및 QR 코드 전달 — 완전한 작동 스토어프론트.

튜토리얼 시작](https://esimfly.net/esim-api/tutorials/sell-esims-nodejs)[

파트 2 · 수명주기

충전, 사용량 추적 및 웹훅

실시간 사용량 조회, 기존 eSIM 충전 판매 및 폴링 없는 서명된 웹훅.

파트 2로 계속](https://esimfly.net/esim-api/tutorials/topups-usage-webhooks)

제품에 eSIM을 통합할 준비가 되셨나요?

문서로 시작하거나, 볼륨에 따른 도매 요금에 대해 팀과 상담하세요.