Refunds
Two related capabilities — do not confuse them.
Comparison
| Profile cancel/revoke | Order refund | |
|---|---|---|
| Path | /esim/profile/cancel or /revoke | /esim/refund |
| Effect | Cancel profile with platform | Refund amount to BALANCE wallet |
| Wallet | Does not auto-refund | Auto-refunds (see status) |
| Typical use | Void eSIM only | Customer refund, reconciliation |
Profile cancel
Request (identify profile with one of):
json
{
"profileId": 123,
"iccid": "8986...",
"esimTranNo": "..."
}asyncStatus in response:
| Value | Meaning |
|---|---|
COMPLETED | Finished synchronously |
PENDING | Async — 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.