Skip to main content
Renew an active plan for a SIM card. You can identify the card by either its order number or ICCID. The renewal creates a new order linked to the original via mainOrderNum. 
POST https://bpm.mioesim.com/api_esim/renewCard
Renewal is only available for plans where flowType=0 (renewable). Check this field in the package list before offering renewal to your customers.

​
Request parameters

​
token
string
required
Session token.
​
skuId
string
required
Product SKU ID.
​
priceId
string
required
Package price ID for the renewal plan.
​
sign
string
required
Request signature.
​
orderNum
string
Order number. Required if iccid is not provided.
​
iccid
string
ICCID of the card to renew. Required if orderNum is not provided.
​
daypassDays
string
Days to order for DayPass packages (supportDaypass=1).
​
backInfo
string
0/empty = order number; 1 = full details; 2 = PDF URL info.
​
pdfLanguage
string
PDF language code. See PDF Languages.
​
otherOrderId
string
Your external order ID.
​
otherItemId
string
Your external line item ID.
​
remark
string
Optional notes.

​
Response

Same structure as Place Order with backInfo=1. The renewal field is true and mainOrderNum contains the original order number.

​
Example

curl -X POST https://bpm.mioesim.com/api_esim/renewCard \
  -d "token=YOUR_TOKEN" \
  -d "iccid=934801019851134300" \
  -d "skuId=45" \
  -d "priceId=441" \
  -d "backInfo=1" \
  -d "sign=YOUR_SIGN"