Tài liệu dành cho nhà phát triển

API doanh nghiệp & tích hợp

API phân phối eSIM dành cho nhà bán lại B2B, nền tảng du lịch và khách hàng doanh nghiệp

RESTful API TLS 1.3 API Key Auth Webhook Sandbox
Tài liệu dành cho nhà phát triển

Tổng quan API

API doanh nghiệp của CFJ-LINK được xây dựng trên kiến trúc RESTful, cho phép nhà bán lại B2B, nền tảng du lịch và khách hàng doanh nghiệp tích hợp trực tiếp năng lực phân phối eSIM toàn cầu vào sản phẩm của mình. Tất cả các điểm cuối (endpoint) của API đều truyền tải qua HTTPS (TLS 1.3) và xác thực bằng API Key.

Tài liệu API và môi trường sandbox hiện được cấp quyền truy cập theo hình thức đăng ký, nhằm bảo đảm độ ổn định của nền tảng và ngăn chặn hành vi lạm dụng. Sau khi hoàn tất xét duyệt kinh doanh, đối tác nhận được toàn bộ tài liệu kỹ thuật, thông tin xác thực thử nghiệm sandbox và hỗ trợ tích hợp riêng.

curl · sandbox request
# Sandbox · authenticated example
curl https://api.cfj-global.com/v1/plans \
  -H "Authorization: Bearer $CFJ_API_KEY" \
  -H "Accept: application/json"

# → 200 OK · application/json
{
  "object": "list",
  "data": [ /* plan objects */ ]
}
Capabilities

Tổng quan chức năng API

Sau khi được phê duyệt, đối tác truy cập toàn bộ bộ API RESTful. Chức năng bao gồm tra cứu gói và định giá thời gian thực, tạo đơn hàng eSIM và phát mã QR, theo dõi trạng thái kích hoạt hồ sơ, tra cứu dữ liệu sử dụng gần thời gian thực, đẩy sự kiện Webhook, cùng quản lý số dư và hóa đơn của tài khoản doanh nghiệp. Tài liệu chi tiết về các giao diện API, schema và SDK được cung cấp sau khi phê duyệt.

Tra cứu gói & định giá
Tra cứu thời gian thực các gói và mức giá khả dụng theo quốc gia/khu vực, dung lượng dữ liệu và thời hạn sử dụng.
Tạo đơn hàng & phát mã QR
Tạo đơn hàng eSIM và lấy mã QR kích hoạt — hoàn toàn tự động.
Giám sát sử dụng & cảnh báo
Tra cứu mức sử dụng gói gần thời gian thực, hỗ trợ cảnh báo theo ngưỡng và đẩy sự kiện Webhook.
Tài khoản & hóa đơn
Truy vấn số dư trả trước, chi tiết tiêu dùng và bảng đối soát hằng tháng, hỗ trợ tài khoản con nhiều cấp.
Onboarding

Quy trình xét duyệt tích hợp

Để bảo đảm chất lượng dịch vụ của nền tảng, quyền truy cập API phải trải qua quy trình xét duyệt sau:

1

Gửi hồ sơ đăng ký: Gửi giới thiệu công ty, tình huống kinh doanh và lượng truy vấn API ước tính trung bình mỗi tháng đến hộp thư kinh doanh của chúng tôi.

2

Ký thỏa thuận: Ký thỏa thuận bảo mật (NDA) và thỏa thuận cấp độ dịch vụ doanh nghiệp (SLA).

3

Mở sandbox: Sau khi được phê duyệt (thường 1-2 ngày làm việc), chúng tôi cấp thông tin xác thực thử nghiệm sandbox và toàn bộ tài liệu kỹ thuật.

4

Chính thức vận hành: Sau khi kiểm thử tích hợp trên sandbox thành công, API Key cho môi trường sản xuất sẽ được cấp.

Enterprise

Gói doanh nghiệp & định giá theo sản lượng

CFJ-LINK cung cấp các bậc định giá cho đối tác doanh nghiệp khi vượt ngưỡng tiêu dùng nhất định, đồng thời hỗ trợ các tính năng cấp doanh nghiệp sau:

Tùy chỉnh gói riêng: Tùy chỉnh tổ hợp điểm đến, thời hạn sử dụng và hạn mức dữ liệu.

Hỗ trợ white-label: Hồ sơ eSIM có thể được cấp mang thương hiệu riêng của doanh nghiệp bạn.

Thanh toán doanh nghiệp: Bảng kê hằng tháng, hóa đơn VAT, quản lý tài khoản con nhiều cấp.

Hỗ trợ kỹ thuật riêng: Kỹ sư tích hợp phụ trách và mức phản hồi SLA ưu tiên.

Security

Chương trình thưởng lỗ hổng

CFJ-LINK khuyến khích nhà nghiên cứu bảo mật công bố có trách nhiệm các lỗ hổng của nền tảng. Lỗ hổng hợp lệ đã được xác minh sẽ nhận mức thưởng tương ứng theo mức độ nghiêm trọng. Vui lòng đọc quy tắc công bố trước khi gửi báo cáo và không thực hiện kiểm thử phá hoại trên hệ thống sản xuất.

Phạm vi thưởng: các điểm cuối API, cơ chế xác thực, luồng thanh toán và rò rỉ dữ liệu.
Đăng ký truy cập API

Vui lòng gửi email kèm giới thiệu công ty, tình huống kinh doanh và nhu cầu tích hợp. Chúng tôi phản hồi trong vòng 1-2 ngày làm việc.

Hỗ trợ khách hàng

Bạn gặp trục trặc? Chúng tôi luôn sẵn sàng hỗ trợ.

Thường phản hồi trong vòng 24 giờ

Chọn ngôn ngữ
CFJ-LINKCFJ-LINK
Gói cước Dịch vụ Doanh nghiệp Trợ giúp Giới thiệu
Mở ứng dụng