获批且已由销售团队启用访问权限的合作伙伴可以使用API。在合作伙伴控制台创建只读或可下单密钥。所有购买均使用美元预付钱包。
API快速入门
账户获批后，销售团队会分配价格并启用API权限。请在合作伙伴控制台创建密钥。只读密钥不能下单，账户也必须启用购买权限。
https://simvoro.com/api/partner/v1每个请求都应使用服务器端Bearer密钥。不要将密钥放入浏览器代码或URL。可在合作伙伴控制台撤销密钥。
Authorization: Bearer YOUR_API_KEY| 方法 | 接口 | 结果 |
|---|---|---|
| GET | /products?destination=japan | 分配给您的美元价格及产品ID。按目的地slug筛选，使用cursor分页。 |
| GET | /balance | 钱包余额、预留资金和可用美元。 |
| GET | /transactions | 钱包交易记录和nextCursor。 |
| GET | /orders | 合作伙伴订单摘要及nextCursor（每页50条）。 |
| POST | /orders | 预留资金并订购一张eSIM。需要具有下单权限的密钥。 |
| GET | /orders/{orderId} | 订单状态、最近同步的数据用量，以及交付后的安装信息。 |
创建订单
将UUID放入Idempotency-Key发送。超时或连接失败后，请重用相同UUID。发送客户已确认的价格，并确认接收设备支持eSIM且已解锁运营商限制。实时价格变动会返回409 PRICE_CHANGED。这是正式API，已接受的购买会使用真实钱包资金。
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}201响应包含orderId和esim，请检查esim.status和esim.failure。每隔10秒查询订单。资金先被预留，在确认eSIM已交付后扣款。重放请求也可能返回已失败的订单。供应商结果不明确时，在核对原订单期间会继续预留资金。安装资料属于私密信息，仅在确认交付后显示。
金额为美元十进制字符串。列表返回items和nextCursor，请持续查询直到nextCursor为null。限制为每个密钥每分钟120个请求，每位用户每分钟10次购买尝试。收到429时请遵守Retry-After。常见错误：401密钥无效、403无权限、402余额不足、404订单不可访问、409价格或幂等冲突、503服务不可用。再次购买前请查询原订单。
申请中需要包含的内容
- 你的平台和客户群体
- 你预计的每月采购量
- 你希望提供的目的地
- 你的系统需要实现的功能，例如订购 eSIM 并向你的客户显示其二维码
成为合作伙伴
提交申请后，我们的团队会就此与你联系。