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

# Notifica o pagamento de uma parcela

<ParamField path="subscriptionId" type="integer" required>
  ID da assinatura. Obtido na resposta do endpoint `POST /subscriptions`.
</ParamField>

<ParamField path="installmentId" type="integer" required>
  ID da parcela a ser marcada como paga. Obtido na listagem de parcelas via `GET /subscriptions/{id}/installments`. **Atenção:** utilize o campo `id` da parcela, não o campo `number`.
</ParamField>

<ParamField header="Authorization" type="string" required>
  Token de autenticação do tipo Bearer obtido através do endpoint de login.
</ParamField>

<ParamField header="Accept" type="string" required>
  Deve ser definido como `application/json`.
</ParamField>

## Comportamento

Este endpoint não requer body. Ao ser chamado, registra a parcela indicada como paga (`status: paid`).

<Warning>
  Este endpoint está disponível exclusivamente para parceiros configurados com gateway de pagamento externo. Parceiros que utilizam o gateway da ClubFix devem usar `POST /subscriptions/{id}/payment`.
</Warning>

### Regra especial — Parcela 1

Quando a parcela notificada for a **número 1**, o status da Assinatura é automaticamente atualizado para `pago`, ativando o contrato. As demais parcelas apenas atualizam o status da própria parcela.

| Parcela notificada | Efeito na parcela | Efeito na assinatura          |
| ------------------ | ----------------- | ----------------------------- |
| Número 1           | `paid`            | `pago` ← ativação do contrato |
| Número 2 em diante | `paid`            | Sem alteração                 |

## Resposta

Retorna o recurso da parcela com o status atualizado.

| Campo          | Tipo    | Descrição                                   |
| -------------- | ------- | ------------------------------------------- |
| `id`           | integer | Identificador único da parcela.             |
| `number`       | integer | Número sequencial da parcela.               |
| `amount`       | float   | Valor da parcela em reais.                  |
| `due_date`     | string  | Data de vencimento no formato `YYYY-MM-DD`. |
| `status`       | string  | Status atualizado: `paid`.                  |
| `status_label` | string  | Rótulo: `Pago`.                             |