This document is provided by Microdrive Tech Co., Ltd and is only used for the technical connection of the partner.
\nPlease setup request header : Content-Type:application/json
\nThe interface uses UTF-8 encoding
\nSystem time zone: UTC/GMT+08:00
\nEnvironment URLs:
\nTest Environment :https://test.microesim.com
Production Environment : https://www.microesim.top
MICROESIM-ACCOUNT：Provided by Microesim
\nMICROESIM-NONCE：Radom strings ,length 6-32 digits
\nMICROESIM-TIMESTAMP：Timestamp (seconds), 13 digits long
\nMICROESIM-SIGN：A signature generated using HMAC-SHA256 with the hashed password derived from the original secret and salt. Signature Content：MICROESIM-ACCOUNT, MICROESIM-NONCE, and MICROESIM-TIMESTAMP.
Generate a random nonce string of 6-32 characters.
\nGet the current timestamp in milliseconds.
\nUse the provided secret key and salt to generate a hashed password using the PBKDF2 algorithm with SHA256.
\nConcatenate MICROESIM-ACCOUNT, MICROESIM-NONCE, and MICROESIM-TIMESTAMP to form a string to be signed.
Use the hashed password to generate the MICROESIM-SIGN signature using HMAC-SHA256.
Include the generated MICROESIM-ACCOUNT, MICROESIM-NONCE, MICROESIM-TIMESTAMP, and MICROESIM-SIGN in the request headers.
import crypto from \"crypto\";\nimport fetch from \"node-fetch\";\nfunction toHex(buffer) {\n return buffer.toString(\"hex\");\n}\nfunction pbkdf2ToHex(secret, saltHex, iterations, keyLen) {\n const salt = Buffer.from(saltHex, \"hex\");\n const derivedKey = crypto.pbkdf2Sync(secret, salt, iterations, keyLen, \"sha256\");\n return toHex(derivedKey);\n}\nfunction hmacWithHexKey(data, hexKey) {\n return crypto\n .createHmac(\"sha256\", Buffer.from(hexKey, \"utf-8\"))\n .update(data)\n .digest(\"hex\");\n}\nasync function sendRequest() {\n const account = \"your_account_here\";\n const secret = \"your_secret_here\";\n const saltHex = \"your_salt_hex_here\";\n const nonce = Math.random().toString(36).substring(2, 18);\n const timestamp = Date.now().toString();\n const hexKey = pbkdf2ToHex(secret, saltHex, 1024, 32);\n const data = account + nonce + timestamp;\n const signature = hmacWithHexKey(data, hexKey);\n const url = \"https://microesim.cn/allesim/v1/esimDataplanList\";\n const headers = {\n \"Content-Type\": \"application/json\",\n \"MICROESIM-ACCOUNT\": account,\n \"MICROESIM-NONCE\": nonce,\n \"MICROESIM-TIMESTAMP\": timestamp,\n \"MICROESIM-SIGN\": signature,\n };\n try {\n const response = await fetch(url, { method: \"GET\", headers });\n const result = await response.json();\n console.log(\"Response status:\", response.status);\n console.log(\"Response data:\", result);\n } catch (error) {\n console.error(\"Request failed:\", error);\n }\n}\nsendRequest();\n\nimport requests\nimport secrets\nimport time\nimport hmac\nimport hashlib\nimport binascii\nACCOUNT = \"your_account_here\"\nSECRET = \"your_secret_here\"\nSALT_HEX = \"your_salt_hex_here\"\nSALT = binascii.unhexlify(SALT_HEX)\nITERATIONS = 1024\nKEY_LENGTH = 32 \nnonce = secrets.token_hex(10)\ntimestamp = str(int(time.time() * 1000))\nhash_password = hashlib.pbkdf2_hmac(\n 'sha256',\n SECRET.encode('utf-8'),\n SALT,\n ITERATIONS,\n dklen=KEY_LENGTH\n)\ndata_to_sign = ACCOUNT + nonce + timestamp\nhash_password_hex = hash_password.hex()\nsignature = hmac.new(\n hash_password_hex.encode('utf-8'),\n data_to_sign.encode('utf-8'),\n hashlib.sha256\n).hexdigest()\nheaders = {\n \"Content-Type\": \"application/json\",\n \"MICROESIM-ACCOUNT\": ACCOUNT,\n \"MICROESIM-NONCE\": nonce,\n \"MICROESIM-TIMESTAMP\": timestamp,\n \"MICROESIM-SIGN\": signature\n}\nurl = \"https://microesim.cn/allesim/v1/esimDataplanList\"\nresponse = requests.get(url, headers=headers, timeout=10)\nprint(\"Signature:\", signature)\nprint(\"Response status:\", response.status_code)\nprint(\"Response text:\", response.text)\n\nimport javax.crypto.Mac;\nimport javax.crypto.SecretKeyFactory;\nimport javax.crypto.spec.PBEKeySpec;\nimport javax.crypto.spec.SecretKeySpec;\nimport java.io.BufferedReader;\nimport java.io.InputStreamReader;\nimport java.net.HttpURLConnection;\nimport java.net.URL;\nimport java.nio.charset.StandardCharsets;\nimport java.security.spec.KeySpec;\nimport java.util.Random;\npublic class MicroEsimApiClient {\n public static String pbkdf2Hex(String secret, byte[] salt, int iterations, int keyLength) throws Exception {\n KeySpec spec = new PBEKeySpec(secret.toCharArray(), salt, iterations, keyLength * 8);\n SecretKeyFactory factory = SecretKeyFactory.getInstance(\"PBKDF2WithHmacSHA256\");\n byte[] key = factory.generateSecret(spec).getEncoded();\n return bytesToHex(key);\n }\n public static String hmacSha256Hex(String data, String hexKey) throws Exception {\n byte[] keyBytes = hexKey.getBytes(StandardCharsets.UTF_8);\n SecretKeySpec secretKey = new SecretKeySpec(keyBytes, \"HmacSHA256\");\n Mac mac = Mac.getInstance(\"HmacSHA256\");\n mac.init(secretKey);\n byte[] hmac = mac.doFinal(data.getBytes(StandardCharsets.UTF_8));\n return bytesToHex(hmac);\n }\n public static String bytesToHex(byte[] bytes) {\n StringBuilder sb = new StringBuilder();\n for (byte b : bytes) {\n sb.append(String.format(\"\u0002x\", b)); \n }\n return sb.toString();\n }\n public static String generateNonce(int length) {\n String chars = \"abcdefghijklmnopqrstuvwxyz0123456789\";\n StringBuilder nonce = new StringBuilder();\n Random random = new Random();\n for (int i = 0; i < length; i++) {\n nonce.append(chars.charAt(random.nextInt(chars.length())));\n }\n return nonce.toString();\n }\n private static byte[] hexStringToByteArray(String s) {\n int len = s.length();\n byte[] data = new byte[len / 2];\n for (int i = 0; i < len; i += 2) {\n data[i / 2] = (byte) ((Character.digit(s.charAt(i), 16) << 4)\n + Character.digit(s.charAt(i + 1), 16));\n }\n return data;\n }\n public static void main(String[] args) throws Exception {\n // 请替换成你自己的参数👇\n String account = \"your_account_here\";\n String secret = \"your_secret_here\";\n String saltHex = \"your_salt_hex_here\";\n byte[] salt = hexStringToByteArray(saltHex);\n int iterations = 1024;\n int keyLength = 32;\n String nonce = generateNonce(16);\n String timestamp = String.valueOf(System.currentTimeMillis());\n String hexKey = pbkdf2Hex(secret, salt, iterations, keyLength);\n String dataToSign = account + nonce + timestamp;\n String signature = hmacSha256Hex(dataToSign, hexKey);\n String urlStr = \"https://microesim.cn/allesim/v1/esimDataplanList\";\n URL url = new URL(urlStr);\n HttpURLConnection conn = (HttpURLConnection) url.openConnection();\n conn.setRequestMethod(\"GET\");\n conn.setRequestProperty(\"Content-Type\", \"application/json\");\n conn.setRequestProperty(\"MICROESIM-ACCOUNT\", account);\n conn.setRequestProperty(\"MICROESIM-NONCE\", nonce);\n conn.setRequestProperty(\"MICROESIM-TIMESTAMP\", timestamp);\n conn.setRequestProperty(\"MICROESIM-SIGN\", signature);\n int responseCode = conn.getResponseCode();\n System.out.println(\"Response Code: \" + responseCode);\n BufferedReader in = new BufferedReader(new InputStreamReader(conn.getInputStream(), StandardCharsets.UTF_8));\n String inputLine;\n StringBuilder response = new StringBuilder();\n while ((inputLine = in.readLine()) != null) {\n response.append(inputLine);\n }\n in.close();\n System.out.println(\"Response Body: \" + response.toString());\n }\n}\n\n$account = \"your_account_here\";\n$secret = \"your_secret_here\";\n$saltHex = \"your_salt_hex_here\";\n$nonce = bin2hex(random_bytes(8));\n$timestamp = (string)round(microtime(true) * 1000);\n$key_bin = hash_pbkdf2(\"sha256\", $secret, hex2bin($saltHex), 1024, 32, true);\n$key_hex = bin2hex($key_bin);\n$dataToSign = $account . $nonce . $timestamp;\n$signature = hash_hmac(\"sha256\", $dataToSign, $key_hex);\n$url = \"https://microesim.cn/allesim/v1/esimDataplanList\";\n$headers = [\n \"Content-Type: application/json\",\n \"MICROESIM-ACCOUNT: $account\",\n \"MICROESIM-NONCE: $nonce\",\n \"MICROESIM-TIMESTAMP: $timestamp\",\n \"MICROESIM-SIGN: $signature\"\n];\n$ch = curl_init();\ncurl_setopt($ch, CURLOPT_URL, $url);\ncurl_setopt($ch, CURLOPT_HTTPHEADER, $headers);\ncurl_setopt($ch, CURLOPT_RETURNTRANSFER, true);\n$response = curl_exec($ch);\nif (curl_errno($ch)) {\n echo \"Curl error: \" . curl_error($ch);\n} else {\n echo \"Response:\\n$response\\n\";\n}\ncurl_close($ch);\n\n// Postman Request Script\nconst CryptoJS = require('crypto-js');\nconst account = 'account';\nconst nonce = CryptoJS.lib.WordArray.random(10).toString(CryptoJS.enc.Hex);\nconst timestamp = new Date().getTime().toString();\nconst secret = 'secret';\nconst salt = CryptoJS.enc.Hex.parse('salt');\nconst iterations = 1024;\nconst keyLength = 256 / 32; \nlet hashPassword = CryptoJS.PBKDF2(secret, salt, {keySize: keyLength,iterations: iterations,hasher: CryptoJS.algo.SHA256}).toString(CryptoJS.enc.Hex);\nconst dataToHash = account + nonce + timestamp;\nconst signature = CryptoJS.HmacSHA256(dataToHash,hashPassword).toString(CryptoJS.enc.Hex);\nconsole.log(\"Generated Signature (Client): \" + signature); \npm.environment.set(\"MICROESIM-ACCOUNT\", account);\npm.environment.set(\"MICROESIM-SIGN\", signature);\npm.environment.set(\"MICROESIM-TIMESTAMP\", timestamp);\npm.environment.set(\"MICROESIM-NONCE\", nonce); \n\neSIM Data Plan List interface（/allesim/v1/esimDataplanList）
\neSIM New Order interface（/allesim/v1/esimSubscribe）
\nEnquiry Topup Details interface （/allesim/v1/topupDetail）
\nEnquiry Data Plan Details interface （/allesim/v1/deviceDetail）
\nEnquiry Event Detail interface （/allesim/v1/eventDetail）
\nTerminate interface （/allesim/v1/terminate）
\nGET /allesim/v1/esimDataplanList
or GET /allesim/v1/esimDataplanListPage (Recommended for large data)
POST /allesim/v1/esimSubscribe
Use channel_dataplan_id from Step 1
Response returns topup_id
POST /allesim/v1/topupDetail
Query order status by topup_id
Client actively polls the order detail
\nPOST /allesim/v1/topupDetail-async
Client provides a callback URL in the request
\nServer will push order details to the provided callback URL once the order status is updated
\nIn async mode, the client does not need to poll the order status; order details will be delivered via server callback.
\nany string
\n","type":"text"}],"url":"{{url}}/allesim/v1/esimDataplanList","description":"eSIM Data Plan List - All interface
\n","urlObject":{"path":["allesim","v1","esimDataplanList"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"f759ba70-bafa-41be-a06a-a29f5e66b2fe","name":"/allesim/v1/esimDataplanList","originalRequest":{"method":"GET","header":[{"key":"MICROESIM-ACCOUNT","value":"113490b1281917ab9d47657cedb6ce","type":"text"},{"key":"MICROESIM-NONCE","value":"","type":"text"},{"key":"MICROESIM-TIMESTAMP","value":"","type":"text"},{"key":"MICROESIM-SIGN","value":"any string","type":"text"}],"url":"{{url}}/allesim/v1/esimDataplanList"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.16.1"},{"key":"Date","value":"Thu, 03 Mar 2022 02:47:29 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"X-Powered-By","value":"PHP/7.4.3"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 1,\n \"msg\": \"Success\",\n \"result\": [\n {\n \"channel_dataplan_id\": \"b1a926e1-d770-4e03-804e-c527b9397eb9\",\n \"channel_dataplan_name\": \"Global 66-Total1GB-7-A0-test\",\n \"price\": \"524.00\",\n \"currency\": \"HKD\",\n \"status\": \"1\",\n \"day\": 30,\n \"data\": \"unlimited\",\n \"apn\": \"vmobile.jp\",\n \"active_type\":\"ACTIVEDBYDEVICE\",\n \"code\": \"JP\",\n \"networks\": \"JP:Docomo(IIJ)[4G;LTE]|\",\n \"ip\": \"PL\",\n \"rule_desc\": \"unlimited 512kbps\",\n \"validity_period\": \"60\",\n \"special_desc\": \"\"\n },\n {\n \"channel_dataplan_id\": \"202408136e79772A718449EEE9290CAC3\",\n \"channel_dataplan_name\": \"JapanIIJ-unlimited-15-test\",\n \"price\": \"279.62\",\n \"currency\": \"HKD\",\n \"status\": \"1\",\n \"day\": 15,\n \"data\": \"unlimited\",\n \"apn\": \"vmobile.jp\",\n \"active_type\":\"ACTIVEDBYDEVICE\",\n \"code\": \"JP\",\n \"networks\": \"JP:Docomo(IIJ)[4G;LTE]|\",\n \"ip\": \"PL\",\n \"rule_desc\": \"unlimited 512kbps\",\n \"validity_period\": \"60\",\n \"special_desc\": \"\"\n \n },\n {\n \"channel_dataplan_id\": \"2024081342489905C36Eee9eA513390E9\",\n \"channel_dataplan_name\": \"JapanIIJ-unlimited-10-test\",\n \"price\": \"209.00\",\n \"currency\": \"HKD\",\n \"status\": \"1\",\n \"day\": 10,\n \"data\": \"unlimited\",\n \"apn\": \"vmobile.jp\",\n \"active_type\":\"ACTIVEDBYDEVICE\",\n \"code\": \"JP\",\n \"networks\": \"JP:Docomo(IIJ)[4G;LTE]|\",\n \"ip\": \"HK\",\n \"rule_desc\": \"unlimited 128kb\",\n \"validity_period\": \"60\",\n \"special_desc\": \"\"\n },\n {\n \"channel_dataplan_id\": \"20240813E215A8C7D92367249770119e6\",\n \"channel_dataplan_name\": \"JapanIIJ-unlimited-5-test\",\n \"price\": \"112.88\",\n \"currency\": \"HKD\",\n \"status\": \"1\",\n \"day\": 5,\n \"data\": \"unlimited\",\n \"apn\": \"vmobile.jp\",\n \"active_type\":\"ACTIVEDBYDEVICE\",\n \"code\": \"JP\",\n \"networks\": \"JP:Docomo(IIJ)[4G;LTE]|\",\n \"ip\": \"HK\",\n \"rule_desc\": \"terminate\",\n \"validity_period\": \"60\",\n \"special_desc\": \"\"\n },\n {\n \"channel_dataplan_id\": \"2024081362C6C4EA4220B2D5224e2ee1E\",\n \"channel_dataplan_name\": \"JapanIIJ-unlimited-3-test\",\n \"price\": \"71.62\",\n \"currency\": \"HKD\",\n \"status\": \"1\",\n \"day\": 3,\n \"data\": \"unlimited\",\n \"apn\": \"vmobile.jp\",\n \"active_type\":\"ACTIVEDBYDEVICE\",\n \"code\": \"JP\",\n \"networks\": \"JP:Docomo(IIJ)[4G;LTE]|\",\n \"ip\": \"HK\",\n \"rule_desc\": \"unlimited\",\n \"validity_period\": \"60\",\n \"special_desc\": \"\"\n }\n ]\n}"}],"_postman_id":"27a2a67a-9d34-443c-84ce-383fd2bcc663"},{"name":"/allesim/v1/esimDataplanListPage","event":[{"listen":"test","script":{"id":"da189527-737f-4a04-845e-10116c9223ff","exec":[""],"type":"text/javascript","packages":{},"requests":{}}},{"listen":"prerequest","script":{"id":"a5867f7b-2306-4d3f-866b-02c86a35fd1f","exec":["\r",""],"type":"text/javascript","packages":{},"requests":{}}}],"id":"998947b1-c8ee-48a4-9e6c-a4e79c988d23","protocolProfileBehavior":{"disabledSystemHeaders":{},"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"MICROESIM-ACCOUNT","value":"{{MICROESIM-ACCOUNT}}","type":"text"},{"key":"MICROESIM-NONCE","value":"{{MICROESIM-NONCE}}","type":"text"},{"key":"MICROESIM-TIMESTAMP","value":"{{MICROESIM-TIMESTAMP}}","type":"text"},{"key":"MICROESIM-SIGN","value":"{{MICROESIM-SIGN}}","description":"any string
\n","type":"text"}],"url":"{{url}}/allesim/v1/esimDataplanListPage?pageNo=1&pageSize=500","description":"⚠️ For accounts with a large number of data plans (> 10,000), requesting all data in a single call may cause network timeouts or oversized responses.
If any request issues occur, please use the paginated interface: eSIM Data Plan List By Page.
Maximum value: 500
\n","type":"text/plain"},"key":"pageSize","value":"500"}],"variable":[]}},"response":[{"id":"f418e5a2-d586-4dae-a7d6-d33bf5512483","name":"/allesim/v1/esimDataplanListPage","originalRequest":{"method":"GET","header":[{"key":"MICROESIM-ACCOUNT","value":"","type":"text"},{"key":"MICROESIM-NONCE","value":"","type":"text"},{"key":"MICROESIM-TIMESTAMP","value":"","type":"text"},{"key":"MICROESIM-SIGN","value":"any string","type":"text"}],"url":"{{url}}/allesim/v1/esimDataplanListPage"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.16.1"},{"key":"Date","value":"Thu, 03 Mar 2022 02:47:29 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"X-Powered-By","value":"PHP/7.4.3"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 1,\n \"msg\": \"Success\",\n \"result\": {\n \"pageNo\": 1,\n \"pageSize\": 500,\n \"total\": 5,\n \"totalPages\": 1,\n \"list\": [\n {\n \"channel_dataplan_id\": \"b1a926e1-d770-4e03-804e-c527b9397eb9\",\n \"channel_dataplan_name\": \"Global 66-Total1GB-7-A0-test\",\n \"price\": \"524.00\",\n \"currency\": \"HKD\",\n \"status\": \"1\",\n \"day\": 30,\n \"data\": \"unlimited\",\n \"apn\": \"vmobile.jp\",\n \"active_type\":\"ACTIVEDBYDEVICE\",\n \"code\": \"JP\",\n \"networks\": \"JP:Docomo(IIJ)[4G;LTE]|\",\n \"ip\": \"PL\",\n \"rule_desc\": \"unlimited 512kbps\",\n \"validity_period\": \"60\",\n \"special_desc\": \"\"\n },\n {\n \"channel_dataplan_id\": \"202408136e79772A718449EEE9290CAC3\",\n \"channel_dataplan_name\": \"JapanIIJ-unlimited-15-test\",\n \"price\": \"279.62\",\n \"currency\": \"HKD\",\n \"status\": \"1\",\n \"day\": 15,\n \"data\": \"unlimited\",\n \"apn\": \"vmobile.jp\",\n \"active_type\":\"ACTIVEDBYDEVICE\",\n \"code\": \"JP\",\n \"networks\": \"JP:Docomo(IIJ)[4G;LTE]|\",\n \"ip\": \"PL\",\n \"rule_desc\": \"unlimited 512kbps\",\n \"validity_period\": \"60\",\n \"special_desc\": \"ekyc required esim\"\n \n },\n {\n \"channel_dataplan_id\": \"2024081342489905C36Eee9eA513390E9\",\n \"channel_dataplan_name\": \"JapanIIJ-unlimited-10-test\",\n \"price\": \"209.00\",\n \"currency\": \"HKD\",\n \"status\": \"1\",\n \"day\": 10,\n \"data\": \"unlimited\",\n \"apn\": \"vmobile.jp\",\n \"active_type\":\"ACTIVEDBYDEVICE\",\n \"code\": \"JP\",\n \"networks\": \"JP:Docomo(IIJ)[4G;LTE]|\",\n \"ip\": \"HK\",\n \"rule_desc\": \"unlimited 128kb\",\n \"validity_period\": \"60\",\n \"special_desc\": \"ekyc required esim\"\n },\n {\n \"channel_dataplan_id\": \"20240813E215A8C7D92367249770119e6\",\n \"channel_dataplan_name\": \"JapanIIJ-unlimited-5-test\",\n \"price\": \"112.88\",\n \"currency\": \"HKD\",\n \"status\": \"1\",\n \"day\": 5,\n \"data\": \"unlimited\",\n \"apn\": \"vmobile.jp\",\n \"active_type\":\"ACTIVEDBYDEVICE\",\n \"code\": \"JP\",\n \"networks\": \"JP:Docomo(IIJ)[4G;LTE]|\",\n \"ip\": \"HK\",\n \"rule_desc\": \"terminate\",\n \"validity_period\": \"60\",\n \"special_desc\": \"ekyc required esim\"\n },\n {\n \"channel_dataplan_id\": \"2024081362C6C4EA4220B2D5224e2ee1E\",\n \"channel_dataplan_name\": \"JapanIIJ-unlimited-3-test\",\n \"price\": \"71.62\",\n \"currency\": \"HKD\",\n \"status\": \"1\",\n \"day\": 3,\n \"data\": \"unlimited\",\n \"apn\": \"vmobile.jp\",\n \"active_type\":\"ACTIVEDBYDEVICE\",\n \"code\": \"JP\",\n \"networks\": \"JP:Docomo(IIJ)[4G;LTE]|\",\n \"ip\": \"HK\",\n \"rule_desc\": \"unlimited\",\n \"validity_period\": \"60\",\n \"special_desc\": \"ekyc required esim\"\n }\n ]\n }\n}"}],"_postman_id":"998947b1-c8ee-48a4-9e6c-a4e79c988d23"},{"name":"/allesim/v1/esimSubscribe","event":[{"listen":"prerequest","script":{"id":"9ea9ec76-5fb1-43e9-89f6-8af2759e395e","exec":[""],"type":"text/javascript","packages":{},"requests":{}}}],"id":"8b99ff5a-f21f-410c-bb59-0a8bc6f3ab0f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"MICROESIM-ACCOUNT","value":"{{MICROESIM-ACCOUNT}}","type":"text"},{"key":"MICROESIM-NONCE","value":"{{MICROESIM-NONCE}}","type":"text"},{"key":"MICROESIM-TIMESTAMP","value":"{{MICROESIM-TIMESTAMP}}","type":"text"},{"key":"MICROESIM-SIGN","value":"{{MICROESIM-SIGN}}","description":"any string
\n","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"number","value":"1","description":"Quantity(Recommended：1，Value> 1 may trigger delays.Mandatory)
\n","type":"text"},{"key":"channel_dataplan_id","value":"b1a926e1-d770-4e03-804e-c527b9397eb9","description":"channel_dataplan_id(Mandatory)
\n","type":"text"},{"key":"activation_date","value":"","description":"yyyy-MM-dd HH:mm:ss(UTC+0)(Optional, within 30 days）
\n","type":"text","uuid":"746d84d0-f45d-4a3a-b5a1-4fc2171b0b86"},{"key":"custom_order_no","value":"","description":"Custom order number(Optional)
\n","type":"text"},{"key":"custom_email","value":"","description":"Send an email after complete the eSIM(Optional)
\n","type":"text","uuid":"e10db555-e024-4596-9e06-c9ad133f26b6"},{"key":"remark","value":"","description":"remarks(Optional)
\n","type":"text","uuid":"47d91ca5-5a5f-4f49-96b8-cc1728622e2d"}]},"url":"{{url}}/allesim/v1/esimSubscribe","description":"eSIM New Order interface
\n/esimDataplanList API returns an active_type of \"ACTIVEDBYORDER\", which requires an activation_date. If no date is provided, the eSIM will be activated immediately.
Topup ID (Order No)
\n","type":"text"}]},"url":"{{url}}/allesim/v1/topupDetail","description":"Enquiry Topup details interface(Notes)
\nIf /esimDataplanList returns a channel_dataplan_name that includes \"Local\", speed data may be delayed by 1–2 minutes.
Please delay your /topupDetail call accordingly.
Use polling or event notifications to ensure accurate data readiness.
\nTo retrieve topup esim information, you may choose either /topupDetail or /topupDetail-asyn — do not use both.
Topup ID (Order No)
\n","type":"text"},{"key":"number","value":"","description":"default 1
\n","type":"text","uuid":"2762bd1d-f53c-47de-ad19-3eb4ea2a9901"},{"key":"device_id","value":"","description":"ICCID
\n","type":"text","uuid":"9fe90f90-d382-46f4-b872-cc1608d84168"},{"key":"lpa_str","value":"","type":"text","uuid":"0dfa77bb-9197-4289-8249-ab4340c77c2f"},{"key":"qrcode","value":"","type":"text","uuid":"0dc391f6-8b17-4362-846e-553fb893bd66"},{"key":"ios_esim_install_link","value":"","type":"text","uuid":"b99afe73-8245-4964-99af-6d29375512d4"}]},"url":"{{NOTIFY_URL}}","description":"To receive event notifications from /topupDetail-async, a callback URL must be provided.
Each order is pushed individually (one order per request) when its status changes to \"Success\".
\nFailed pushes are retried using exponential backoff (e.g., 5s → 10s), up to 2 attempts.
\nEvery hour, the system scans orders not successfully pushed in the last hour and retries automatically.
\n","urlObject":{"host":["{{NOTIFY_URL}}"],"query":[],"variable":[]}},"response":[{"id":"0b762a23-98d9-4809-b7ba-2dc4ed27146f","name":"/allesim/v1/topupDetail","originalRequest":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[]},"url":"{{NOTIFY_URL}}"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.16.1"},{"key":"Date","value":"Thu, 03 Mar 2022 03:47:37 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"X-Powered-By","value":"PHP/7.4.3"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 1,\n \"msg\": \"Success\",\n \"data\": {\n \"topup_id\": \"202308161431187762753800\",\n \"number\": \"1\",\n \"create_time\": \"2023-04-27 15:39:47\",\n \"device_id\": \"9000024081603874\",\n \"lpa_str\": \"LPA:1$rsp-eu.simlessly.com$580FFE02FFEE57965B6EECA132DA088D\",\n \"qrcode\": \"https://microesim.top/files/9999-9000024081603874\",\n \"ios_esim_install_link\": \"https://esimsetup.apple.com/esim_qrcode_provisioning?carddata=LPA:1$rsp-eu.simlessly.com$580FFE02FFEE57965B6EECA132DA088D\",\n \"android_esim_install_link\": \"https://esimsetup.android.com/esim_qrcode_provisioning?carddata=LPA:1$rsp-eu.simlessly.com$580FFE02FFEE57965B6EECA132DA028D\",\n \"msisdn\":\"482222233223\",\n \"cf_code\": \"000888\"\n }\n}\n"}],"_postman_id":"f3ded04a-d706-449d-a469-cec6a6a0a9f8"},{"name":"/allesim/v1/deviceDetail","event":[{"listen":"prerequest","script":{"exec":[""],"type":"text/javascript","packages":{},"id":"d05d1e01-2f56-4252-b609-11f9399114ba"}},{"listen":"test","script":{"exec":[""],"type":"text/javascript","packages":{},"id":"f88913d8-119a-468f-a58e-ec32a7bad81c"}}],"id":"6e17cc64-93eb-4bd5-9c6e-78607bf84338","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"MICROESIM-ACCOUNT","value":"{{MICROESIM-ACCOUNT}}","type":"text"},{"key":"MICROESIM-NONCE","value":"{{MICROESIM-NONCE}}","type":"text"},{"key":"MICROESIM-TIMESTAMP","value":"{{MICROESIM-TIMESTAMP}}","type":"text"},{"key":"MICROESIM-SIGN","value":"{{MICROESIM-SIGN}}","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"topup_id","value":"202308161431187762753800","description":"Topup ID (Order No)
\n","type":"text"},{"key":"device_id","value":"9000024081684603","description":"Device ID (ICCID No)
\n","type":"text"}]},"url":"{{url}}/allesim/v1/deviceDetail","description":"Enquiry Data Plan Details interface.
\n","urlObject":{"path":["allesim","v1","deviceDetail"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"68fd48ac-b33f-471a-b5dc-0e0ec7038757","name":"/allesim/v1/deviceDetail","originalRequest":{"method":"POST","header":[{"key":"MICROESIM-ACCOUNT","value":"113490b1281917ab9d47657cedb6ce","type":"text"},{"key":"MICROEISM-NONCE","value":"","type":"text"},{"key":"MICROESIM-TIMESTAMP","value":"","type":"text"},{"key":"MICROESIM-SIGN","value":"any string","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"topup_id","value":"202308161431187762753800","description":"Device ID (ICCID No)","type":"text"},{"key":"device_id","value":"9000024081684603","description":"Topup ID (Order No)","type":"text"}]},"url":"{{url}}/allesim/v1/deviceDetail"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.16.1"},{"key":"Date","value":"Thu, 24 Feb 2022 09:50:32 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"X-Powered-By","value":"PHP/7.2.9"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 1,\n \"msg\": \"Success\",\n \"result\": {\n \"topup_id\": \"202308161431187762753800\",\n \"device_id\": \"9000024081684603\",\n \"type\": \"esim\",\n \"channel_dataplan_id\": \"b1a926e1-d770-4e03-804e-c527b9397eb9\",\n \"channel_dataplan_name\": \"Global 66-Total1GB-7-A0\",\n \"status\": \"success\",\n \"active_time\": \"2023-07-05 12:50:46\",\n \"pause_time\": \"\",\n \"expire_time\": \"2023-07-08 12:50:45\",\n \"terminate_time\": \"\",\n \"create_time\": \"2023-07-05 04:06:20\",\n \"data_usage\": \"17135.6\",\n \"data_usage_daily\": [\n {\n \"date\": \"2023-07-07\",\n \"total_usage\": \"4904.10\",\n \"mcc\": \"286\",\n \"mnc\": \"02\",\n \"total_usage_kb\": \"5021805.120\"\n },\n {\n \"date\": \"2023-07-06\",\n \"total_usage\": \"7990.47\",\n \"mcc\": \"286\",\n \"mnc\": \"02\",\n \"total_usage_kb\": \"8182245.451\"\n },\n {\n \"date\": \"2023-07-05\",\n \"total_usage\": \"4241.01\",\n \"mcc\": \"286\",\n \"mnc\": \"02\",\n \"total_usage_kb\": \"4342800.965\"\n }\n ],\n \"is_daily\": \"true\",\n \"daily_reset_time\": \"2023-07-07 23:59:59\"\n }\n}"}],"_postman_id":"6e17cc64-93eb-4bd5-9c6e-78607bf84338"},{"name":"/allesim/v1/eventDetail","event":[{"listen":"prerequest","script":{"exec":[""],"type":"text/javascript","packages":{},"id":"d9b1d4e2-ac45-4911-97d4-0bcf81f36959"}},{"listen":"test","script":{"exec":[""],"type":"text/javascript","packages":{},"id":"1b2b1cf5-af16-4114-a00d-0b32df894135"}}],"id":"63e2fa41-b86c-45ce-96b8-6f99ddbf7b81","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"MICROESIM-ACCOUNT","value":"{{MICROESIM-ACCOUNT}}","type":"text"},{"key":"MICROESIM-NONCE","value":"{{MICROESIM-NONCE}}","type":"text"},{"key":"MICROESIM-TIMESTAMP","value":"{{MICROESIM-TIMESTAMP}}","type":"text"},{"key":"MICROESIM-SIGN","value":"{{MICROESIM-SIGN}}","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"device_id","value":"9000024081684603","description":"Device ID (ICCID No)
\n","type":"text"}]},"url":"{{url}}/allesim/v1/eventDetail","description":"notify_type:\"DOWNLOADED\", \"INSTALLED\", \"DELETE\", \"ENABLE\", \"DISABLE\"
\n","urlObject":{"path":["allesim","v1","eventDetail"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"c3da912a-b897-44cf-8f00-2e1ed23e516d","name":"/allesim/v1/eventDetail","originalRequest":{"method":"POST","header":[{"key":"MICROESIM-ACCOUNT","value":"113490b1281917ab9d47657cedb6ce","type":"text"},{"key":"MICROESIM-NONCE","value":"","type":"text"},{"key":"MICROESIM-TIMESTAMP","value":"","type":"text"},{"key":"MICROESIM-SIGN","value":"any string","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"device_id","value":"9000024081684603","description":"Device ID (ICCID no)","type":"text"}]},"url":"{{url}}/allesim/v1/eventDetail"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.15.11"},{"key":"Date","value":"Mon, 29 May 2023 07:04:46 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"X-Powered-By","value":"PHP/7.4.3"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 1,\n \"msg\": \"Success\",\n \"result\": [\n {\n \"event_date\": \"2023-07-05 04:16:15\",\n \"eid\": \"89033023426300000000032653960548\",\n \"notification_status\": \"Executed-Success\",\n \"notify_type\": \"DOWNLOADED\"\n },\n {\n \"event_date\": \"2023-07-05 04:16:28\",\n \"eid\": \"89033023426300000000032653960548\",\n \"notification_status\": \"Executed-Success\",\n \"notify_type\": \"INSTALLED\"\n },\n {\n \"event_date\": \"2023-07-05 04:16:48\",\n \"eid\": \"89033023426300000000032653960548\",\n \"notification_status\": \"Executed-Success\",\n \"notify_type\": \"ENABLE\"\n },\n {\n \"event_date\": \"2023-07-05 12:50:44\",\n \"eid\": \"89033023426300000000032653960548\",\n \"notification_status\": \"Executed-Success\",\n \"notify_type\": \"DISABLE\"\n },\n {\n \"event_date\": \"2023-07-05 12:50:46\",\n \"eid\": \"89033023426300000000032653960548\",\n \"notification_status\": \"Executed-Success\",\n \"notify_type\": \"ENABLE\"\n }\n ]\n}"}],"_postman_id":"63e2fa41-b86c-45ce-96b8-6f99ddbf7b81"},{"name":"/allesim/v1/accountBalance","event":[{"listen":"prerequest","script":{"id":"c5884016-2952-40c5-9445-05ca373fe1ac","exec":[""],"type":"text/javascript","packages":{}}}],"id":"a12fc3f5-11c0-4c85-a691-136f34684609","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"MICROESIM-ACCOUNT","value":"{{MICROESIM-ACCOUNT}}","type":"text"},{"key":"MICROESIM-NONCE","value":"{{MICROESIM-NONCE}}","type":"text"},{"key":"MICROESIM-TIMESTAMP","value":"{{MICROESIM-TIMESTAMP}}","type":"text"},{"key":"MICROESIM-SIGN","value":"{{MICROESIM-SIGN}}","type":"text"}],"url":"{{url}}/allesim/v1/accountBalance","description":"Returns the account balance.
\n","urlObject":{"path":["allesim","v1","accountBalance"],"host":["{{url}}"],"query":[],"variable":[]}},"response":[{"id":"455a1dc2-8a16-4ac8-93ed-9d4d58bfafe9","name":"/allesim/v1/accountBalance","originalRequest":{"method":"POST","header":[{"key":"MICROESIM-ACCOUNT","value":"113490b1281917ab9d47657cedb6ce","type":"text"},{"key":"MICROESIM-NONCE","value":"","type":"text"},{"key":"MICROESIM-TIMESTAMP","value":"","type":"text"},{"key":"MICROESIM-SIGN","value":"any string","type":"text"}],"url":"{{url}}/allesim/v1/accountBalance"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.16.1"},{"key":"Date","value":"Fri, 25 Feb 2022 02:38:47 GMT"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"X-Powered-By","value":"PHP/7.2.9"}],"cookie":[],"responseTime":null,"body":"{\n \"code\": 1,\n \"msg\": \"Success\",\n \"result\": {\n \"balance\": 14860.23,\n \"currency\": \"HKD\",\n \"account\": \"MicroeSIM\"\n }\n}"}],"_postman_id":"a12fc3f5-11c0-4c85-a691-136f34684609"}],"event":[{"listen":"prerequest","script":{"type":"text/javascript","exec":[""],"id":"b97edb82-eeff-4b30-b7fd-3a7c3e7185e7"}},{"listen":"test","script":{"type":"text/javascript","exec":[""],"id":"00acbb8d-f00f-4bed-a266-39002fe33328"}}],"variable":[{"key":"baseUrl","value":"http://api.tsim.com","type":"string"}]}