Bán eSIM du lịch với Partner API của ChoEsim

Mua eSIM du lịch cho khách của bạn với giá sỉ và nhận thông tin kích hoạt (mã LPA) ngay trong phản hồi của API. Thanh toán từ ví USD trả trước, không trả thẻ từng đơn và không trao đổi dữ liệu cá nhân của khách cuối.

Đăng ký ngay Đọc hướng dẫn bắt đầu nhanh Điều khoản đối tác File OpenAPI

Tài liệu kỹ thuật được viết bằng tiếng Anh, vì đội kỹ thuật của đối tác thường dùng tiếng Anh. Trang này và điều khoản có bản tiếng Việt.

Bạn nhận được gì

• API REST dạng JSON (/partner/v1) kèm file OpenAPI 3.1 để nhập vào công cụ của bạn.
• Giá sỉ cho từng gói bạn được phép bán, trả về qua API. Bảng giá sỉ không công khai.
• Đơn hàng an toàn khi gọi lại: mỗi đơn cần Idempotency-Key và mã reference của bạn, nên lỗi quá thời gian chờ không tạo ra eSIM thứ hai.
• Giao hàng trong phản hồi: khi đơn hoàn tất, bạn nhận dữ liệu kích hoạt eSIM (ICCID và chuỗi LPA) để giao cho khách của bạn. ChoEsim không bao giờ gửi email cho khách của bạn.
• Hủy eSIM chưa dùng trong thời hạn hủy (mặc định 14 ngày), tiền được hoàn vào ví của bạn.
• Webhook có chữ ký (chuẩn Standard Webhooks) cho sự kiện đơn hàng và eSIM, tự động gửi lại khi lỗi, kèm endpoint để lấy các sự kiện bạn bỏ lỡ.
• Sandbox đầy đủ với khóa thử, ví thử riêng và các mã gói giả lập thành công, chậm, lỗi và đổi giá. Không có gì thật bị mua.

Quy trình

1. Đăng ký trực tuyến. Đăng ký ngay: đăng nhập bằng email đã xác minh, cho chúng tôi biết về doanh nghiệp của bạn và đánh dấu đồng ý điều khoản đối tác. Không cần ký giấy tờ và không phải chờ ai duyệt. Nếu muốn, bạn có thể gửi email tới support@choesim.com với tiêu đề "Partner API".
2. Nhận khóa. Tài khoản mở ngay, kèm ví thử và các hạn mức (đơn lớn nhất, chi tiêu mỗi ngày, số đơn đang mở). Đăng nhập vào cổng đối tác và tự tạo khóa thử.
3. Thử nghiệm. Xây dựng và kiểm thử trên sandbox, không cần tiền.
4. Nạp số dư. Thanh toán bằng thẻ ngay trên cổng đối tác qua OnePay và tự chọn số tiền; thẻ bị trừ bằng đồng Việt Nam theo tỷ giá hệ thống của ChoEsim, không cộng biên độ, và số dư được ghi có khi thanh toán được xác nhận. Lần nạp đầu tối thiểu 50 USD, các lần sau tối thiểu 25 USD.
5. Chạy thật. Sau khi lần nạp đầu được ghi có, bạn tạo khóa thật trong cổng đối tác. Đơn hàng được trừ từ ví.

Cần biết

• Phiên bản v1 bán các gói dung lượng cố định. Gói tính theo ngày chưa có qua API.
• Một cấp duy nhất: đối tác được bán trực tiếp cho khách cuối, nhưng không được bán lại eSIM cho đại lý khác.
• Vùng phủ, tốc độ và khả năng tương thích thiết bị phụ thuộc vào nhà mạng, ChoEsim và đối tác đều không bảo đảm. Câu chữ chính xác nằm trong điều khoản.
• Chúng tôi phản hồi qua email vào ngày làm việc, theo giờ Việt Nam (GMT+7). v1 không cam kết thời gian hoạt động; nhật ký thay đổi cho biết thay đổi gì và khi nào.

Nhà sáng tạo nội dung muốn nhận hoa hồng mà không cần lập trình: xem chương trình affiliate.