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">