Skip to main content
O Pix Automático está em beta. As rotas, os campos e o comportamento podem mudar. Teste em Sandbox antes de usar em produção.
O Pix Automático permite cobrar um cliente de forma recorrente, como em assinaturas, mensalidades e contas de consumo. O cliente autoriza uma vez no app do banco dele. Depois disso, cada cobrança é debitada automaticamente no vencimento, sem que ele precise aprovar de novo. Para quem recebe, funciona como um débito automático: menos inadimplência por esquecimento e nenhum custo de boleto. Para quem paga, o controle fica no app do banco: ele vê os agendamentos, define um valor máximo e cancela quando quiser.

​
Conceitos

​
Como funciona

​
Jornadas de autorização

A jornada é a forma como o pagador chega à autorização. Você escolhe quais oferecer conforme o seu negócio. A instituição do pagador é obrigada a aceitar todas.
A mesma recorrência pode ser oferecida por mais de uma jornada, com o mesmo recurrenceId. A autorização acontece uma única vez, pela primeira jornada que o pagador concluir.

​
Identificador da recorrência

Cada recorrência tem um recurrenceId de 29 caracteres:
O segundo caractere precisa bater com o campo retry: RR para ALLOWED e RN para NOT_ALLOWED. Se você não enviar o recurrenceId, a API gera um, mas não o devolve na resposta da criação do QR Code. Gere o seu e guarde antes de criar a recorrência: é por ele que você consulta e concilia tudo depois.

​
Valor fixo ou variável

No valor variável, o pagador pode definir um valor máximo no app dele. Cobranças acima desse valor não são agendadas. O minPayerMaxAmount é o piso desse valor máximo: o pagador não pode definir um limite menor que ele. Você não vê o valor máximo que o pagador escolheu.
Hoje, a Delfinance gera as cobranças automáticas só para recorrências de valor fixo. Uma recorrência sem amount pode ser autorizada, mas não recebe cobranças. Use valor fixo até que o valor variável esteja disponível.

​
Cobranças recorrentes

Você não precisa enviar as cobranças de cada ciclo. Depois da autorização, a Delfinance envia automaticamente uma cobrança por ciclo, com o valor fixo da recorrência, entre 10 e 2 dias antes do vencimento. O primeiro vencimento é a recurrenceStartDate, e os seguintes seguem a periodicidade. A instituição do pagador agenda o débito e avisa o pagador. No dia do vencimento, o débito acontece entre 0h e 8h, e o valor chega na sua conta como um Pix recebido. Se faltar saldo, a instituição do pagador faz uma nova tentativa entre 18h e 21h do mesmo dia. Acompanhe as cobranças em Consultar autorizações e agendamentos.
Hoje, a Delfinance não envia retentativas depois do vencimento, mesmo em recorrências com retry igual a ALLOWED. Se o débito falhar no dia, cobre aquele ciclo por outro meio.
Todos os prazos estão em Regras e prazos.

​
Próximos passos

Escolha a jornada

Comece pela jornada 2, a mais simples: um QR Code só com a recorrência.

Regras e prazos

Janelas de envio, horários de débito, retentativas e cancelamentos.