# Order Webhook Events

Listen to order events to keep your integration always synchronized.

Webhooks are the safest and most reliable way to stay updated in real time.  
Your application will receive a notification whenever the status of a order changes.

## Order Events
- ORDER_CREATED — Order created.
- ORDER_UPDATED — Order updated.
- ORDER_PAID — Order fully paid.
- ORDER_PARTIALLY_PAID — Order partially paid.
- ORDER_CANCELED — Order canceled.
- ORDER_REFUNDED — Order refunded.
- ORDER_CHARGEDBACK — Order chargeback received.

Endpoint: POST Order Event
Version: 1.0

## Request fields (application/json):

  - `event` (string)
    Name of the event received.

  - `data` (object)
    Complete event data.

  - `data.id` (string)

  - `data.status` (string)
    Enum: "pending", "paid", "partially-paid", "canceled", "reversed", "refunded", "charged-back"

  - `data.valueInCents` (integer)

  - `data.createdAt` (string)

  - `data.buyer` (object)

  - `data.buyer.name` (string)

  - `data.buyer.email` (string)

  - `data.buyer.document` (object)

  - `data.buyer.document.type` (string)

  - `data.buyer.document.number` (string)

  - `data.buyer.phone` (object)

  - `data.buyer.phone.ddd` (string)

  - `data.buyer.phone.areaCode` (string)

  - `data.buyer.phone.isMobile` (boolean)

  - `data.buyer.address` (object)

  - `data.buyer.address.street` (string)

  - `data.buyer.address.neighborhood` (string)

  - `data.buyer.address.city` (string)

  - `data.buyer.address.state` (string)

  - `data.buyer.address.zipCode` (string)

  - `data.buyer.address.complement` (string)

  - `data.buyer.deliveryAddress` (object)

  - `data.business` (object)

  - `data.coupon` (object,null)

  - `data.coupon.code` (string)

  - `data.coupon.discount` (object)

  - `data.coupon.discount.percentage` (number)

  - `data.coupon.discountedValueInCents` (integer)

  - `data.items` (array)

  - `data.items.amount` (integer)

  - `data.items.product` (object)

  - `data.items.offer` (object)

  - `data.items.participants` (array)

  - `data.payments` (array)

  - `data.payments.fineValueInCents` (integer)

  - `data.payments.interestValueInCents` (integer)

  - `data.payments.paymentMethod` (string)

  - `data.payments.pix` (object,null)

  - `data.payments.pix.copyAndPasteCode` (string)

  - `data.payments.pix.qrCode` (string,null)

  - `data.payments.pix.expireAt` (string)

  - `data.payments.bankBillet` (object,null)

  - `data.payments.bankBillet.barCode` (string)

  - `data.payments.bankBillet.link` (string,null)

  - `data.payments.bankBillet.line` (string,null)

  - `data.payments.creditCard` (object,null)

  - `data.payments.creditCard.last4Numbers` (string)

  - `data.payments.creditCard.flag` (string)
    Enum: "visa", "mastercard", "american-express", "diners-club", "discover", "jcb", "unionpay", "maestro", "mir", "elo", "hiper", "hipercard"

  - `data.payments.creditCard.expiresAtYear` (integer)

  - `data.payments.creditCard.expiresAtMonth` (integer)

  - `data.payments.creditCard.holderName` (string)

  - `data.payments.refuse` (object,null)

  - `data.payments.refuse.rawDescription` (string)

  - `data.payments.installments` (integer)

  - `data.payments.valuePaidInCents` (integer)