eSim购买

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

测试接口：//www.bigesim.com/api/payTest

正式接口：//www.bigesim.com/api/pay

请求接口

POST GET

请求头部（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,
        "activationStatus": "activated",
        "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
memberCategoryId	number	发布者定价ID（可选，对应产品接口中memberCategoryList的id；不传时默认取该分类下最便宜的发布者）
notifyUrl	string	回调通知地址（可选，仅支持HTTP/HTTPS；eSim开通成功后系统会POST通知该地址，详见回调通知文档）

响应字段说明

字段	类型	说明
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 - 品牌 balance - token对应账号剩余余额 activationStatus - eSim开通状态(activated - 已开通，返回卡信息字段；activating - 开通中，不返回卡信息字段；下单时传了notifyUrl请等待开通成功后的回调通知，未传可稍后查询订单详情接口） lpa - eSim配置(用于生成二维码) number - eSim卡号码 qrcode - eSim配置二维码(base64格式) verifyCode - eSim配置验证码注意：部分eSim开通非实时，下单后可能不会立即完成开通。当activationStatus为activating（开通中）时，不返回卡信息字段（verifyCode、lpa、number、qrcode）。注意：回调通知的作用——下单时传入notifyUrl后，eSim开通成功系统会主动回调通知该地址，无需频繁轮询订单接口；activationStatus为activating（开通中）时请等待回调通知，详见回调通知文档；未传入notifyUrl时需稍后查询订单详情接口获取卡信息。 qrcode字段为图片base64格式，可作为图片地址引入 <img src="data:image/png;base64,iVBORw0...SuQmCC" alt="" width="240" height="240">