Submit top-up order - Airalo Developer Platform

To submit a top-up order:

Make a POST request to the endpoint URL {{url}}/{{version}}/orders/topups

Include a request body in the form of a FormData object, which contains the following required fields:

package_id: The ID of the top-up package you want to purchase

iccid: The ICCID of the eSIM for which you want to purchase the top-up package.

You can also include an optional description field to provide additional information about the order.

The API will respond with a JSON object containing the details of the order, including the package ID, quantity, price, and other information.

The complete workflow for buying a top-up package:

GET {{url}}/{{version}}/sims to see the list of purchased eSIMs

GET {{url}}/{{version}}/sims/:iccid/topups to see the list of available top-ups for the eSIMs

POST {{url}}/{{version}}/orders/topups with the proper "iccid" and "package_id" values to purchase a top-up

GET {{url}}/{{version}}/sims/:iccid/packages to see the list of all packages for the eSIM, including the original package and top-ups

For more informations, best practices visit our FAQ page: https://airalopartners.zendesk.com/hc/en-us/sections/13207524820893-FAQ

curl --location --request POST '/v2/orders/topups' \ --header 'Accept: application/json' \ --header 'Authorization: Bearer {{token}}' \ --form 'package_id="bonbon-mobile-30days-3gb-topup"' \ --form 'iccid="89340000000000872"' \ --form 'description="Example description to identify the order"'

{ "data": { "package_id": "bonbon-mobile-30days-3gb-topup", "quantity": "1", "type": "topup", "description": "Topup (89340000000000872)", "esim_type": "Prepaid", "validity": 30, "package": "Bonbon Mobile 2-3 GB - 30 Days", "data": "3 GB", "price": 10, "created_at": "2023-02-07 07:42:17", "id": 174, "code": "20230207-000174", "currency": "USD", "manual_installation": "", "qrcode_installation": "", "installation_guides": { "en": "http://airalo.local:8080/installation-guide" } }, "meta": { "message": "success" } }

Request

Header Params

string

required

Example:

application/json

Authorization

string

required

Example:

Bearer {{token}}

Body Params multipart/form-data

package_id

string

required

Required. A Topup Package ID, can be obtainer by executing a GET request to the "eSIM: List available top-up packages" endpoint

Example:

bonbon-mobile-30days-3gb-topup

iccid

string

required

Required. eSIM ICCID, that identifies the eSIM for the top-up package.
Can be obtained by execuring GET to the "eSIMs List" endpoint

Example:

89340000000000872

description

string

required

Optional. Order description to identify the order.

Example:

Example description to identify the order

Responses

🟢200Submit Top-up Order: 200 OK

application/json

Body

data

object

required

package_id

string

required

quantity

string

required

type

string

required

description

string

required

esim_type

string

required

validity

integer

required

package

string

required

data

string

required

price

integer

required

created_at

string

required

integer

required

code

string

required

currency

string

required

manual_installation

string

required

qrcode_installation

string

required

installation_guides

object

required