Refund Request

POST

/v2/refund

Overview

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.

⚠️ Important Disclaimer

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

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

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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."
}'

Responses

🟢202Accepted

application/json

Body

data

object

required

refund_id

string

required

created_at

string

required

Refund Request

Overview#

⚠️ Important Disclaimer#

Request

Required Fields

iccids

reason

Accepted Reason Values:

Optional Fields

notes

email

Request samples

Responses

Overview

⚠️ Important Disclaimer

`iccids`

`reason`

`notes`

`email`