---
title: "Payment expired"
method: POST
path: "PAYMENT_EXPIRED"
tags: ["Webhooks"]
---

# Payment expired

`POST PAYMENT_EXPIRED` (webhook)

The payment expired before being completed. For boleto this is not always terminal — a boleto paid on or shortly after its due date can settle late, producing a `PAYMENT_PAID` afterwards for the same charge.

The HTTP body is this object exactly — there is no envelope and no `type` field. The event name is delivered in the `X-Webhook-Event` header. Most optional fields arrive as an explicit `null`; a few keys are dropped from the JSON entirely when unset, and those are marked as such below. Read values with a null-safe accessor rather than testing key presence.

## Payload

- object
  - `id` string, uuid — Payment id. Present only on some expiry paths.
  - `txId` string — Payment transaction id.
  - `status` 'EXPIRED' — Always `EXPIRED`.
  - `amount` number — Gross amount in BRL. Present only on some expiry paths.

## Acknowledgement `200`

Return a 2xx status to acknowledge receipt.

---

[API](https://skmtc.dev/yuvexpay/apis/yuvexpay-api.md) · [All operations](https://skmtc.dev/yuvexpay/apis/yuvexpay-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/yuvexpay/yuvexpay-api/revisions/9d4ba1cc037c/schema)