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

Response Example

202 - Success

{
  "data": {
    "refund_id": "12345",
    "created_at": "2024-10-12 09:30"
  },
  "meta": {
    "message": "success"
  }
}

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

Examples

Responses

🟢202Accepted

application/json

Body

data

object

required

refund_id

string

required

created_at

string

required

Refund Request

Overview#

⚠️ Important Disclaimer#

Request

Responses

Overview

⚠️ Important Disclaimer