回調通知

部分eSim開通非實時，下單後可能需要一段時間才能完成開通。下單時傳入notifyUrl回調通知地址，開通成功後系統會主動POST通知該地址；未傳入notifyUrl時可通過訂單詳情接口輪詢查詢開通狀態。

通知方式

請求方式：POST

Content-Type：application/json

通知地址：下單時傳入的notifyUrl參數

通知內容：JSON字符串，結構見下方示例

通知測試

* 填寫回調通知地址，係統會嚮該地址POST發送一條示例通知內容（與實際通知方式一緻），用於驗證地址是否可正常接收通知

POST

通知內容示例

{
    "sn": "231013169",
    "notifyType": 1,
    "activationStatus": "activated",
    "iccid": "89852070322460401234",
    "lpa": "LPA:1$xxx.prod.xxxxxxxxxxx.com$TEST1234567890",
    "number": "86866878",
    "verifyCode": "123456",
    "qrcode": "data:image/png;base64,...",
    "time": "20260810120000"
}

通知字段說明

字段	類型	說明
sn	string	訂單號
notifyType	number	【通知類型】 1 - 開卡成功 2 - 退訂
activationStatus	string	【eSim開通狀態】 activated - 已開通 unsubscribed - 已退訂
iccid	string	eSim卡iccid
lpa	string	eSim配置(用於生成二維碼)，僅開卡成功通知返回
number	string	eSim卡號碼，僅開卡成功通知返回
verifyCode	string	eSim配置驗證碼，僅開卡成功通知返回
qrcode	string	eSim配置二維碼(base64格式)，僅開卡成功通知返回
time	string	通知時間（YmdHis）

響應要求

1、收到通知後請返回HTTP狀態碼200，系統以此判斷通知成功。

2、返回非200或地址不可達時，系統會按間隔遞增重試，最多通知3次。

3、3次通知均失敗後不再重試，可通過訂單詳情接口查詢最新開通狀態。

4、收到開卡成功通知後，可調用訂單詳情接口獲取完整的eSim卡信息（lpa、二維碼、號碼等）。