# Perguntas Frequentes

Perguntas comuns relacionadas a como o Pix Automático funciona.

### Criando uma solicitação de pagamento PIX automático

- **A autorização expira?**
  O consentimento recorrente não tem uma data de expiração por padrão. Se necessário, você pode definir uma incluindo o campo `expiresAt` ao criar a solicitação de pagamento. A tentativa inicial de autorização do PIX Automático expira após 60 minutos se o pagador não a completar, e o `consentUrl` usado para a autorização bancária expira após 5 minutos.

- **Quais são os campos `fixedAmount`, `minimumVariableAmount` e `maximumVariableAmount`?**
  *Nota: O seguinte se aplica apenas a pagamentos agendados e não ao primeiro pagamento. Para detalhes sobre o primeiro pagamento, veja a próxima seção "Primeiro Pagamento."*
  - Se `fixedAmount` for fornecido, todos os pagamentos agendados associados a esta solicitação de pagamento devem ter exatamente esse valor.
  - Se `minimumVariableAmount` e `maximumVariableAmount` forem fornecidos, cada pagamento agendado deve ter um valor dentro desse intervalo. Uma vez que o consentimento é autorizado, esses valores não podem ser modificados. **Importante**: Algumas instituições (por exemplo, Nubank) permitem modificar o `maximumVariableAmount` quando o usuário autoriza o consentimento.

- **O que é o `interval`?**
  Isso define a frequência do pagamento. Por exemplo, se o intervalo for definido como `MONTHLY`, apenas um pagamento por mês é permitido (excluindo o primeiro pagamento). O intervalo não pode ser alterado após a autorização do consentimento.

- **O que acontece se a `description` não for enviada?**
  A instituição define uma descrição padrão.

- **Quais tipos de destinatários podem ser configurados na solicitação de pagamento?**
  Apenas empresas (CNPJ) podem ser configuradas como destinatários para pagamentos automáticos do Pix. O pagador pode ser uma pessoa física (CPF) ou uma empresa (CNPJ).

- **Posso mudar a conta do receptor?**
  Sim, você pode fazer isso de duas maneiras:
  - Editando o destinatário existente: [Atualizar Destinatário do Pagamento](/reference/payment-recipient-update#/)
  - Criando e enviando um novo ao agendar um pagamento: [Agendar PIX Automático](/reference/payment-request-create-automatic-pix-schedule#/). A única restrição é que o novo destinatário deve ter o mesmo CNPJ que o destinatário original, caso contrário, o pagamento falhará.

### Primeiro pagamento

- **O valor pode exceder ou diferir do limite autorizado?**
  Sim. O valor do primeiro pagamento é independente dos limites de pagamento autorizados. Por exemplo, se o usuário autorizou pagamentos entre R$100 e R$500, o primeiro pagamento ainda pode ser R$2.000.

- **Quando este pagamento é liquidado?**
  O primeiro pagamento pode ser liquidado no momento ou pode ser agendado para outra data.

- **É considerado parte dos limites de intervalo da autorização?**
  Não. Por exemplo, se o usuário autorizou um pagamento por mês, o primeiro pagamento não afeta esse limite.

- **É obrigatório configurar um primeiro pagamento?**
  Não, é completamente opcional.

### Agendando um pagamento

- **Quando um pagamento pode ser agendado?**
  Após a solicitação de pagamento ser autorizada, os pagamentos podem ser agendados entre D+2 e D+10 a partir de hoje, e somente se a periodicidade do pagamento permitir. Por exemplo, se a periodicidade for `WEEKLY` e um pagamento for agendado para quinta-feira, um novo pagamento pode ser agendado a partir da próxima quinta-feira (um pagamento por semana). O mesmo se aplica a outros tipos de intervalo (`MONTHLY`: mesmo dia todo mês, anualmente).

- **Como os ciclos de pagamento são calculados?**

  Dependendo do tipo de intervalo selecionado, os ciclos de pagamento são calculados de maneira diferente, usando a `startDate` configurada como referência. Os pagamentos podem ser agendados em qualquer dia entre as datas de início e fim de cada ciclo (levando em conta as restrições D+2 e D+10 mencionadas anteriormente). Por exemplo:

  Data de início do consentimento: 20/12/2025

  - *WEEKLY*: Um novo ciclo começa a cada 7 dias
    - Primeiro ciclo: 20/12/2025 - 26/12/2025
    - Segundo ciclo: 27/12/2025 - 02/01/2026
    - Etc.
  - *MONTHLY*: Um novo ciclo começa no mesmo dia de cada mês. Se o dia não existir em um mês específico (por exemplo, 31/04), o ciclo começa no último dia disponível desse mês (neste caso, 30/04)
    - Primeiro ciclo: 20/12/2025 - 19/01/2026
    - Segundo ciclo: 20/01/2026 - 19/02/2026
    - Etc.
  - *QUARTERLY*: Mesmas regras que *MONTHLY*, mas a cada 3 meses:
    - Primeiro ciclo: 20/12/2025 - 19/03/2026
    - Segundo ciclo: 20/03/2026 - 19/06/2026
    - Etc.
  - *SEMESTER*: Mesmas regras que *MONTHLY*, mas a cada 6 meses:
    - Primeiro ciclo: 20/12/2025 - 19/06/2026
    - Segundo ciclo: 20/06/2026 - 19/12/2026
    - Etc.
  - *YEARLY*: Mesmas regras que *MONTHLY*, mas a cada 1 ano:
    - Primeiro ciclo: 20/12/2025 - 19/12/2026
    - Segundo ciclo: 20/12/2026 - 19/12/2027
    - Etc.

- **O que acontece se o pagamento falhar?**
  Veja a seção "Tentativas".

- **Um pagamento agendado pode ser modificado?**
  Não, uma vez que um pagamento é agendado, ele não pode ser modificado. Se você precisar alterar a data, o valor ou a descrição, deve cancelá-lo e agendar um novo.

### Cancelando pagamentos e revogando consentimentos

- **Quais pagamentos podem ser cancelados?**
  Apenas pagamentos com o status `SCHEDULED` podem ser cancelados. Uma vez que o pagamento é concluído, ele só pode ser reembolsado manualmente pelo destinatário. Veja: [Cancelar Agendamento de PIX Automático](/reference/cancel-automatic-pix-schedule)

- **Um consentimento de PIX automático pode ser revogado?**
  Sim. Veja: [Cancelar Consentimento de PIX Automático](/reference/payment-request-cancel-automatic-pix-consent). Após revogar o consentimento, nenhum novo pagamento pode ser agendado sob essa solicitação de pagamento. Este processo é assíncrono, então após receber uma resposta daquele endpoint, alguns segundos podem passar até que o consentimento seja cancelado. Todos os pagamentos agendados (exceto aqueles a serem liquidadas no mesmo dia da cancelamento) também serão cancelados.

### Tentativas

- **Como implementar tentativas?**

  Existem duas maneiras de implementar tentativas:
  - Usando o sistema de tentativas automáticas da Pluggy (recomendado)
  - Implementando um fluxo de tentativas personalizado. Mais informações aqui: [Como Tentar um Pagamento](/docs/getting-started-with-pix-automático#7-how-to-retry-a-payment)

- **Quantas vezes o banco tenta executar o pagamento?**
  O banco tenta executar o pagamento duas vezes:
  - Primeira tentativa: Entre 00:00 e 08:00 no dia agendado.
  - Segunda tentativa: Se a primeira tentativa falhar (por exemplo, devido a fundos insuficientes), uma segunda tentativa é feita entre 18:00 e 21:00 no mesmo dia.

  Depois disso, se o consentimento de PIX automático estiver configurado para permitir tentativas, até três tentativas adicionais podem ser feitas dentro de uma janela de 7 dias (5 para pagamentos semanais). Essas tentativas devem ser enviadas até 22:00 no dia anterior à nova data de pagamento agendada. Se a solicitação de pagamento não permitir tentativas ou o número máximo de tentativas for alcançado, o pagamento receberá um status de `ERROR` e não poderá ser tentado novamente.

  Para tentar um pagamento, ele deve ter sido agendado com sucesso e depois falhado na data de liquidação.

  > **Importante: se você perder a janela de 7 dias para agendar uma tentativa, esse pagamento não poderá mais ser tentado e você não poderá agendar novos pagamentos durante esse período. Além disso, a janela de 7 dias pode ser mais curta se o ciclo de pagamento terminar antes desse dia.**