1. 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
        POST
      • Unlock notification
        POST
      • Card locking notification
        POST
      • Subscription notification
        POST
      • Subscription notification - detailed version
        POST
      • Package activation notice
        POST
      • Product switching
        POST
      • Refund notification
        POST
      • Notification of package expiration upon reaching usage limit
        POST
      • Notification of card network disconnection
        POST
      • Notification of card being removed from the IMEI pool
        POST
      • Notification of card being moved into the IMEI pool
        POST
      • Notification of agent pool deact pkg
        POST
      • Notification of agent pool pkg activate
        POST
      • Notification of agent pool pkg traffic alert
        POST
      • EIM remote operation result notification
        POST
    • 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
      • Subscription notification
      • Package activation notice
      • Refund notification
      • Notification of package expiration upon reaching usage limit
      • Notification of card network disconnection
      • Product switching
      • Card locked notification
      • Card unlocked notification
    • 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. Asynchronous notification

Refund notification

POST
/customerNotifyUrl
The customer provides an address (HTTP/HTTPS) to receive asynchronous notifications.
Notification for card package cancellation. The ICCID in the notification has cancelled the package.

Request

Body Params application/json

Example
{
    "event": "Refund",
    "iccid": "89423053323291099364",
    "id": "s2Vx3BfRtN1h253WeCLNRkAz",
    "nonce": 15487,
    "orderId": 10004728,
    "outTradeNo": "6300001983111426769635",
    "sign": "86AB51FECD873FDCF4B67F7CC4B2119D8BEFEE30",
    "timestamp": 1716860580
}

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 '{
    "event": "Refund",
    "iccid": "89423053323291099364",
    "id": "s2Vx3BfRtN1h253WeCLNRkAz",
    "nonce": 15487,
    "orderId": 10004728,
    "outTradeNo": "6300001983111426769635",
    "sign": "86AB51FECD873FDCF4B67F7CC4B2119D8BEFEE30",
    "timestamp": 1716860580
}'

Responses

🟢200Success
application/json
Bodyapplication/json

Example
{
    "status": "SUCCESS"
}
Modified at 2026-04-10 07:11:53
Previous
Product switching
Next
Notification of package expiration upon reaching usage limit
Built with