The Airalo Refund API makes it simple to request refunds for eSIMs. This guide walks you through everything you need to know, including the API endpoint, request and response formats, error handling, and sample requests.
The Refund API helps streamline the refund request process by reducing manual effort. However, submitting a request through this API does not guarantee approval.Each refund request is individually reviewed based on Airalo's Refund Policy to ensure it meets all terms and conditions. Refund approvals remain subject to Airalo’s internal policies and decisions. If your request meets the contract terms, the refund will be credited to your account as Airalo credits, ready to use for future transactions.Please note that access to this API requires a contract amendment. Make sure you have the right agreement in place before intergrating the service into you workflow.
Request
Header Params
Accept
string
optional
Indicates the expected response format.
Example:
application/json
Authorization
string
optional
Bearer token for authenticating the request
Example:
Bearer {{token}}
Body Params text/plain
Example
Required Fields
iccids
Type:array
Description: An array of ICCIDs (max 5). Each ICCID must be a string of digits.
reason
Type:string
Description: The reason for the refund. Accepted values listed below.
Accepted Reason Values:
INSTALLATION_FAILURE
NO_COVERAGE
APN_FAILURE
TRIP_CANCELLATION
INTERMITTENT_CONNECTION
BLOCKED_NETWORK
CHANGE_OF_PLAN
DELETED_ESIM
EARLY_EXPIRY
HOTSPOT_NOT_WORKING
IMSI_CHANGE
INCOMPATIBLE_DEVICE
LOCKED_DEVICE
NO_VOICE_TEXT_SERVICES
OVERCHARGED
SLOW_SPEED
TOP_UP_PACKAGE_FAILURE
UNKNOWN_CHARGES
WRONG_PURCHASE
UNABLE_TO_ACCESS_APPS
SERVICE_DEGRADATION
QR_ISSUE_PARTNERS
OTHERS
Optional Fields
notes
Type:string
Description: Additional notes (max 255 characters). Required if reason is "OTHERS".
email
Type:string
Description: Optional email address for follow-up (must be a valid email).
Example:
{
"iccids": [
"894000000000001",
"894000000000002"
],
"reason": "SERVICE_ISSUES",
"notes": "Connection issues in the region."
}
Request 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--request POST '/v2/refund' \
--header'Accept: application/json' \
--header'Authorization: Bearer {{token}}' \
--header'Content-Type: text/plain' \
--data-raw'{
"iccids": [
"894000000000001",
"894000000000002"
],
"reason": "SERVICE_ISSUES",
"notes": "Connection issues in the region."
}'
