# Assinatura

URL: https://staging.pagpolar.com/docs/referencia/entidades/assinatura

> Contrato de cobrança recorrente de um cliente num plano. Cada ciclo cobrado vira uma [Venda](/docs/referencia/entidades/venda).

Contrato de cobrança recorrente de um cliente num plano. Cada ciclo cobrado vira uma [Venda](/docs/referencia/entidades/venda).

## Onde aparece

* [`POST /plans/offer/{id}/subscribe`](/docs/referencia/assinaturas/create-subscription)
* [`GET /subscriptions`](/docs/referencia/assinaturas/list-subscriptions)
* [`GET /subscriptions/{id}`](/docs/referencia/assinaturas/get-subscription)

## Campos

Campos anuláveis chegam com `null`. Campos com opções fixas listam todos os valores.

| Campo | Tipo | Obrigatório | Nulo | Descrição |
| --- | --- | --- | --- | --- |
| `id` | texto (uuid) | não | não | Exemplo: `f7a8b9c0-d1e2-4f3a-4b5c-6d7e8f9a0b1c`. |
| `status` | enum | não | não | Valores: `DRAFT`, `PENDING_PAYMENT`, `ACTIVE`, `PENDING_RENEWAL`, `PROCESSING`, `CANCELING`, `CANCELED`, `ASK_REFUND`, `REFUNDED`, `ABANDONED`, `EXPIRED`, `FAILED`. Exemplo: `ACTIVE`. |
| `payment_method` | enum | não | sim | Valores: `CREDIT_CARD`, `PIX`, `BOLETO`, `APPLE_PAY`, `GOOGLE_PAY`. Exemplo: `CREDIT_CARD`. |
| `start_at` | texto (date-time) | não | sim | Exemplo: `2026-01-01T00:00:00.000Z`. |
| `end_at` | texto (date-time) | não | sim | Data de término, quando a assinatura tem prazo definido. Exemplo: `null`. |
| `next_billing_at` | texto (date-time) | não | sim | Exemplo: `2026-09-01T00:00:00.000Z`. |
| `next_billing_amount` | número | não | sim | Exemplo: `97`. |
| `total_amount` | número | não | sim | Exemplo: `1164`. |
| `canceled_at` | texto (date-time) | não | sim | null enquanto a assinatura não é cancelada. Exemplo: `null`. |
| `cycle_limit` | inteiro | não | sim | Quantidade máxima de ciclos cobrados. `null` quando não há limite. Exemplo: `null`. |
| `paid_at` | texto (date-time) | não | sim | Exemplo: `2026-01-01T00:05:00.000Z`. |
| `created_at` | texto (date-time) | não | não | Exemplo: `2026-01-01T00:00:00.000Z`. |
| `customer` | [Cliente](/docs/referencia/entidades/cliente) | não | não | — |
| `offer` | [Oferta](/docs/referencia/entidades/oferta) | não | não | — |
| `product` | [Produto](/docs/referencia/entidades/produto) | não | não | — |