Webhook definition

A webhook is a method in the context of Airalo's API, which serves as a means to seamlessly push real-time data updates to our partner's designated endpoint URL. This functionality ensures timely and efficient data synchronization between our systems and those of our valued partners.

NOTE: Whenever an optin is performed, the webhook_url parameter is checked by the system via HEAD request, to which it must respond with 200 OK to be considered successful

There are three types:
- Credit Limit Notification
- Low Data Notification
- Async Order

Custom Header for Payload Signing

To enhance the security and integrity of transmitted data, our webhook implementation includes a custom header for payload signing which is a HMAC value with sha512 algorithm. Partners are strongly encouraged to include this header in their requests to validate the authenticity and integrity of the payload.

Header name: airalo-signature

Examples on how to verify the integrity of the received webhook event:

Response examples

Below are response examples for an HTTP 200 request:



// Credit Limit Notification Example
{
   "message": "Surpassed 80% of the credit limit balance",
   "remaining": 225.35
}


// Low Data Notification Example
{
   "level": "3days", // possible values "1days", "3days", "75%", "90%"
   "package_name": "bonbon-7gb-10days",
   "remaining_percentage": 43,
   "iccid": "87123123456889019"
}

Custom Header for Payload Signing#

Response examples#

Custom Header for Payload Signing

Response examples