1. Cloud eSIM Asynchronous notification
EIOTCLUB API
  • API Interface
    • Interface Description
    • Signature algorithm
    • Error Code
    • Card service interfaces
      • Query all cards under account (Deprecated)
      • Single Card Information Query (Deprecated)
      • Query Batch Card
      • Query Card Package Order Records
      • Query available packages for a card
      • Single Card Refresh (Deprecated)
      • Query international card warning information under the account
      • Card total statistics
      • Query profit sharing information at the current level
      • Query the list of operators that the card can switch to
      • Switch the operator of the card
      • Unlock the IMEI pool of the card
      • Add IMEI to the IMEI card pool
      • Send SMS
      • Query the refundable amount
      • Query customer account balance
      • Query the status of a package subscription order
      • Query the product to which the card belongs
      • Query the orderable packages under the specified product
      • Query orderable eSIM products
      • Purchase eSIM
      • Refund an eSIM order
      • Query eSIM order details
      • Query the refundable amount of an eSIM order
      • Query the details of the package corresponding to the order
      • Card bind device
      • Card unbind device
      • Card Transfer Package
      • Refresh package usage
      • Cancel current session
      • Query the seed number list of the eUICC card
      • Deliver eSIM remotely
      • Query all profiles under eUICC
      • Query Switchable Products for the Card
      • Switch Card Product
    • Card package subscription interfaces
      • Package subscription interface
      • Package refund interface
    • Asynchronous notification
      • Traffic alert
      • Unlock notification
      • Card locking notification
      • Subscription notification
      • Subscription notification - detailed version
      • Package activation notice
      • Product switching
      • Refund notification
      • Notification of package expiration upon reaching usage limit
      • Notification of card network disconnection
      • Notification of card being removed from the IMEI pool
      • Notification of card being moved into the IMEI pool
      • Notification of agent pool deact pkg
      • Notification of agent pool pkg activate
      • Notification of agent pool pkg traffic alert
      • EIM remote operation result notification
    • Cloud eSIM
      • Query all cloud eSIM cards under account
      • Single Cloud eSIM Card Details
      • Query Available Packages for Cloud eSIM Card
      • Query cloud eSIM card subscription records
      • Refresh eSIM card under account
      • Purchase eSIM card plan under account
      • Cloud eSIM card order status under account
      • Refund for Cloud eSIM Card Orders Under the Account
      • Query Refundable Amount for Cloud eSIM Card Orders Under the Account
      • Cloud eSIM Transfer Package
      • Cloud eSIM unlock
      • Query Switchable Products for the Cloud eSIM Card
      • Switch Cloud eSIM Card Product
      • Batch Add Cloud eSIM EIDs to IMEI Pool
    • Cloud eSIM Asynchronous notification
      • Traffic alert
        POST
      • Subscription notification
        POST
      • Package activation notice
        POST
      • Refund notification
        POST
      • Notification of package expiration upon reaching usage limit
        POST
      • Notification of card network disconnection
        POST
      • Product switching
        POST
      • Card locked notification
        POST
      • Card unlocked notification
        POST
    • Pool
      • Get pool package list
      • Create pool
      • Get pool list
      • Delete empty pool
      • Subscribe pool package
      • Get pool record list
      • Unsubscribe pool package
      • Get pool's can add card
      • Add pool's card
      • Get pool's card list
      • Remove pool's card
      • Get pool by iccid
    • CDR
      • Batch Query ICCID Traffic
  1. Cloud eSIM Asynchronous notification

Notification of package expiration upon reaching usage limit

POST
/customerNotifyUrl
The customer provides an address (HTTP/HTTPS) to receive asynchronous notifications.
Notification when the current package is deactivated (e.g., used up, expired, cancelled). The card may have other packages pending use.

Request

Body Params application/json

Example
{
    "data": "[{\"eid\":\"89852000263311290649\",\"eshopOrderId\":10005717,\"packageName\":\"CNu-QT-100M-7day\",\"packageCode\":\"CNU-QT-100M-7D-C-CNU-202403131FF1E56A\",\"state\":2,\"gzhPackageName\":\"100-7\",\"createDate\":\"2024-11-01 10:50:00\",\"packageType\":2}]",
    "event": "CloudESimPkgDeactivate",
    "id": "5IdTuJONGK5FYQ5BQT2IkUwu",
    "nonce": 55595,
    "sign": "39DE1981FBB166835626C2201FF974452A203D50",
    "timestamp": 1731033900
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://oapi.eiotclub.com/customerNotifyUrl' \
--header 'Content-Type: application/json' \
--data '{
    "data": "[{\"eid\":\"89852000263311290649\",\"eshopOrderId\":10005717,\"packageName\":\"CNu-QT-100M-7day\",\"packageCode\":\"CNU-QT-100M-7D-C-CNU-202403131FF1E56A\",\"state\":2,\"gzhPackageName\":\"100-7\",\"createDate\":\"2024-11-01 10:50:00\",\"packageType\":2}]",
    "event": "CloudESimPkgDeactivate",
    "id": "5IdTuJONGK5FYQ5BQT2IkUwu",
    "nonce": 55595,
    "sign": "39DE1981FBB166835626C2201FF974452A203D50",
    "timestamp": 1731033900
}'

Responses

🟢200Success
application/json
Bodyapplication/json

Example
{
    "status": "SUCCESS"
}
Modified at 2026-04-10 07:17:18
Previous
Refund notification
Next
Notification of card network disconnection
Built with