回调通知

部分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、二维码、号码等）。