Configuração por conta
As tarifas são associadas à estrutura comercial, respeitando os perfis e limites de acesso de cada usuário.
SPLIT DE PAGAMENTOS PIX E BOLETO
Split de pagamentos para software houses e contas vinculadas.
Organize a cobrança da plataforma e dos estabelecimentos atendidos. O Calebe Pay calcula a divisão a partir das tarifas vigentes da estrutura de contas e aplica essa configuração à emissão de Pix e boleto, pelo portal ou pela API.
- Por conta
- configuração da estrutura comercial
- Por vigência
- tarifas aplicadas na data da emissão
- Pix e boleto
- divisão integrada à cobrança
- Na transação
- resumo dos valores previstos
PASSO A PASSO
Como funciona o split de pagamentos no Calebe Pay
A estrutura é configurada antes da cobrança. A API usa a conta emissora para calcular a divisão correspondente.
- 01
Organize as contas vinculadas
Cadastre a relação entre plataforma e estabelecimentos e confirme as configurações necessárias para cada conta operar.
- 02
Defina as tarifas e a vigência
Os administradores autorizados configuram os valores por meio de pagamento e a data a partir da qual passam a valer.
- 03
Emita a cobrança da conta
Use a chave do estabelecimento para criar o Pix ou boleto. O servidor deriva a divisão automaticamente, sem enviar recebedores no corpo.
- 04
Acompanhe os valores e o pagamento
Consulte o resumo de retenção e valor previsto do estabelecimento junto da transação. Acompanhe o estado do pagamento e a liquidação pelos recursos da conta.
RECURSOS
Uma divisão ligada à estrutura de cobrança
A mesma configuração acompanha a emissão pelo portal, pela API e pelas transações geradas em links de pagamento.
Cálculo na emissão
A cobrança usa as tarifas já vigentes no momento da criação. Configurações futuras só participam quando entram em vigor.
Resumo na API
Os campos retained_amount e split apresentam a retenção prevista e o valor do estabelecimento, em centavos.
Histórico preservado
Mudanças posteriores de tarifa ou hierarquia não recalculam uma transação já emitida. Replay e refresh mantêm os valores originais.
Validação antes de cobrar
Uma divisão incompatível ou tarifas maiores que o valor da cobrança impedem a emissão e exigem revisão da configuração.
Teste sem transferência
O modo de teste calcula o mesmo resumo informativo, sem enviar cobrança ao provedor ou movimentar dinheiro.
O que é split de pagamentos
Split de pagamentos é a divisão de uma cobrança entre os participantes definidos na operação. Para uma software house, o objetivo pode ser organizar a remuneração da plataforma e o valor destinado ao estabelecimento que atende o cliente.
No Calebe Pay, o recurso segue a hierarquia de contas e as tarifas configuradas. A emissão usa essa configuração; não é necessário reproduzir a árvore de cálculo no sistema que cria a cobrança.
Split Pix e boleto para software houses e plataformas
Uma plataforma pode atender diferentes estabelecimentos, cada um com seu cadastro, credenciais e regras de cobrança. A chave usada na emissão identifica a conta responsável pelo Pix ou boleto e determina qual estrutura de tarifas será aplicada.
A disponibilidade depende da configuração comercial e financeira das contas envolvidas. A API pública atual não recebe listas arbitrárias de beneficiários ou percentuais livres por pedido: os valores vêm da estrutura previamente cadastrada.
Integração Pix para ERP e SaaS →Integração de boleto por API →
Como consultar o resumo da divisão pela API
amount informa o valor total da cobrança e retained_amount, a retenção prevista. Quando disponível, split reúne total_fee_amount, merchant_amount e on, com a data de vigência considerada. Os valores monetários são inteiros em centavos.
Esse resumo descreve a divisão preservada na emissão, antes de eventuais custos adicionais do provedor. Ele não comprova pagamento ou liquidação. Para reconhecer o recebimento, confira também o estado da transação e os registros financeiros correspondentes.
Vigência de tarifas e preservação do histórico
A criação considera a versão vigente das tarifas no dia da emissão, no horário de São Paulo. Agendar uma nova tarifa altera cobranças futuras quando a data chegar; não muda valores de cobranças que já existem.
Consultar, atualizar o status ou repetir a criação com a mesma chave e o mesmo corpo preserva a divisão original. Transações antigas podem ter o resumo nulo se foram emitidas antes de esse registro estar disponível.
PERGUNTAS FREQUENTES
Dúvidas sobre split de pagamentos
Não achou a resposta? Fale com um especialista pelo WhatsApp.
Como funciona o split de pagamentos do Calebe Pay?
A divisão é calculada pelo servidor a partir da conta emissora, da hierarquia de contas e das tarifas vigentes. O Pix ou boleto é emitido com a configuração correspondente, e a transação preserva um resumo dos valores previstos.
Posso usar split em Pix e boleto?
Sim, conforme a configuração das contas e dos meios de pagamento. A divisão é integrada ao fluxo de criação desses métodos e também às transações geradas por um link de pagamento.
Preciso enviar os beneficiários em cada chamada da API?
Não. O contrato público atual deriva a divisão da estrutura cadastrada. Não envie listas de recebedores, percentuais ou campos internos do provedor no corpo da cobrança.
Alterar uma tarifa muda o split de cobranças antigas?
Não. Cada cobrança preserva a divisão calculada na emissão. Alterações de tarifa ou hierarquia valem para novas cobranças, conforme a vigência, e não recalculam o histórico.
O valor merchant_amount já comprova saldo recebido?
Não. Ele representa o valor previsto para o estabelecimento na divisão da cobrança, antes de eventuais custos adicionais. A confirmação de pagamento e a liquidação precisam ser acompanhadas separadamente.
Posso testar o split antes de emitir uma cobrança real?
Sim. O modo de teste calcula o resumo da divisão sem envio ao provedor e sem transferência. A operação real continua dependendo da liberação de produção e da configuração das contas.
CADASTRO 100% ONLINE · CERCA DE 6 MINUTOS