DiscordStatus
Guias / Guides

FAQ do Pix Automático

Veja aqui respostas para dúvidas comuns na implementação e gestão dos Pix automáticos.

Consulte respostas para dúvidas comuns sobre criação de cobranças, pagamentos, retentativas, Split e elegibilidade no Pix Automático.

1. O que acontece se o cliente pagar a cobrança antes do vencimento?

Se a cobrança for paga por outro meio até o dia anterior ao vencimento, a instrução automática daquele ciclo é cancelada para evitar um novo débito.

A autorização permanece ativa para os próximos ciclos.

Para regras específicas durante uma retentativa, consulte Processo de retentativas do Pix Automático.

2. O Asaas pode gerar automaticamente as cobranças recorrentes?

Sim. O comportamento depende do paymentCreationMode definido na criação da autorização.

ModoComo as cobranças são criadas
MANUALSua aplicação cria cada cobrança pela API
SUBSCRIPTIONAs cobranças são geradas automaticamente por uma assinatura

MANUAL é o valor padrão.

Quando utilizar SUBSCRIPTION, informe também value na criação da autorização.

No modo MANUAL, vincule cada cobrança à autorização utilizando pixAutomaticAuthorizationId.

Consulte a implementação do Pix Automático.

3. Posso utilizar Split de Pagamentos?

Depende da etapa do fluxo.

  • QR Code inicial: não utilize Split na criação da autorização.
  • Cobranças criadas no modo MANUAL: o campo split pode ser enviado na criação da cobrança.

Consulte o endpoint Criar nova cobrança.

4. O que acontece se o pagador não tiver saldo ou limite no vencimento?

A instituição pagadora pode realizar novas tentativas no próprio dia, conforme as regras do Pix Automático.

Se o pagamento não for concluído, a instrução pode ser recusada e a cobrança permanecer vencida.

Quando a autorização estiver configurada com:

retryPolicy = ALLOW_THREE_IN_SEVEN_DAYS

sua integração também poderá solicitar retentativas em datas posteriores.

Consulte o processo de retentativas.

5. Como funcionam as retentativas?

Existem dois tipos:

  • intradia: executadas automaticamente pela instituição pagadora no mesmo dia;
  • extradia: solicitadas pela sua integração para datas posteriores.

Para permitir retentativas extradia, configure a autorização com:

retryPolicy = ALLOW_THREE_IN_SEVEN_DAYS

Essa política permite até três retentativas dentro dos sete dias após o vencimento, respeitando as demais regras do fluxo.

A configuração deve ser feita na criação da autorização.

Consulte as regras e a implementação das retentativas.

6. Posso alterar o valor das cobranças recorrentes?

Depende da configuração da autorização.

Quando value é informado, ele define um valor fixo para as cobranças vinculadas à autorização.

No modo MANUAL, quando a autorização não possui valor fixo, sua aplicação pode definir o valor ao criar cada cobrança, respeitando as condições autorizadas pelo pagador.

No modo SUBSCRIPTION, value é obrigatório.

Consulte o endpoint Criar uma autorização.

7. Quais são os requisitos para utilizar o Pix Automático?

A conta deve estar elegível para utilizar a funcionalidade.

Entre os critérios estão:

  • possuir conta Pessoa Jurídica;
  • estar aprovada;
  • não possuir pendências cadastrais;
  • possuir CNPJ ativo na Receita Federal;
  • possuir CNPJ ativo há pelo menos seis meses;
  • não possuir restrições relacionadas ao Pix.

A elegibilidade pode mudar ao longo do tempo.

8. Como identificar uma mudança de elegibilidade?

Acompanhe o evento:

PIX_AUTOMATIC_RECURRING_ELIGIBILITY_UPDATED

O campo eligibility.status pode retornar:

ELIGIBLE

ou:

INELIGIBLE

Quando a conta se tornar INELIGIBLE, utilize também eligibility.ineligibleReasons para identificar os motivos retornados.

A inelegibilidade pode cancelar autorizações e instruções vinculadas, impedindo a continuidade das cobranças do Pix Automático.

Consulte os eventos do Pix Automático.

9. Uma cobrança recusada cancela a autorização?

Não necessariamente.

Uma falha em uma instrução de pagamento não encerra automaticamente a autorização. Enquanto ela permanecer ativa, os próximos ciclos podem continuar normalmente.

Para identificar a causa da falha, consulte Motivos de Recusa.

10. Preciso acompanhar os Webhooks?

Sim.

Utilize Webhooks para acompanhar:

  • ativação, cancelamento e expiração da autorização;
  • criação e agendamento das instruções;
  • recusas e cancelamentos;
  • alterações de elegibilidade;
  • resultado das cobranças.

Como a entrega segue o modelo at least once, processe os eventos de forma idempotente utilizando o id do evento.

Consulte os Fluxos de Webhook do Pix Automático.

Próximos passos

Updated 7 days ago

Did this page help you?