TripoSIM
API Dành Cho Nhà Phát Triển

Tích Hợp eSIM Vào Sản Phẩm Của Bạn Trong Vài Giờ, Không Phải Vài Tháng

RESTful API. OAuth2. Sandbox. Webhook. 179+ điểm đến. Hạ tầng cấp doanh nghiệp được hỗ trợ bởi 22+ năm kinh nghiệm viễn thông.

200+
Điểm Đến
99.9%
SLA Uptime
< 3s
Thời Gian Cấp Phát
5
Nhà Cung Cấp Được Tổng Hợp
Tính Năng API

Được Xây Dựng Bởi Nhà Phát Triển, Dành Cho Nhà Phát Triển

Mọi tính năng bạn cần để tích hợp cấp phát eSIM vào sản phẩm của mình một cách đáng tin cậy và an toàn.

Xác Thực OAuth2

Luồng client_credentials theo tiêu chuẩn ngành. Access token hết hạn sau 15 phút và tự động được làm mới bởi các SDK của chúng tôi.

Chế Độ Sandbox

Kiểm tra với dữ liệu giả lập trước khi triển khai thực tế. Không tính phí ví, không cấp phát eSIM thật. Khóa API sandbox riêng biệt.

Thông Báo Webhook

Webhook được ký bằng HMAC-SHA256 với cơ chế thử lại backoff theo cấp số nhân. 6 loại sự kiện: order.completed, esim.activated, usage.threshold, và nhiều hơn nữa.

Đơn Hàng Thử Nghiệm (Dry-Run)

Xác thực đơn hàng mà không tính phí ví của bạn. Hoàn hảo để xem trước UI, kiểm tra tính khả dụng và ước tính giá trước khi cam kết.

Khóa Idempotency

Ngăn chặn các khoản phí trùng lặp khi thử lại kết nối. Mọi endpoint tạo đơn đều chấp nhận khóa idempotency với cửa sổ loại trùng 24 giờ.

Định Tuyến Đa Nhà Cung Cấp

5 nhà cung cấp eSIM upstream được tổng hợp sau một API duy nhất. Tự động chuyển đổi dự phòng đảm bảo tỷ lệ thành công cấp phát 99,9%.

Luồng Tích Hợp

Năm Bước Để Có eSIM Đầu Tiên

1

Lấy Khóa API

Đăng ký tại partners.triposim.com, được phê duyệt và tạo khóa API sandbox từ bảng điều khiển nhà phát triển.

2

Xác Thực

Trao đổi thông tin xác thực client của bạn để lấy access token 15 phút qua endpoint /v1/auth/token.

3

Duyệt Danh Mục

Truy vấn /v1/packages với các bộ lọc quốc gia, loại và giá để tìm các kế hoạch eSIM có sẵn.

4

Đặt Hàng

POST đến /v1/orders với ID gói và số lượng. Nhận ICCID và mã QR trong phản hồi.

5

Giao Cho Người Dùng

Hiển thị mã QR trong ứng dụng của bạn hoặc gửi qua email. Khách hàng quét để cài đặt eSIM.

Ví Dụ Code

Bắt Đầu Với Ngôn Ngữ Của Bạn

# 1. Get access token
curl -X POST https://api.triposim.com/v1/auth/token \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "your_client_id",
    "client_secret": "your_client_secret",
    "grant_type": "client_credentials"
  }'

# 2. Order an eSIM
curl -X POST https://api.triposim.com/v1/orders \
  -H "Authorization: Bearer {access_token}" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: unique-request-id" \
  -d '{
    "package_id": "turkey-5gb-30d",
    "quantity": 1
  }'
Các Endpoint

Tổng Quan Tài Liệu API

REST API sạch, có thể đoán trước. Tài liệu đầy đủ có tại docs.triposim.com.

Phương ThứcEndpointMô Tả
POST/v1/auth/tokenLấy access token
GET/v1/packagesDuyệt danh mục eSIM
GET/v1/packages/{id}Lấy chi tiết gói
POST/v1/ordersTạo đơn hàng (cấp phát eSIM)
GET/v1/ordersDanh sách đơn hàng
GET/v1/orders/{id}Lấy chi tiết đơn hàng
GET/v1/esims/{iccid}Trạng thái & chi tiết eSIM
GET/v1/esims/{iccid}/usageSử dụng dữ liệu thời gian thực
GET/v1/account/balanceSố dư ví
POST/v1/webhooksĐăng ký endpoint webhook
GET/v1/healthKiểm tra tình trạng API
Trường Hợp Sử Dụng

Được Xây Dựng Cho Mọi Nền Tảng Du Lịch

Ứng Dụng Fintech Siêu Ứng Dụng

Thêm eSIM vào mảng du lịch của bạn cùng với vé máy bay, khách sạn và bảo hiểm. Kết nối dữ liệu một chạm cho người dùng của bạn.

Hãng Hàng Không

Cung cấp eSIM điểm đến trong quá trình đặt vé. Hành khách đến nơi với dữ liệu đã được cấp phát sẵn trên thiết bị của họ.

Nền Tảng Du Lịch

Gói eSIM với vé máy bay và khách sạn. Tăng giá trị đơn hàng trung bình với một add-on biên lợi nhuận cao, không có tồn kho.

MVNO

White-label eSIM dưới thương hiệu của bạn. Toàn quyền kiểm soát API đối với cấp phát, thương hiệu và trải nghiệm khách hàng.

Công Cụ Du Lịch Công Ty

Tự động hóa kết nối cho nhân viên. Cấp phát eSIM dựa trên lịch trình di chuyển, theo dõi sử dụng và quản lý chi phí tập trung.

Doanh Nghiệp

Cấp Doanh Nghiệp Cho Các Đối Tác Lớn Hơn

Đang xử lý hàng nghìn eSIM mỗi tháng? Cấp doanh nghiệp của chúng tôi được xây dựng để mở rộng quy mô và đảm bảo độ tin cậy.

Hỗ Trợ Chuyên Biệt

Kênh Slack/Teams trực tiếp với nhóm kỹ thuật của chúng tôi. Thời gian phản hồi đảm bảo trong vòng 2 giờ trong giờ làm việc.

Giới Hạn Tốc Độ Tùy Chỉnh

Cần nhiều hơn 500 đơn hàng mỗi ngày? Các kế hoạch doanh nghiệp hỗ trợ thông lượng tùy chỉnh dựa trên yêu cầu của bạn.

Định Giá Theo Khối Lượng

Định giá bán sỉ theo bậc giảm dần khi khối lượng của bạn tăng. Liên hệ với chúng tôi để có báo giá tùy chỉnh cho trên 1.000 đơn hàng mỗi tháng.

Đảm Bảo SLA

SLA uptime 99,9% với tín dụng tài chính cho bất kỳ thời gian ngừng hoạt động nào. Tỷ lệ thành công cấp phát được đảm bảo ở mức 99,5% hoặc cao hơn.

Email Mang Thương Hiệu

Sắp ra mắt: gửi email giao mã QR từ tên miền của bạn với thương hiệu công ty của bạn.

Định Tuyến Ưu Tiên

Các đối tác API doanh nghiệp được ưu tiên truy cập hàng tồn kho của nhà cung cấp trong các giai đoạn nhu cầu cao.

FAQ

Câu Hỏi Thường Gặp

Bắt Đầu Xây Dựng Với TripoSIM API

Từ sandbox đến sản xuất trong vài giờ. 179+ điểm đến. 5 nhà cung cấp upstream. Một API đơn giản.

Được hỗ trợ bởi BroadNet Technologies — 22+ năm trong ngành viễn thông, hạ tầng cấp nhà mạng