Cobre Base

Descubra todas funcionalidades

Cliente, preço, assinatura, fatura e o aviso quando o pagamento entra. Cada bloco abaixo mostra a tela e o que ela dispara.

Começar por clientes

Clientes

O cliente é a pessoa ou a empresa que recebe a cobrança. Assinatura, fatura, carnê e pagamento ficam ligados a esse cadastro.

O cadastro guarda nome, e-mail, telefone, documento e endereço. Pode ser pessoa física ou empresa. Um identificador externo liga o registro ao sistema de vocês, quando a criação vem pela API.

Cada cliente tem um saldo de crédito. Quem tem permissão concede ou debita um valor, com o motivo. Na emissão da fatura, o crédito disponível abate o total.

A ficha reúne o que já aconteceu com aquela pessoa: assinaturas, faturas, pagamentos e o extrato de crédito.

  • Pessoa ou empresa

    Nome, e-mail, telefone, documento e endereço.

  • Identificador externo

    O id do seu sistema, quando o cliente nasce pela API.

  • Crédito

    Saldo que abate a próxima fatura emitida.

  • Ficha

    Assinaturas, faturas, pagamentos e o extrato de crédito.

Produtos e preços

O produto é o que você vende. O preço é a regra que transforma plano, quantidade ou uso em valor na fatura.

Um produto pode ter mais de um preço. O preço é fixo, por unidade, por uso, por faixa, por pacote ou híbrido: uma mensalidade com franquia e excedente.

A cobrança é única ou recorrente. No recorrente, o intervalo é dia, semana, mês ou ano. O valor pode ser cobrado no início do período ou no fim, depois do uso.

Na faixa, o modo volume aplica uma tarifa ao total. O modo graduado cobra cada degrau com a própria tarifa. No pacote, o uso é arredondado para cima ou para baixo em blocos.

  • Fixo

    Um valor por período, independente de quantidade.

  • Por unidade

    Quantidade vezes o valor unitário.

  • Por uso

    O medido no período, com franquia inclusa se houver.

  • Por faixa

    Volume, uma tarifa no total, ou graduado, tarifa por degrau.

  • Por pacote

    Blocos de uso, arredondados para cima ou para baixo.

  • Híbrido

    Mensalidade mais o que passou da franquia.

Assinaturas

A assinatura junta o cliente, um ou mais preços e a forma de pagamento. A cada período, a Cobre Base fecha a fatura dessa combinação.

Ela pode começar com um teste. A primeira fatura sai quando o teste termina. A forma de pagamento é PIX, PIX recorrente, boleto ou cartão.

Dá para pausar, retomar ou cancelar. O cancelamento pode valer na hora ou no fim do período em curso.

Se o plano muda, o ajuste de pró-rata entra na fatura, é cobrado na hora ou não é feito. A assinatura também escolhe a régua de lembrete, o cupom e, se precisar, multa e juros diferentes do padrão da organização.

  • Situação

    Em teste, ativa, em atraso, pausada ou cancelada.

  • Período

    Início e fim do ciclo que a próxima fatura cobre.

  • Itens

    Um ou mais preços, cada um com quantidade.

  • Pró-rata

    Na próxima fatura, na hora, ou sem ajuste.

Uso e métricas

O medidor conta o que o cliente consumiu. Preço por uso, por faixa, por pacote ou com franquia lê esse total na hora de fechar a fatura.

Cada medidor tem nome, código, unidade e a forma de agregar o período: soma, contagem, máximo ou último valor. O reset é diário, semanal, mensal ou nenhum.

O seu sistema envia o evento com um identificador. O mesmo identificador não entra duas vezes. Evento rejeitado fica registrado com esse status, sem alterar o total.

No fechamento, o que estava na franquia não vira linha de excedente. O que passou aparece na mesma fatura do plano.

  • Soma, contagem, máximo ou último

    Como os eventos do período viram um número.

  • Identificador do evento

    Repetido, o evento é ignorado.

  • Franquia e excedente

    O incluso fica de fora. O resto entra na fatura.

  • Reset do período

    Diário, semanal, mensal ou nenhum.

Faturas

A fatura é o documento que o cliente paga. Ela nasce da assinatura, de uma parcela do carnê ou de um lançamento avulso.

Ela lista os itens, o subtotal, os descontos, os créditos e o total. A moeda é real. A situação vai de rascunho a em aberto, paga, anulada ou incobrável.

O vencimento segue a preferência da organização, ou o prazo definido na assinatura, no carnê ou na própria fatura. A emissão pode sair alguns dias antes do vencimento.

Com um único meio, a cobrança já nasce nele. Com mais de um, o cliente escolhe PIX, boleto ou cartão no link.

  • Rascunho

    Ainda não foi emitida para o cliente.

  • Em aberto

    Emitida, com vencimento, aguardando pagamento.

  • Paga

    O pagamento foi confirmado.

  • Anulada ou incobrável

    Cancelada, ou encerrada depois das tentativas.

Pagamentos

O pagamento é a tentativa de receber uma fatura. O painel mostra o meio, o valor e se entrou, falhou ou foi estornado.

Os meios são PIX, PIX recorrente, boleto e cartão. O PIX mostra o copia e cola e a validade. O boleto mostra a linha digitável. O cartão mostra bandeira, final e, quando houver, em quantas vezes foi parcelado.

A situação passa por pendente, em processamento, pago, falhou, cancelado, estornado ou estornado em parte.

O recebimento sai pelo provedor ligado à organização. Nas preferências, você define qual provedor atende PIX, boleto e cartão.

  • PIX

    Copia e cola, com prazo de expiração.

  • PIX recorrente

    A assinatura cobra de novo sem um novo código.

  • Boleto

    Linha digitável e código de barras.

  • Cartão

    Bandeira, final e parcelas, se o checkout permitir.

Carnês

O carnê parcela um combinado. Você informa a quantidade, o primeiro vencimento e se o valor digitado é o total ou o de cada parcela.

Cada parcela vira uma fatura, numerada, com o próprio vencimento. A régua de lembrete, a multa e o cupom do carnê valem para essas faturas.

Se o carnê aceita um meio só, a parcela já nasce nele. Se aceita vários, o cliente escolhe no link daquela parcela.

  • Total ou por parcela

    O valor informado é dividido, ou já é o de cada uma.

  • Primeiro vencimento

    As parcelas seguintes seguem o intervalo.

  • Fatura por parcela

    O atraso de uma não mistura com o das outras.

  • Régua, multa e cupom

    Valem para as faturas geradas pelas parcelas.

Checkout

O checkout vende um ou mais preços. A pessoa preenche os dados, escolhe o meio e a assinatura é criada.

Você define os preços da tela, se há período de teste e se o cartão é obrigatório para concluir. Os meios exibidos podem ser cartão, PIX e boleto, todos ou só alguns.

O parcelamento no cartão fica desligado até você ativar. O teto vai de 2 a 12 vezes. Os juros ao mês, se existirem, entram em cada parcela. Com zero, o valor é só dividido.

Dá para pedir o endereço mesmo sem cobrança imediata. Depois do pagamento, a pessoa vai para a página de sucesso da Cobre Base ou para a URL que você informar. O checkout também pode usar um domínio da sua empresa.

  • Preços da tela

    Os planos que aparecem para quem abre o link.

  • Teste

    Dias antes da primeira cobrança, se estiver ligado.

  • Parcelas no cartão

    De 2 a 12, com ou sem juros ao mês.

  • Depois do pagamento

    Página padrão ou a URL de sucesso e a de erro.

Área do cliente

A área do cliente é a página de quem paga. Você escolhe o que essa pessoa pode ver e alterar.

Dá para mostrar o histórico de faturas e a segunda via. Os dados editáveis são e-mail, endereço, telefone e documento, cada um com um interruptor.

O cliente pode trocar a forma de pagamento, entre cartão, PIX e boleto, se você permitir. Na assinatura, as opções são mudar de plano, alterar quantidade, pausar e cancelar. O cancelamento e a troca de plano podem valer na hora ou no fim do período.

O uso do período pode aparecer na mesma área. A sessão tem um link que expira. A aparência usa o nome, a cor e a logo da empresa, e pode abrir num domínio seu.

  • Faturas

    Histórico e segunda via, se estiverem ligados.

  • Dados

    E-mail, endereço, telefone e documento.

  • Assinatura

    Plano, quantidade, pausa e cancelamento.

  • Link da sessão

    Expira. A API devolve um novo quando o seu sistema pede.

Marca e domínio

A cobrança sai com a cara da sua empresa. A logo e a cor entram no e-mail, no link de pagamento e na área do cliente.

No e-mail, você troca a cor e a logo do modelo. O texto do lembrete permanece o da régua.

O portal e o checkout aceitam um domínio seu. O DNS aponta um CNAME para o endereço da Cobre Base. Enquanto a verificação não termina, o domínio fica pendente.

  • E-mail

    Cor e logo. O texto do lembrete não muda aqui.

  • Portal e checkout

    Domínio da empresa, via CNAME.

Cupons

O cupom reduz o valor de uma assinatura, de uma fatura avulsa ou de um carnê. O cliente informa o código, ou você aplica no painel.

O desconto é percentual ou um valor fixo em reais. A duração é uma vez, por alguns meses ou enquanto a cobrança existir.

O cupom vale em todos os preços ou só nos produtos e preços escolhidos. Dá para exigir um valor mínimo, tetar o desconto percentual, restringir à primeira compra, permitir um uso por cliente e impedir a combinação com outro cupom.

Também dá para limitar os meios de pagamento, o número de resgates e o intervalo de datas. Fora da validade ou do limite, o código não aplica.

  • Percentual ou fixo

    Uma parte do valor, ou um desconto em reais.

  • Uma vez, por meses ou sempre

    Até quando o desconto acompanha a cobrança.

  • Onde vale

    Assinatura, fatura avulsa, carnê, catálogo inteiro ou preços escolhidos.

  • Resgates e validade

    Limite de usos e intervalo de datas. Fora disso, não aplica.

Lembretes

A régua de cobrança diz quando avisar, por qual canal e o que acontece depois da última tentativa.

Uma régua de fatura manda mensagem dias antes do vencimento, no dia ou dias depois. Os canais são e-mail, SMS e WhatsApp. Uma régua da organização pode ser a padrão. A assinatura, o carnê ou a fatura avulsa escolhe outra, se precisar.

A retentativa fica na régua: quantas vezes tentar e o intervalo em dias. Depois da última falha, a assinatura continua em atraso, é pausada, é cancelada ou a fatura é marcada como incobrável.

Outra régua avisa antes do fim do teste, contando os dias até o término. Multa e juros ficam à parte: um percentual no primeiro dia de atraso e juros ao mês, proporcionais ao dia. O padrão é da organização. Assinatura, carnê e fatura podem substituir.

  • Antes, no dia, depois

    O deslocamento é em dias em relação ao vencimento.

  • E-mail, SMS, WhatsApp

    Cada passo da régua escolhe os canais.

  • Depois da última falha

    Manter em atraso, pausar, cancelar ou marcar incobrável.

  • Multa e juros

    Percentual no primeiro dia e juros ao mês, por dia.

Notificações

A Cobre Base envia a notificação para o seu cliente por e-mail, SMS e WhatsApp.

Cada passo da régua escolhe o canal. O aviso sai dias antes do vencimento, no dia ou dias depois.

No e-mail, você troca a cor e a logo pela da sua marca. O texto do lembrete continua o da régua.

O SMS é enviado pela AWS, com a qualidade e a segurança da Amazon. No WhatsApp, a mensagem sai pelo número da sua empresa.

Provedor oficial da Meta

O WhatsApp sai pela Cloud API. Você conecta o número da sua empresa e a notificação sai por ele.

  • E-mail com a sua marca

    Cor e logo no modelo. O texto do lembrete não muda aqui.

  • Seu número no WhatsApp

    Você conecta o número da empresa. A mensagem sai por ele.

  • SMS pela AWS

    Envio pela Amazon, com qualidade e segurança.

  • Antes, no dia, depois

    O aviso segue o deslocamento da régua em dias.

Relatórios

O relatório olha um período: este mês, o mês passado, os últimos 3 meses, os últimos 12 ou um intervalo que você escolhe.

Na recorrência, ele mostra a receita mensal, a receita anualizada, o que entrou de novo, o que saiu com cancelamento, a variação líquida, o churn, o valor médio por cliente e quantas assinaturas e clientes estão ativos. O teste aparece separado, com a receita que ele representaria.

No mesmo período, o painel separa o faturado, o recebido, o em aberto e o em atraso, com a taxa de recebimento e a de inadimplência. Dá para ver isso por meio de pagamento, por origem da cobrança e por cliente.

  • Receita mensal

    O que as assinaturas ativas representam por mês, e o equivalente em doze meses.

  • Movimento

    Novas, canceladas e a variação entre o início e o fim do período.

  • Caixa do período

    Faturado, pago, em aberto e em atraso.

  • Por meio e origem

    Também por meio de pagamento, origem da cobrança e cliente.

Equipe e auditoria

A organização tem os dados da empresa, o fuso, a moeda e as preferências de cobrança. As pessoas entram com um papel.

Os papéis são responsável, administrador, desenvolvedor e financeiro. O papel define o que a pessoa altera: clientes, faturas, preços, chaves, equipe, régua e o restante do console.

A auditoria lista as ações feitas no painel desta organização: quem fez, qual papel tinha e em qual registro. Cada cliente, fatura e assinatura também guarda uma linha do tempo, marcada como vinda do painel, da API ou do webhook do provedor.

  • Responsável e administrador

    Acesso amplo à organização e à equipe.

  • Desenvolvedor

    Chaves, webhooks e a integração.

  • Financeiro

    Cobrança, fatura, pagamento e relatório.

  • Auditoria

    Quem alterou o quê, e de onde veio a ação.

API e webhooks

Pela API, o seu sistema cria cliente, assinatura e uso, e consulta a fatura. Produto, preço, cupom e régua continuam no painel.

A chave de teste e a chave de cobrança real são separadas. No teste, cliente e fatura não se misturam com o que foi cobrado de verdade. O webhook chama a URL cadastrada quando a fatura é paga, quando o pagamento falha ou quando a situação muda.

O contrato, a assinatura do webhook, o sandbox e o MCP no Cursor estão na página de desenvolvedores.

Ver a página de desenvolvedores

  • Cliente, assinatura e uso

    O que a API cria. A fatura ela devolve para consulta.

  • Chave de teste e chave real

    Ambientes separados.

  • Webhook

    Aviso quando a fatura ou o pagamento muda de situação.

  • Painel à parte

    Produto, preço, cupom e régua continuam no console.

Abra sua conta e cadastre seu primeiro cliente

A conta libera o console. Preço, régua e chave de teste ficam lá.

Abra sua conta