eSim购买
为方便开发调试,我们提供测试接口用于余额支付调试。测试接口调试余额不会被实际扣除,实际部署务必使用正式接口。

测试接口:https://www.maiesim.com/api/payTest

正式接口:https://www.maiesim.com/api/pay

请求接口
请求头部(Headers)
字段名 字段值 操作
+ 添加字段
请求参数(Params)
字段名 字段值 操作
+ 添加字段

* token用于请求头部(Headers)或请求参数(Params)皆可

响应数据
{ "status": true, "code": 20000, "msg": "订单生成成功", "data": { "sn": "231013169", "verifyCode": "123456", "currency": "USD", "categoryId": 31, "consumption": 5, "carrier": "中國移動CMHK", "brand": "CMLink", "lpa": "LPA:1$xxx.prod.xxxxxxxxxxx.com$TEST1234569868", "number": "86866878", "balance": 77, "qrcode": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAG8AAABvAQMAAADYCwwjAAAABlBMVEX///8AAABVwtN+AAAACXBIWXMAAA7EAAAOxAGVKw4bAAABHElEQVQ4jdXUsY3FIAwGYD9R0CULIGUNOq+ULJCQBZKV6LKGJRbIdRQIn/Pe6d41F9M+lOYrQMb+CcAnrp45eAA0zKSyA7NGN8UUoIGYNjvsMe25iWtMJ5pm0txIMAHT158ibyj33XyS7/f6N7y2W2nOu5k37DNXKFN89lMlw3KUR0wVdIJNAQnQzZ5U9pGWXEaEhUElgPTcLZH6JrqJDQtjC5nzENBU1NnnMvFwWje+ZnRLyWrwNGXqWghuxmum+6Gzs+aU0EpzMqh8XAkpMv0ZdXZe3pc5PVer8xUAsNJJUvlMrJvtzyu7p7wFqX/01PkG4rVLTqjQxGDL6M1+QAs3K9mmx/tH8T+lKuCKElqdUs9+mJWHDXR+3voG0+/cX8m0/MsAAAAASUVORK5CYII=" } }
请求字段说明
字段 类型 说明
token string

访问信令,用于请求接口的身份验证

categoryId number

eSim类型ID

响应字段说明
字段 类型 说明
status boolean

【请求状态】

true - 请求成功

false - 请求失败

code number

【状态码】

20109 - 请求方式不允许

24001 - 类型不存在

24002 - token无对应用户

22003 - eSim库存不足

22004 - 订单生成失败

24005 - 参数错误

21006 - 支付接口请求错误

21010 - 余额不足

21000 - 订单生成成功

msg string

【请求说明】

data object

【请求数据】

sn - 订单号

currency - 货币类型

categoryId - eSim类型ID

consumption - 本次订单消耗余额

carrier - 运营商

brand - 品牌

lpa - eSim配置(用于生成二维码)

number - eSim卡号码

balance - token对应账号剩余余额

qrcode - eSim配置二维码(base64格式)

verifyCode - eSim配置验证码


qrcode字段为图片base64格式,可作为图片地址引入

<img src="data:image/png;base64,iVBORw0...SuQmCC" alt="" width="240" height="240">