Tích hợp API

Bắt đầu với API

Sau khi tài khoản được duyệt, bộ phận kinh doanh gán giá và bật quyền API. Tạo khóa trong bảng điều khiển đối tác. Khóa chỉ đọc không được đặt hàng. Tài khoản cũng phải được bật quyền mua.

Gửi khóa bearer từ máy chủ trong mọi yêu cầu. Không đưa khóa vào mã trình duyệt hoặc URL. Có thể thu hồi khóa trong bảng điều khiển đối tác.

Tạo đơn hàng

Gửi UUID trong Idempotency-Key. Dùng lại đúng UUID đó sau khi hết thời gian chờ hoặc mất kết nối. Gửi mức giá khách đã xác nhận và xác nhận thiết bị nhận hỗ trợ eSIM, không khóa mạng. Khi giá thực tế thay đổi, API trả 409 PRICE_CHANGED. Đây là API thật; đơn được chấp nhận sử dụng tiền thật trong ví.

POST /api/partner/v1/orders
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Idempotency-Key: 83c77d9f-395f-4ff0-8ed6-c461bda46559

{"productId":"PRODUCT_ID_FROM_CATALOG","expectedPrice":"2.25","deviceConfirmed":true}

Phản hồi 201 chứa orderId và esim; hãy kiểm tra esim.status và esim.failure. Kiểm tra đơn mỗi 10 giây. Tiền được tạm giữ trước và chỉ trừ khi eSIM được giao và xác minh. Gửi lại yêu cầu có thể trả về một đơn đã thất bại. Khi kết quả từ nhà cung cấp chưa rõ, tiền vẫn được giữ trong lúc đối soát đơn gốc. Thông tin cài đặt là riêng tư và chỉ xuất hiện sau khi giao thành công.

Số tiền là chuỗi thập phân bằng USD. Danh sách trả items và nextCursor; tiếp tục đến khi nextCursor là null. Giới hạn: 120 yêu cầu mỗi khóa mỗi phút và 10 lần thử mua mỗi người dùng mỗi phút. Tuân theo Retry-After khi gặp 429. Lỗi thường gặp: 401 khóa không hợp lệ, 403 không có quyền, 402 thiếu tiền, 404 không truy cập được đơn, 409 xung đột giá hoặc yêu cầu trùng, 503 dịch vụ không khả dụng. Tra cứu đơn gốc trước khi thử mua lần khác.