1. Cloud eSIM
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
        POST
      • Single Cloud eSIM Card Details
        POST
      • Query Available Packages for Cloud eSIM Card
        POST
      • Query cloud eSIM card subscription records
        POST
      • Refresh eSIM card under account
        POST
      • Purchase eSIM card plan under account
        POST
      • Cloud eSIM card order status under account
        POST
      • Refund for Cloud eSIM Card Orders Under the Account
        POST
      • Query Refundable Amount for Cloud eSIM Card Orders Under the Account
        POST
      • Cloud eSIM Transfer Package
        POST
      • Cloud eSIM unlock
        POST
      • Query Switchable Products for the Cloud eSIM Card
        POST
      • Switch Cloud eSIM Card Product
        POST
      • Batch Add Cloud eSIM EIDs to IMEI Pool
        POST
    • 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. Cloud eSIM

Refund for Cloud eSIM Card Orders Under the Account

POST
/api/v3/cloudesim/refund
Refund for Cloud eSIM card orders under the account
Error Codes:
45113 - Refund is not allowed in the current status. Orders can only be refunded when in successful status
Rules for calculating refundable amount:
1.
Full refund within 24 hours after purchase;
2.
Refund amount = min(unused days/total usable days, unused data/total data) * total user payment amount;
3.
For foreign currencies like Japanese Yen, the minimum unit is cents, rounded down; for Japanese Yen, the minimum unit is Yuan, also rounded down;

Request

Body Params application/json

Example
{
    "appkey": "{{APPKEY}}",
    "timestamp": 1787775642,
    "nonce": 85139,
    "sign": "{{SIGN}}",
    "orderId": "48",
    "remark": "laborum"
}

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/api/v3/cloudesim/refund' \
--header 'Content-Type: application/json' \
--data '{
    "appkey": "",
    "timestamp": 1787775642,
    "nonce": 85139,
    "sign": "",
    "orderId": "48",
    "remark": "laborum"
}'

Responses

🟢200成功
application/json
Bodyapplication/json

Example
{
    "code": "200",
    "message": "success",
    "data": {}
}
Modified at 2026-09-16 06:48:41
Previous
Cloud eSIM card order status under account
Next
Query Refundable Amount for Cloud eSIM Card Orders Under the Account
Built with