FAQ do Pix Automático

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.

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?

Sim, nas cobranças criadas no modo MANUAL. No QR Code inicial, o Split não pode ser utilizado.

• QR Code inicial: não envie Split na criação da autorização.
• Cobranças do modo MANUAL: envie o campo split na criação de cada cobrança vinculada à autorização.

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.

11. Recebi PAYMENT_RECEIVED e depois PIX_AUTOMATIC_RECURRING_AUTHORIZATION_REFUSED. Por que isso aconteceu?

O pagamento inicial foi concluído, mas a instituição do pagador não enviou ao Asaas a confirmação da autorização.

Na Jornada 3, o pagador lê um único QR Code que reúne o pagamento da cobrança inicial e a autorização dos pagamentos recorrentes. Esse fluxo é processado em duas etapas:

1. A instituição do pagador envia o pagamento inicial e o Asaas confirma o recebimento. Nesse momento, é enviado o evento PAYMENT_RECEIVED.
2. Em seguida, a instituição do pagador deve enviar a confirmação da autorização. Quando ela é recebida, é enviado o evento PIX_AUTOMATIC_RECURRING_AUTHORIZATION_ACTIVATED.

Se a instituição do pagador não enviar a confirmação da etapa 2, a autorização não é ativada e você recebe o evento PIX_AUTOMATIC_RECURRING_AUTHORIZATION_REFUSED.

O envio dessa confirmação depende da instituição do pagador. Sem ela, o Asaas não consegue ativar a autorização.

O que fazer

Não é obrigatório estornar o pagamento inicial. Você pode escolher entre duas opções:

1. Estornar o pagamento e refazer a Jornada 3. Estorne a cobrança inicial e crie uma nova autorização. Ao pagar o novo QR Code, o pagador concede a autorização novamente.
2. Manter o pagamento e criar uma nova autorização no próximo ciclo. No próximo ciclo, crie uma nova autorização com immediateQrCode e informe o valor da cobrança do ciclo em immediateQrCode.originalValue. Ao pagar o QR Code, o pagador concede a autorização novamente.

Não vincule novas cobranças à autorização recusada. O campo pixAutomaticAuthorizationId aceita apenas autorizações com status ACTIVE.

Consulte o endpoint: Estornar cobrança, o endpoint Criar uma autorização e os Fluxos de Webhook do Pix Automático.

Próximos passos

• Implemente o Pix Automático
• Acompanhe os Fluxos de Webhook
• Conheça os Motivos de Recusa
• Implemente o processo de retentativas
• Compare Pix Automático e Assinaturas