> For the complete documentation index, see [llms.txt](https://docs.esimpay.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.esimpay.net/eng/webhook/order-status.md).

# Order Status

eSIMPAY sends a POST webhook with order status data. The body structure matches a successful order-status response.

{% hint style="info" %}
The notification URL can be passed in the callback field when creating an order.
{% endhint %}

#### status values

| Value          | Description                                    |
| -------------- | ---------------------------------------------- |
| in\_processing | Order is being processed — eSIM not yet issued |
| completed      | eSIM issued — a full data object is returned   |
| canceled       | Order canceled — funds returned to balance     |

When status is completed, the body includes esimProfile, customer, a list of activatedItems, and totalAvailableBalance. For in\_processing or canceled, only the basic identifiers are included.

{% hint style="info" %}
Specify your server's URL in eSIMPAY. Only HTTPS addresses are allowed.
{% endhint %}

####  Example of a request

```python
{
  "message": "ok",
  "uidCustomer": "550e8400-e29b-41d4-a716-446655440000",
  "orderId": "order_abc123",
  "status": "completed",
  "createdAt": "2026-02-11T06:55:05.619679+00:00",
  "esimProfile": {
    "iccid": "8948010000074947672",
    "imsi": "260010193678657",
    "activationCode": "LPA:1$rsp.truphone.com$KO-2U9NH9-1O20CCI",
    "appleUniversalLink": "https://esimsetup.apple.com/esim_qrcode_provisioning?carddata=LPA:1$rsp.truphone.com$KO-2U9NH9-1O20CCI",
    "androidUniversalLink": null,
    "installationUrl": "https://domain.store#/esim/profile?token=eyJhbGci...",
    "state": "RELEASED",
    "active": true,
    "activatedAt": null
  },
  "customer": {
    "uidCustomer": "550e8400-e29b-41d4-a716-446655440000",
    "profileUrl": "https://domain.store#/customer/profile?token=eyJhbGci..."
  },
  "activatedItems": [
    {
      "uid": "f70653e7-b6b8-438a-a8ea-3fea4749ffb2",
      "name": "Hong Kong, 10 GB, 30 Days",
      "activationMode": "FIRST_USE",
      "countrySet": "WWW",
      "salesDate": "2026-02-11T06:55:05.619679+00:00",
      "expiresAt": "2026-05-12T06:55:05+00:00",
      "activatedAt": null,
      "validity": {
        "size": 30,
        "unit": "days"
      },
      "availableBalance": {
        "sizeUnit": "GB",
        "sizeValue": 10
      },
      "size": {
        "sizeUnit": "GB",
        "sizeValue": 10
      },
      "salePrice": 2.0,
      "reward": 0.4,
      "rewardPercent": 20.0,
      "status": "activated"
    }
  ],
  "totalAvailableBalance": {
    "sizeUnit": "GB",
    "sizeValue": 10
  }
}
```