eSIMfly MCP

API eSIM cho Nhà phát triển: Bán eSIM trong Sản phẩm của Bạn

Tích hợp gói dữ liệu eSIM bán buôn cho 200 quốc gia vào ứng dụng, nền tảng hoặc cửa hàng của bạn thông qua một REST API duy nhất — danh mục, đặt hàng, nạp thêm, sử dụng và quản lý toàn bộ vòng đời.

Ai Xây dựng trên API eSIM

Các công ty sử dụng tích hợp eSIM bán buôn để thêm doanh thu từ kết nối vào sản phẩm hiện có của họ.

Ứng dụng Du lịch & OTA

Cung cấp dịch vụ bán thêm eSIM vào thời điểm đặt chỗ. Khách du lịch của bạn đến nơi đã có kết nối, và bạn giữ biên lợi nhuận trên mỗi gói được bán.

Nhà bán lại & MVNO

Thu mua eSIM với giá bán buôn và bán qua kênh riêng của bạn, với giá và cách đóng gói của riêng bạn.

Nền tảng IoT & Đội xe

Cung cấp và giám sát kết nối cho thiết bị và phương tiện xuyên biên giới từ một tích hợp duy nhất.

Superapp & Fintech

Thêm gói dữ liệu quốc tế như một tính năng gốc bên cạnh thanh toán, ngân hàng hoặc sản phẩm khách hàng thân thiết.

KHẢ NĂNG API

Mọi thứ Bạn cần để Vận hành eSIM theo Lập trình

API bao quát toàn bộ hành trình từ duyệt các gói bán buôn đến quản lý eSIM đang hoạt động trên thực địa.

Danh mục & Giá

Duyệt mọi gói dữ liệu khả dụng với giá bán buôn cho 200 quốc gia, và kiểm tra số dư tài khoản trước khi đặt hàng.

Lấy Tất cả GóiTruy vấn Số dư

Đơn hàng & Nạp thêm

Cung cấp eSIM mới ngay lập tức và nạp thêm cho eSIM hiện có. Đơn hàng trả về mã QR và thông tin kích hoạt sẵn sàng để gửi đến người dùng của bạn.

Tạo Đơn hàngGói Nạp thêm & Đơn hàng

Vòng đời eSIM

Quản lý mọi eSIM bạn đã phát hành: kiểm tra trạng thái và mức sử dụng dữ liệu, tạm ngưng hoặc hủy đường dây, xem lại sự kiện mạng và gửi SMS.

Liệt kê / Truy vấn eSIMTrạng thái eSIMHủy / Tạm ngưng / Kích hoạtBáo cáo Sử dụngSự kiện MạngGửi SMS

Webhook

Đăng ký các điểm cuối để nhận thông báo thời gian thực cho các sự kiện đơn hàng và vòng đời eSIM — không cần thăm dò.

Quản lý WebhookThông báo Sự kiện

Giá eSIM Bán buôn, Biên lợi nhuận của Bạn

Các đối tác API mua gói dữ liệu với giá bán buôn và tự đặt giá bán lẻ. Danh mục bao gồm các gói địa phương, khu vực và toàn cầu trên 200 quốc gia và hơn 450 mạng, vì vậy một tích hợp duy nhất bao quát mọi điểm đến mà người dùng của bạn đi tới. Thanh toán dựa trên số dư giúp việc quyết toán đơn giản: nạp tiền vào tài khoản, và mỗi đơn hàng sẽ trừ vào đó theo giá bán buôn của bạn.

Nếu bạn muốn một cửa hàng hoàn chỉnh thay vì tự xây dựng, nền tảng đại lý eSIM nhãn trắng của chúng tôi cung cấp website, bảng điều khiển và ứng dụng di động mang thương hiệu của bạn trên cùng cơ sở hạ tầng.

Bảo mật theo Thiết kế: Yêu cầu Ký HMAC

Mọi lệnh gọi API đều được xác thực bằng chữ ký HMAC-SHA256 trên dấu thời gian yêu cầu, một ID yêu cầu duy nhất, mã truy cập của bạn và nội dung yêu cầu — mang lại xác minh tính toàn vẹn và bảo vệ chống tấn công phát lại. Các ví dụ ký sẵn cho Node.js, Python và PHP có trong tài liệu.

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 }

Nhận Quyền truy cập API trong Ba Bước

1. Tạo tài khoản doanh nghiệp

Đăng ký tài khoản doanh nghiệp eSIMfly và cho chúng tôi biết về trường hợp sử dụng và khối lượng dự kiến của bạn.

2. Tạo khóa API của bạn

Tạo và quản lý thông tin xác thực truy cập từ bảng điều khiển doanh nghiệp, sau đó nạp tiền vào số dư của bạn.

3. Tích hợp và ra mắt

Làm theo tài liệu để duyệt các gói, đặt đơn hàng thử nghiệm và tùy chọn đăng ký webhook cho các eSIM được cung cấp bất đồng bộ.

FAQ

Câu hỏi về API eSIM, Đã được Giải đáp

API eSIM của eSIMfly là gì?+

API eSIMfly là một REST API cho phép bạn mua, cung cấp và quản lý eSIM theo lập trình với giá bán buôn. Bạn có thể duyệt danh mục gói, tạo đơn hàng, nạp thêm gói, giám sát mức sử dụng và quản lý toàn bộ vòng đời eSIM (kích hoạt, tạm ngưng, hủy) từ ứng dụng của riêng bạn, với phạm vi phủ sóng tại 200 quốc gia trên hơn 450 mạng.

API eSIM dành cho ai?+

API được xây dựng cho các công ty muốn nhúng kết nối eSIM vào sản phẩm của riêng họ: ứng dụng du lịch và nền tảng đặt chỗ, nhà bán lại viễn thông và MVNO, nền tảng IoT và đội xe, và bất kỳ dịch vụ nào muốn cung cấp dữ liệu quốc tế cho người dùng mà không cần xây dựng quan hệ với nhà mạng.

Xác thực API hoạt động như thế nào?+

Các yêu cầu được xác thực bằng chữ ký HMAC-SHA256. Mỗi yêu cầu mang một mã truy cập, một ID yêu cầu duy nhất, một dấu thời gian và một chữ ký được tính bằng khóa bí mật của bạn, mang lại xác minh tính toàn vẹn yêu cầu và ngăn chặn tấn công phát lại. Các ví dụ mã cho Node.js, Python và PHP có sẵn trong tài liệu.

Làm thế nào để tôi có quyền truy cập API eSIM?+

Tạo tài khoản doanh nghiệp eSIMfly, sau đó tạo khóa API từ bảng điều khiển doanh nghiệp. Các bậc giá bán buôn phụ thuộc vào khối lượng — liên hệ đội ngũ kinh doanh của chúng tôi để thảo luận về mức giá cho khối lượng đơn hàng dự kiến của bạn.

API có hỗ trợ webhook không?+

Có. Webhook thông báo cho bạn khi các eSIM được cung cấp bất đồng bộ đã sẵn sàng - một số nhà mạng (như KDDI Nhật Bản) mất vài phút, và thay vì thăm dò, bạn nhận được một POST đã ký với thông tin eSIM. Hầu hết các nhà cung cấp cung cấp đồng bộ trong phản hồi đơn hàng, và trạng thái cùng mức sử dụng được truy vấn qua các điểm cuối trạng thái và sử dụng.

Giới hạn tốc độ API là gì?+

API cho phép 1.000 yêu cầu mỗi giờ cho mỗi tài khoản. Các yêu cầu cũ hơn 5 phút bị từ chối như một phần của bảo vệ chống tấn công phát lại. Nếu bạn cần giới hạn cao hơn cho tích hợp của mình, hãy liên hệ kinh doanh.

SDK CHÍNH THỨC · NODE.JS / TYPESCRIPT

Bỏ qua mã ký — cài đặt SDK

npm install @esimfly/sdk cung cấp cho bạn quyền truy cập có kiểu vào toàn bộ API — ký HMAC, ID yêu cầu mới, đơn hàng idempotent, đồng bộ danh mục có nhịp độ và xác minh chữ ký webhook đều được tích hợp sẵn. Không phụ thuộc, Node.js 18+, giấy phép MIT và mã nguồn mở. SDK PHP và Python sẽ ra mắt tiếp theo.

Đang dùng tác nhân AI? Thêm MCP server được lưu trữ https://mcp.esimfly.net/mcp vào Claude, ChatGPT hoặc Cursor và đăng nhập bằng tài khoản doanh nghiệp của bạn — không cần dán khóa. Tìm kiếm gói, kiểm tra mức sử dụng và chẩn đoán eSIM dựa trên API trực tiếp; chỉ đọc theo mặc định, với bước xác nhận trước bất kỳ đơn hàng nào. Thích cục bộ? npx -y @esimfly/mcp.

Hướng dẫn Tích hợp

Mã Node.js hoạt động được, từ yêu cầu đầu tiên đến webhook trong môi trường sản xuất.

[

BẮT ĐẦU TẠI ĐÂY · HƯỚNG DẪN KIẾN TRÚC

Hướng dẫn Tích hợp API eSIM

Bốn khối xây dựng, xác thực có ký, cung cấp đồng bộ so với webhook, danh sách kiểm tra đánh giá nhà cung cấp, và những cạm bẫy chỉ xuất hiện trong môi trường sản xuất.

Đọc hướng dẫn](https://esimfly.net/esim-api/integration-guide)

[

PHẦN 1 · ~30 PHÚT

Bán eSIM trong Ứng dụng của Bạn với Node.js

Xác thực HMAC, danh mục gói, tạo đơn hàng và gửi mã QR — một cửa hàng hoàn chỉnh hoạt động được.

Bắt đầu hướng dẫn](https://esimfly.net/esim-api/tutorials/sell-esims-nodejs)[

PHẦN 2 · VÒNG ĐỜI

Nạp thêm, Theo dõi Sử dụng & Webhook

Truy vấn mức sử dụng trực tiếp, bán nạp thêm trên eSIM hiện có, và webhook có ký mà không cần thăm dò.

Tiếp tục phần hai](https://esimfly.net/esim-api/tutorials/topups-usage-webhooks)

Sẵn sàng tích hợp eSIM vào sản phẩm của bạn?

Bắt đầu với tài liệu, hoặc trao đổi với đội ngũ của chúng tôi về giá bán buôn cho khối lượng của bạn.