Callback notify

Some eSIM activations are not real-time and may take some time to complete after placing an order. Pass the `notifyUrl` callback address when placing the order, and the system will actively POST a notification to this address upon successful activation; if `notifyUrl` is not provided, you can poll the order details interface to check the activation status.

Notification Method

Request Method: POST

Content-Type：application/json

Notification Address: The `notifyUrl` parameter passed when placing the order

Notification Content: JSON string, see the example below for the structure

Notification Test

* Enter the callback notification URL. The system will send a sample notification payload via POST to this address (matching the actual notification format) to verify whether the URL can receive notifications properly.

POST

Notification Content Example

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

Notification Field Descriptions

Field	Type	Description
sn	string	Order No.
notifyType	number	【Notification Type】 1 - Card Activation Successful 2 - Unsubscribe
activationStatus	string	【eSIM Activation Status】 activated - Activated unsubscribed - Unsubscribed
iccid	string	eSIM Card ICCID
lpa	string	eSIM Configuration (Used to generate QR code), returned only for successful activation notifications
number	string	eSIM Card Number, returned only for successful activation notifications
verifyCode	string	eSIM Configuration Authentication Code, returned only for successful activation notifications
qrcode	string	eSIM Configuration QR Code (base64 format), returned only for successful activation notifications
time	string	Notification Time (YmdHis)

Response Requirements

1. Please return HTTP status code 200 upon receiving the notification, which the system uses to determine a successful notification.

2. If a status other than 200 is returned or the address is unreachable, the system will retry at increasing intervals, up to a maximum of 3 attempts.

3. If all 3 notifications fail, no further retries will be made. You can then query the latest activation status via the order details interface.

4. After receiving the successful activation notification, you can call the order details interface to retrieve the complete eSIM card information (lpa, QR code, number, etc.).