eSIM Purchase

To facilitate development and debugging, we provide a test interface for balance payment debugging. Balances will not be actually deducted during testing. Please ensure you use the production interface for actual deployment.

Test Interface://www.bigesim.com/api/payTest

Production Interface://www.bigesim.com/api/pay

Request Interface

POST GET

Request Headers

Field Name	Field Value	Action
+ Add Field

Request Parameters (Params)

Field Name	Field Value	Action
+ Add Field

* Token can be used in either Request Headers or Request Parameters (Params)

Response Data

{
    "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="
    }
}

Request Field Descriptions

Field	Type	Description
token	string	Access token/signaling used for API authentication
categoryId	number	eSIM Type ID
memberCategoryId	number	Publisher Pricing ID (Optional, corresponds to the id in memberCategoryList of the product API; defaults to the cheapest publisher in this category if not provided)
notifyUrl	string	Callback URL (Optional, HTTP/HTTPS only; system will POST a notification upon successful eSIM activation, see documentation for details)

Response Field Descriptions

Field	Type	Description
status	boolean	【Request Status】 true - Success false - Request Failed
code	number	【Status Code】 20109 - Method Not Allowed 24001 - Type Does Not Exist 24002 - Token Has No Corresponding User 22003 - Insufficient eSIM Inventory 22004 - Order generation failed 24005 - Invalid parameter 21006 - Payment interface request error 21010 - Insufficient Balance 21000 - Order created successfully
msg	string	【Request Description】
data	object	【Request Data】 sn - Order No. currency - Currency Type categoryId - eSIM Type ID consumption - Balance Consumed for This Order carrier - Carrier brand - Brand balance - Remaining Balance of the Account Corresponding to Token activationStatus - eSIM Activation Status (activated: active, returns SIM info; activating: in progress, no SIM info returned. If notifyUrl is provided, await the callback upon completion; otherwise, query the order details later.) lpa - eSIM Configuration (used to generate QR code) number - eSIM Card Number qrcode - eSIM Configuration QR Code (base64 format) verifyCode - eSIM Configuration Authentication Code Note: eSIM activation may not be real-time. If status is "activating", SIM details (verifyCode, lpa, number, qrcode) will be omitted. Note: By providing a notifyUrl, the system will POST a notification upon successful activation, avoiding frequent polling. If status is "activating", please await the callback (see documentation). Without a notifyUrl, please query the order details API later to retrieve SIM info. The qrcode field is in base64 image format and can be used directly as an image source URL <img src="data:image/png;base64,iVBORw0...SuQmCC" alt="" width="240" height="240">