> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pagamerican.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Order status updated

> Fires on every order status change.

**Event:** `order.status.updated.v1`

Fires on every order status change. The current status comes in the `status` field (for example `paid`, `waiting_payment`, `refused`, `refunded`, `chargedback`) — use it together with `updatedAt` to determine the latest state, since [deliveries are not guaranteed to arrive in order](/webhooks/delivery).

Shipping tracking data (`supplierTrackingCarrier`, `supplierTrackingCode`, `supplierTrackingUrl`) appears when available; `supplierTrackingUrl` is only provided for some supported carriers. The payload also carries `settlementStatus` (financial settlement of the order), `supplierStatus` (fulfillment status with the supplier), and the [`amounts` breakdown](/webhooks/overview#the-amounts-breakdown) with tax and the total charged.

## Payload

```json theme={null}
[
  {
    "event": "order.status.updated.v1",
    "body": {
      "version": "v1",
      "orderId": "15630",
      "platform": "PagAmerican",
      "creatorId": null,
      "productId": null,
      "paymentMethod": "credit_card",
      "status": "paid",
      "createdAt": "1970-01-01 00:00:00",
      "approvedDate": "2026-01-29 21:02:34",
      "refundedAt": null,
      "updatedAt": "2026-01-29 21:02:34",
      "customer": {
        "name": "Jane Doe",
        "email": "jane.doe@example.com",
        "phone": "5551234567",
        "document": null,
        "country": "US",
        "ip": ""
      },
      "shipping": {
        "address1": "100 Example St",
        "address2": "",
        "city": "New Caney",
        "state": "TX",
        "country": "US",
        "zipCode": "77357"
      },
      "products": [
        {
          "id": "1637",
          "name": "Choco Burn - 6 bottles - [F] - [P3.2]",
          "offerCode": "uzmwn4VG",
          "sku": "PAGCHBU6BOTTLE",
          "planId": null,
          "planName": null,
          "quantity": 1,
          "priceInCents": 29400
        },
        {
          "id": "1657",
          "name": "Choco Burn - 10 bottles + 2 FREE - C [U1]",
          "offerCode": "XSqDSO5z",
          "sku": "PAGCHBU12BOTTLE",
          "planId": null,
          "planName": null,
          "quantity": 1,
          "priceInCents": 29000
        }
      ],
      "trackingParameters": {
        "src": "v3_9d8a33b2-1f6b-4fc5-9647",
        "sck": null,
        "utm_source": "BMD4505CA03jLj697c0518",
        "utm_campaign": "CAMPANHA-X|120244627975020273",
        "utm_medium": "ADSET-Y|120244630309230273",
        "utm_content": "AD-Z|120244630311850273",
        "utm_term": "Facebook_Mobile_Feed"
      },
      "commission": {
        "totalPriceInCents": 17000,
        "gatewayFeeInCents": 1240,
        "userCommissionInCents": 15760,
        "currency": "USD"
      },
      "amounts": {
        "itemsGrossInCents": 17000,
        "itemsCouponInCents": 0,
        "itemsNetInCents": 17000,
        "shippingGrossInCents": 0,
        "shippingCouponInCents": 0,
        "shippingNetInCents": 0,
        "taxesInCents": 1020,
        "totalInCents": 18020,
        "currency": "USD"
      },
      "isTest": false,
      "settlementStatus": "pending",
      "supplierStatus": "processed",
      "supportEmail": "support@example.com",
      "supplierTrackingCarrier": "UNIUNI",
      "supplierTrackingCode": "UUS61V6710974967897",
      "supplierTrackingUrl": "https://www.uniuni.com/tracking/?no=UUS61V6710974967897"
    }
  }
]
```