Autorização pelo banco
O consentimento fica associado ao pagador, ao valor e ao calendário da cobrança. O cliente pode cancelar a autorização no banco.
PIX AUTOMÁTICO PARA EMPRESAS
Pix Automático para receber mensalidades com autorização do cliente.
Seu cliente autoriza uma vez no aplicativo do banco. O Calebe Pay agenda os débitos do calendário contratado e permite acompanhar cada recebimento pelo portal ou pela API. Uma opção para SaaS, escolas, academias e prestadores de serviços com cobranças recorrentes.
- Uma autorização
- aprovação pelo pagador no banco
- Valor fixo
- por calendário autorizado
- 2 a 10 dias
- de antecedência para agendar
- Webhook
- para o estado de cada cobrança
PASSO A PASSO
Como funciona o Pix Automático no Calebe Pay
A autorização, o agendamento e a confirmação do pagamento são etapas distintas. O portal e a API permitem acompanhar cada uma.
- 01
Defina o contrato
Informe valor, pagador, primeiro vencimento e periodicidade. O calendário aceita intervalos de 1, 3, 6 ou 12 meses, com primeiro vencimento ao menos 2 dias à frente.
- 02
Peça a autorização ao cliente
Apresente o código copia e cola da autorização ou o QR Code correspondente. O cliente tem 24 horas para aprovar no aplicativo do banco.
- 03
Vincule uma assinatura
Crie a assinatura com a autorização e os mesmos dados do contrato. Após a aprovação, o Calebe Pay agenda os débitos na janela permitida.
- 04
Acompanhe cada recebimento
O débito agendado aparece como transação pendente. Confirme o recebimento quando a transação alcançar paid em produção, por consulta ou webhook assinado.
RECURSOS
Recorrência integrada à sua operação
Use o calendário do Calebe Pay ou controle os vencimentos pelo seu próprio sistema.
Assinatura com calendário
O agendador da plataforma acompanha os ciclos e agenda os débitos depois da aprovação, respeitando a antecedência bancária.
Débitos por API
Se seu ERP já controla a recorrência, envie cada vencimento autorizado por POST /v1/pix-automatic/charges.
Conciliação por transação
Cada débito tem ID, referência, vencimento agendado e estado de pagamento para relacionar o recebimento à mensalidade.
Simulação antes de cobrar
Teste aprovação, cancelamento, expiração e confirmação de pagamento com chave de teste, sem movimentação financeira.
Histórico no portal
Consulte a assinatura, os ciclos e as transações para acompanhar a cobrança e identificar situações que exigem atenção.
Pix Automático e Pix recorrente: qual a diferença?
Uma assinatura por Pix pode gerar um link a cada vencimento, que o cliente abre e paga. No Pix Automático, ele aprova uma autorização no banco e os débitos seguintes são agendados conforme o contrato, sem precisar pagar um novo QR Code a cada ciclo.
No Calebe Pay, a autorização usa valor fixo e calendário em meses. Não há cobrança imediata na autorização nem nova tentativa bancária automática por falta de saldo nesta modalidade implementada.
Compare os meios de cobrança de uma assinatura →Conheça também o Pix com QR Code →
Integração Pix Automático por API
Seu backend cria a autorização em POST /v1/pix-automatic/authorizations, com X-API-Key e Idempotency-Key. A resposta traz copy_paste para apresentar ao pagador. Guarde o ID e consulte a aprovação com POST /v1/pix-automatic/authorizations/{id}/refresh: nesta versão, a autorização não emite webhook próprio.
Para delegar o calendário, crie a assinatura em POST /v1/subscriptions com method pix_automatic e authorization_id. Para controlar cada débito, use o endpoint de charges: a data deve pertencer ao calendário autorizado e estar de 2 a 10 dias à frente. Cada autorização aceita um débito por vencimento.
As mudanças de estado das cobranças chegam em transaction.updated. A autorização aprovada e o débito agendado ainda não representam pagamento; acompanhe o estado da transação.
Cancelamento, disponibilidade e controle financeiro
A emissão real depende da liberação de produção e da configuração de Pix Automático da conta. Valide o fluxo em teste e confirme as condições comerciais antes de oferecer a modalidade aos clientes.
Pausar uma assinatura interrompe as próximas emissões. Revogar a autorização impede novos agendamentos, mas não estorna pagamentos já realizados. Cobranças já emitidas continuam válidas quando a assinatura é pausada ou cancelada.
Débitos avulsos criados pela API podem receber um centro de custo da própria conta. Os ciclos de assinaturas ainda não herdam essa classificação automaticamente.
PERGUNTAS FREQUENTES
Dúvidas sobre pix Automático
Não achou a resposta? Fale com um especialista pelo WhatsApp.
O cliente precisa autorizar o Pix Automático?
Sim. O pagador aprova a autorização pelo aplicativo do banco. No Calebe Pay, o código tem prazo de 24 horas para aprovação; somente uma autorização aprovada permite agendar os débitos.
É possível cobrar mensalidades sem cartão de crédito?
Sim. O Pix Automático permite programar débitos com autorização do pagador, conforme a disponibilidade e a liberação da conta. As assinaturas também podem emitir boletos ou links de Pix para pagamento pelo cliente.
Quais periodicidades e valores são aceitos?
A implementação do Calebe Pay usa valor fixo e intervalos de 1, 3, 6 ou 12 meses. Valor, documento do pagador, primeiro vencimento e intervalo da assinatura devem corresponder à autorização.
O débito é repetido se faltar saldo?
A modalidade implementada não inclui nova tentativa bancária automática por falta de saldo. Acompanhe o resultado da transação e trate a pendência com o cliente, conferindo o estado antes de emitir outra cobrança.
Posso testar Pix Automático sem débito real?
Sim. A chave de teste cria registros simulados e permite simular a resposta do pagador e o pagamento. O código de autorização de teste não é aceito por bancos.
Cancelar a assinatura cancela a autorização?
Não. São controles separados: cancele a assinatura para interromper próximas emissões e revogue a autorização para impedir novos agendamentos. Isso não estorna pagamentos nem invalida automaticamente cobranças já emitidas.
CADASTRO 100% ONLINE · CERCA DE 6 MINUTOS