# Recorrências (/docs/cartao/endpoints/recurrences)



Uma recorrência é uma assinatura: a primeira cobrança é criada na hora e os ciclos seguintes são cobrados automaticamente no cartão, sem nova chamada à API. A recorrência nasce no [`POST /charges`](/docs/cartao/endpoints/charges/post_charges) com o nó `recurrence`; os endpoints abaixo consultam e gerenciam a assinatura já criada.

<QuickLinks>
  <QuickLink href="/docs/cartao/endpoints/charges/post_charges" title="Criar Cobrança (com recurrence)" method="POST" path="/charges" />

  <QuickLink href="/docs/cartao/endpoints/recurrences/get_charges_recurrences__recurrentPaymentId_" title="Consultar Recorrência" method="GET" path="/charges/recurrences/{recurrentPaymentId}" />

  <QuickLink href="/docs/cartao/endpoints/recurrences/put_charges_recurrences__recurrentPaymentId__amount" title="Alterar valor da Recorrência" method="PUT" path="/charges/recurrences/{recurrentPaymentId}/amount" />

  <QuickLink href="/docs/cartao/endpoints/recurrences/put_charges_recurrences__recurrentPaymentId__deactivate" title="Desativar Recorrência" method="PUT" path="/charges/recurrences/{recurrentPaymentId}/deactivate" />

  <QuickLink href="/docs/cartao/endpoints/recurrences/put_charges_recurrences__recurrentPaymentId__reactivate" title="Reativar Recorrência" method="PUT" path="/charges/recurrences/{recurrentPaymentId}/reactivate" />
</QuickLinks>

<Callout type="warn">
  Recorrência é sempre à vista: o campo `installments` precisa ser `1`. Valores maiores são rejeitados.
</Callout>

## Status da recorrência [#status-da-recorrência]

| Status     | Significado                                                      |
| ---------- | ---------------------------------------------------------------- |
| `ACTIVE`   | Ativa, gerando os ciclos no intervalo configurado.               |
| `INACTIVE` | Desativada (manualmente ou pelo emissor). Não gera novos ciclos. |
| `ENDED`    | Encerrada por ter atingido a `endDate`.                          |

## Listar os ciclos de uma assinatura [#listar-os-ciclos-de-uma-assinatura]

Para listar a cobrança inicial e todos os ciclos já gerados, use o [`GET /charges`](/docs/cartao/endpoints/charges/get_charges) com o filtro `recurrentPaymentId`:

```bash
curl "https://api.payzu.io/v1/charges?recurrentPaymentId={recurrentPaymentId}" \
  -H "Authorization: Bearer $TOKEN" \
  --cert cliente.crt \
  --key cliente.key \
  --cacert ca.pem
```

Cada ciclo vira uma cobrança vinculada à recorrência, numerada por `recurrenceCycle` (`0` = inicial, `1..n` = ciclos).

<Callout type="info">
  O guia completo de criação, ciclos e postbacks está em [Pagamentos Recorrentes](/docs/cartao/recurrence).
</Callout>