Saltar al contenido principal

Pix Automático

O Pix Automático é a cobrança recorrente por Pix: o pagador autoriza uma vez, no aplicativo do banco dele, e a partir daí as cobranças de cada período são debitadas sem que ele precise pagar uma a uma. Serve para mensalidades, assinaturas e contas de consumo.

Na Kobana, o Pix Automático é gerenciado pela API v2. O painel atual não tem telas de Pix Automático: os pagamentos recebidos aparecem na tela Recebimentos com Forma de Recebimento Pix Automático.

Como os recursos se relacionam​

RecursoPara que serve
Conta Pix AutomáticoLiga uma conta financeira e uma conexão com o banco ao Pix Automático. Todos os outros recursos pertencem a uma conta Pix Automático.
RecorrênciaO acordo com o pagador: quem paga, contrato, ciclo, valor, início e fim. É o que o pagador autoriza.
LocalizaçãoEndereço (URL) registrado no banco, usado nos QR Codes de autorização da recorrência.
SolicitaçãoPedido de autorização da recorrência enviado ao banco do pagador, que mostra o pedido no aplicativo dele.
CobrançaA cobrança de cada período, debitada da conta do pagador. Aceita cancelamento e retentativa.

O caminho mais comum:

  1. Crie a conta Pix Automático e associe a conexão com o banco.
  2. Crie a recorrência e aguarde o registro dela no banco.
  3. Peça a autorização ao pagador: por uma solicitação enviada ao banco dele, ou por QR Code, usando uma localização.
  4. Depois que o pagador autoriza (recorrência na situação Aprovado), crie as cobranças de cada período.
  5. Acompanhe os pagamentos pelos eventos de webhook ou na tela Recebimentos.

Registro no banco​

Recorrências, solicitações, cobranças e localizações são enviadas ao banco depois de criadas, em segundo plano, por um comando de registro. Esse envio automático depende das regras de registro automático da sua conta, que vêm habilitadas nas contas novas. Se um recurso continuar sem registro no banco, fale com o suporte para conferir essas regras.

Depois do registro, cada recurso tem uma Situação no Provedor, atualizada conforme o banco informa a Kobana. A Kobana também sincroniza periodicamente recorrências, solicitações e cobranças com o banco.

Bancos​

Consulte a lista de bancos para ver quais bancos têm integração de Pix Automático.

Permissões​

As permissões ficam no módulo Recebimentos:

RecursoProduto de permissão
Contas Pix AutomáticoContas Pix Automático (Ações Básicas, Criar, Alterar, Excluir)
Recorrências, solicitações, cobranças e localizaçõesPix (Ações Básicas para consultar, Criar, Alterar, Cancelar)

Pela API​

Todos os recursos de Pix Automático estão na API v2.