Skip to content

Refunds

Two related capabilities — do not confuse them.

Comparison

Profile cancel/revokeOrder refund
Path/esim/profile/cancel or /revoke/esim/refund
EffectCancel profile with platformRefund amount to BALANCE wallet
WalletDoes not auto-refundAuto-refunds (see status)
Typical useVoid eSIM onlyCustomer refund, reconciliation

Profile cancel

Request (identify profile with one of):

json
{
  "profileId": 123,
  "iccid": "8986...",
  "esimTranNo": "..."
}

asyncStatus in response:

ValueMeaning
COMPLETEDFinished synchronously
PENDINGAsync — poll order or wait for webhook

Order refund

json
{
  "orderNo": "ORD20260101001",
  "remark": "Customer request",
  "items": [
    {
      "itemNo": "ITEM001",
      "profileTokens": ["8986..."]
    }
  ]
}

status: REFUNDED (done) or REFUNDING (in progress — wait for REFUND_COMPLETED webhook, see Webhooks).

See Refund Order and Cancel Profile.

eSIM Dealer Open API v1