# Ribbo

> A Ribbo é uma plataforma brasileira de billing e assinaturas para SaaS e produtos digitais. Ela cuida da cobrança recorrente e da venda única com checkout no domínio do vendedor, Pix e cartão, recuperação de pagamentos recusados, gestão completa da assinatura (troca de plano proporcional, cancelamento, reembolso, troca de forma de pagamento) e métricas como MRR e churn, usando a conta de gateway do próprio vendedor. A Ribbo cobra um plano fixo com cota de transações, sem porcentagem sobre as vendas.

Site: https://ribbo.app · Painel: https://dash.ribbo.app · Checkout: https://pay.ribbo.app · API: https://api.ribbo.app

## Em uma frase

Checkout, recorrência e recuperação. Na sua conta de gateway. A Ribbo cuida da cobrança recorrente do seu SaaS ou negócio por assinatura: checkout no seu domínio, nova tentativa quando o cartão recusa, troca de plano, reembolso e cancelamento com a conta feita, e o MRR certo no painel. A assinatura é sua, não do gateway. Serve também para venda única.

## O problema que resolve

O checkout fica num lugar, o MRR numa planilha, e quando um cartão recusa alguém precisa mandar e-mail na mão. Se um dia você quiser trocar de gateway, a base de assinantes vai junto. Cada ponta solta dessas custa dinheiro todo mês.

Sem a Ribbo: Checkout de terceiro, com a marca de outra empresa; MRR e churn no chute (ou numa planilha); Cartão recusado vira e-mail manual; Assinatura presa ao gateway, e trocar dói; Plano novo depende do time de dev.
Com a Ribbo: Checkout no seu domínio, com a sua marca; MRR, churn e recuperação no mesmo painel; Cartão recusado entra em retentativa automática; Troca de gateway sem perder assinante; Plano novo em minutos, direto no painel.

## Para quem é

- Assinatura recorrente: SaaS, curso, comunidade, app. Mensal, anual ou com trial. Renovação automática, Upgrade e downgrade com proração, Pix ou cartão salvo.
- Venda única: E-book, licença, setup, produto digital. Acesso por tempo ou vitalício. Order bump no checkout, Estoque e quantidade, No estorno, você decide se o acesso sai.
- SaaS com planos e limites: Cada plano libera recursos e limites (assentos, API, relatórios), com upgrade proporcional e cobrança em real, ou em dólar e euro com a Stripe.
- Curso ou comunidade: Assinatura mensal ou anual, Pix na renovação, campanha de renovação antecipada e indicação que dá mês grátis.
- App com teste grátis: Trial com o cartão salvo. Se o pagamento falhar no fim do teste, a retentativa entra em ação. Se o cliente cancelar antes, não paga nada.
- Venda única digital: E-book, licença ou setup, com acesso por tempo ou vitalício. Estoque para lançamentos, e no estorno você pode revogar o acesso.

## Recursos principais

- Recorrência automática: A Ribbo agenda cada ciclo, cobra o cartão salvo e confere se o pagamento entrou. Ninguém é cobrado duas vezes pela mesma renovação.
- Checkout que converte: No seu domínio, com Pix, cartão em até 18×, cupom, order bump, trial e pacotes. O número do cartão nunca passa pelo seu servidor.
- Recuperação de receita: Quando o cartão recusa, a Ribbo tenta de novo em dias diferentes, avisa o cliente por e-mail a cada recusa e manda um link para ele atualizar o cartão e pagar.
- Números que importam: MRR, churn, ticket médio, inadimplência e aprovação por meio de pagamento, tudo no horário de Brasília.

## Como funciona

O gateway só processa o pagamento. Quem agenda cada ciclo, cobra o cartão salvo, tenta de novo quando falha e avisa o seu sistema é a Ribbo. Por isso dá para trocar de gateway sem mexer na sua base de assinantes.

1. Você cria a oferta: Plano, preço, ciclo, trial e o que o cliente libera. Tudo pelo painel.
2. O cliente assina no checkout: Cartão tokenizado no navegador, ou Pix se você preferir.
3. A Ribbo cobra todo ciclo: Renovação automática, com retentativa e conferência diária.
4. Seu app libera o acesso: A Ribbo diz ao seu app o que cada cliente pode usar e mantém isso certo sozinha: pagou, atrasou, cancelou ou trocou de plano.

### Recuperação de pagamentos recusados

A venda não se perde na primeira recusa: a Ribbo tenta de novo em D+1, D+3, D+5 e D+9, e o cliente nunca é cobrado em dobro. Enquanto isso, o acesso continua liberado.
- O acesso continua durante o atraso
- E-mail a cada tentativa (dá para desligar)
- Link para o cliente atualizar o cartão e pagar
- Se o cliente pagar depois, a assinatura é reativada

## Pix

- QR 3 dias antes: O cliente recebe o Pix da renovação antes do vencimento e, se passar da data, lembretes um e três dias depois.
- QR vale 15 dias: Se o cliente perder o código, é só abrir o mesmo QR de novo.
- Reativação automática: O acesso é suspenso no 9º dia de atraso, mas o mesmo QR continua valendo: pagou, o acesso volta.
- Troca cartão ↔ Pix: O cliente muda a forma de pagamento por um link, sem gerar cobrança nova.

## Checkout

A mesma tela atende assinatura mensal ou anual, venda única, trial, pacote e parcelamento, e se ajusta a cada oferta.
- Parcelamento até 18×: Com ou sem juros, você escolhe, nos gateways que parcelam.
- Apple Pay e Google Pay: Pagamento em um toque no celular, quando o seu gateway oferece a carteira.
- Order bump: Um produto extra, ou mais tempo de assinatura (como mais 3 meses ou mais 1 ano), no momento do pagamento.
- Cupom por link: Mande o cupom no link da campanha, sem deixar o campo aberto para todo mundo.
- Estoque e quantidade: Limite vagas de verdade e venda várias licenças de uma vez.
- Trial e pacotes: Teste grátis com o cartão salvo (a primeira cobrança só vem no fim do teste), ou pacotes como '12 meses por R$ X' que depois renovam.
- Zero número de cartão: O cartão é tokenizado no navegador. O dado sensível não passa por você nem pela Ribbo.

## Gestão de assinaturas

A recorrência que vem embutida no gateway costuma resolver criar e cancelar. O resto vira planilha, script ou estorno na mão. Na Ribbo, cada situação do dia a dia tem uma ação própria no painel e na API, com o valor calculado, o cliente avisado e o seu app informado.

- Troca de plano proporcional: Upgrade na hora cobrando só os dias que faltam, downgrade agendado, troca de ciclo na hora quando o valor por ano sobe e agendada quando cai, prévia do valor antes de confirmar e cancelamento da troca agendada.
- Cancelar do jeito certo: Cancele na hora ou no fim do período já pago. Mudou de ideia? Desfaça o cancelamento agendado com um clique.
- Reembolso total ou parcial: No estorno você escolhe o que acontece com o acesso: cancelar a assinatura, revogar só aquela compra ou manter tudo como está.
- Forma de pagamento: Mande um link para o cliente trocar o cartão ou passar de cartão para Pix (e de volta), sem gerar cobrança.
- Reagendar a cobrança: Mude a data da próxima renovação de uma assinatura, sem cobrar nada a mais por isso.
- Mais tempo no checkout: Order bump que estende a assinatura, como mais 3 meses ou mais 1 ano, e pacotes pré-pagos de vários meses que depois renovam.
- Renovação antecipada: Campanhas com desconto, meses de bônus ou os dois, um link por assinante e lista para exportar.
- Cupons com regra: Por quantos ciclos valer, até 100% de desconto, por produto, plano ou oferta, só por link e mantido (ou não) na troca de plano.
- Link de pagamento pelo painel: Fatura em aberto vira um link para o cliente pagar. O painel não cobra o cartão de ninguém por conta própria.
- Trocar de gateway: Leve uma assinatura para outro gateway sem recomeçar: o cliente cadastra o pagamento no novo gateway e mantém o tempo já pago.
- Estoque e teste grátis: Limite de vendas por oferta para lançamentos e trial com o cartão salvo, cobrado só no fim do teste.
- Time com acesso por área: Quem cuida do suporte pode reembolsar sem poder editar ofertas. Cada pessoa vê só o que precisa.

### Troca de plano

- Upgrade na hora: Cobra só a diferença proporcional aos dias que faltam no ciclo.
- Downgrade agendado: Vale a partir do próximo ciclo, e dá para cancelar a troca agendada antes disso.
- Mensal → anual: Aproveita o crédito do que já foi pago.
- Anual → mensal: O saldo vira tempo de acesso, não estorno.
Antes de confirmar no painel, você vê exatamente quanto vai ser cobrado. E pelo painel a troca que tem cobrança vira um link para o cliente pagar: ninguém é cobrado sem pedir.

## Crescimento

- Programa de indicação: Seus clientes indicam outros e a recompensa entra como desconto na próxima fatura. Vale para quem indica e para quem chega, com metas, proteção contra fraude e estorno da recompensa se a venda for cancelada.
- Campanhas de renovação antecipada: Algo como 'renove hoje com 20% de desconto e ganhe 2 meses'. Você recebe antes e segura o cliente por mais tempo. Cada assinante tem o próprio link, dá para exportar a lista, e o preço nunca fica maior que o da renovação normal.

## Marca própria (white label)

Checkout em pay.suaempresa.com, com as suas cores, a imagem do produto e o seu favicon. Os e-mails saem com o seu remetente e o seu domínio.
- Checkout no seu domínio (CNAME verificado)
- Cores, modo escuro, textos e imagem do produto
- E-mails com o seu remetente (SPF/DKIM)
- Liga e desliga cada e-mail transacional
- E-mail de suporte por produto, no rodapé e na resposta

## Gateways

Você mantém as taxas que já negociou, e o dinheiro não passa pela Ribbo. Dá até para usar mais de um gateway ao mesmo tempo, um em cada oferta.
- Stone (Pagar.me · em real): Pix, também na assinatura; Cartão em até 18×; Google Pay, também na assinatura.
- Stripe (em real, dólar ou euro): Cartão; Apple Pay e Google Pay; Carteira também na assinatura.
- Asaas (em real): Pix, também na assinatura; Cartão na página segura do Asaas.

## Métricas no painel

Com o desconto do cupom aplicado, o anual dividido por 12 e sem contar quem está em trial sem cartão. Tem também churn, ticket médio, inadimplência e um mapa dos horários em que você mais vende.

## Para desenvolvedores

Seu produto não precisa saber regra de plano, nem ter tabela de planos ou script de cobrança. A Ribbo informa o que cada cliente pode usar (5 assentos? acesso à API?) e o seu app só confere se pode ou não.
- Avisos automáticos (webhooks): 19 eventos assinados e com reenvio: ativou, atrasou, cancelou, pagou, trocou de plano e outros.
- Liberação de acesso por plano: Cada plano define o que libera. Mudou o que um plano libera? A Ribbo avisa o seu app sobre todos os assinantes dele, sem script. Perdeu um aviso? Consulte a Ribbo a qualquer momento.
- API por escopo: Chave só de leitura para consultar, e de escrita apenas onde precisa.
- Pronto para IA: Servidor MCP (pacote ribbo-mcp no npm) para o seu agente de IA consultar e operar a cobrança.
- Docs com console de teste: 14 guias (incluindo a instalação do MCP) e uma referência em que você testa chamadas reais.

### Liberação de acesso (entitlements), sem script no app

- Cada plano define o que libera (por exemplo assentos, acesso à API, recursos). Os webhooks de assinatura levam esse conjunto em `entitlements`.
- Ao editar o que um plano libera no painel, a Ribbo envia `subscription.updated` para cada assinatura daquele plano que não está cancelada nem aguardando o primeiro pagamento (ativa, em teste, em atraso ou suspensa). O app do vendedor não precisa de script de migração.
- O acesso acompanha o pagamento: ativação, atraso, suspensão, cancelamento, reativação e troca de plano já saem com o status e o acesso corretos.
- `GET /v1/entitlements?external_id=...` (ou `email`) devolve a qualquer momento o que o cliente pode usar, somando as assinaturas válidas dele (ativa, em teste ou em atraso). Serve para reconciliar quando o app perdeu um webhook.

- Documentação: https://dash.ribbo.app/docs
- Referência da API: https://dash.ribbo.app/docs/reference
- OpenAPI: https://dash.ribbo.app/openapi.json
- Servidor MCP: https://www.npmjs.com/package/ribbo-mcp (guia de instalação: https://dash.ribbo.app/docs/mcp)

## Segurança e dados

- Nenhum cartão passa por você: A tokenização acontece no gateway, o que reduz o escopo PCI ao mínimo (SAQ A-EP).
- 2FA no painel: App autenticador ou e-mail, com dispositivos confiáveis.
- Dados no Brasil: AWS São Paulo, com banco gerenciado e backup contínuo (PITR).
- Chaves e trilha de auditoria: A chave do seu gateway fica cifrada e não aparece de novo, e você pode limitá-la aos IPs da Ribbo. Ações com dinheiro e mudanças de configuração ficam registradas.
- Feito com a LGPD em mente: Encarregado de dados nomeado, CPF, telefone e e-mail mascarados no suporte e no monitoramento de erros, e limpeza automática de dados de rastreamento depois de 180 dias.
- Time com acesso por área: Cada pessoa vê só as áreas de que precisa, e ações como reembolsar podem ser liberadas sem dar acesso para editar.

## Preços

À Ribbo o vendedor paga um plano fixo, mensal ou anual, com uma cota de transações. No anual a cota vale pelo ano inteiro e o pagamento é à vista ou em até 12× com juros (economize 2 meses em relação ao mensal):

- Essential: R$ 97,00/mês com 200 transações por mês; ou R$ 970,00/ano (equivale a R$ 80,83/mês, ou 12× de R$ 89,87 com juros) com 2.400 transações por ano
- Start: R$ 247,00/mês com 800 transações por mês; ou R$ 2.470,00/ano (equivale a R$ 205,83/mês, ou 12× de R$ 228,85 com juros) com 9.600 transações por ano
- Growth: R$ 597,00/mês com 2.000 transações por mês; ou R$ 5.970,00/ano (equivale a R$ 497,50/mês, ou 12× de R$ 553,14 com juros) com 24.000 transações por ano
- Scale: R$ 1.197,00/mês com 6.500 transações por mês; ou R$ 11.970,00/ano (equivale a R$ 997,50/mês, ou 12× de R$ 1.109,06 com juros) com 78.000 transações por ano
- Enterprise: R$ 2.397,00/mês com 18.500 transações por mês; ou R$ 23.970,00/ano (equivale a R$ 1.997,50/mês, ou 12× de R$ 2.220,91 com juros) com 222.000 transações por ano

- Passou da cota? As vendas continuam. A Ribbo avisa antes (50% e 80%) e você escolhe um plano maior.
- Upgrade automático só se você ligar, com aviso de 24 horas e o preço do novo plano antes.
- Upgrade no mesmo ciclo cobra só a diferença proporcional. Downgrade vale no fim do período atual.
- Acima de 18.500 transações por mês, montamos um plano sob medida.

A taxa de processamento (cartão, Pix) é a do contrato do vendedor com o gateway, paga direto ao gateway. A Ribbo não cobra porcentagem sobre as vendas. Teste grátis de 14 dias, sem cartão.

## Perguntas frequentes

### Preciso de programador para usar?

Para começar, não. Você cria produto, plano e oferta no painel e já sai com um link de checkout. A parte técnica (avisar o seu app quando alguém assina) é opcional e tem documentação pronta.

### Quais meios de pagamento?

Pix, cartão de crédito, Apple Pay e Google Pay, na assinatura e na venda única. O que aparece depende do gateway: na Stone (Pagar.me) tem Pix, cartão em até 18× e Google Pay; na Stripe, cartão, Apple Pay e Google Pay, em real, dólar ou euro, sem Pix; no Asaas, Pix e cartão pela página segura do Asaas. Boleto ainda não está disponível.

### Uso o meu gateway atual?

Sim, se ele estiver entre os gateways integrados. Você conecta com a sua própria conta e as suas taxas, e dá para usar mais de um ao mesmo tempo, um em cada oferta.

### Como funciona a recuperação de cartão recusado?

Se o cartão recusar no vencimento, a Ribbo tenta de novo em D+1, D+3, D+5 e D+9 e manda um e-mail a cada recusa, com um link para o cliente atualizar o cartão e pagar. Durante o atraso o acesso continua. Se as quatro novas tentativas falharem, a assinatura é suspensa e volta sozinha quando o cliente pagar. Você não precisa fazer nada.

### Serve só para assinatura?

Não. Dá para vender assinatura recorrente e também venda única (com acesso por tempo ou vitalício), com order bump, estoque e quantidade.

### Como o meu sistema libera o acesso do cliente?

A Ribbo avisa o seu app por webhook e informa o que o cliente pode usar. O seu produto só confere se aquele cliente tem acesso, sem regra de plano espalhada pelo código. O acesso acompanha o pagamento: suspendeu, cancelou, voltou a pagar ou trocou de plano, o aviso já sai com o acesso certo. E o seu app pode perguntar à Ribbo a qualquer momento o que um cliente pode usar, por exemplo se perdeu um aviso ou acabou de subir.

### Se eu mudar o que um plano libera, preciso atualizar cada cliente?

Não. Ao editar o plano no painel (por exemplo, o Pro passa de 5 para 10 assentos), a Ribbo avisa o seu app sobre todos os assinantes daquele plano (inclusive em teste, em atraso ou suspensos), um aviso por assinatura, sem script e sem planilha.

### Quanto custa?

Um plano fixo com cota de transações, pago à Ribbo. No mensal: Essential R$ 97,00 (200 transações), Start R$ 247,00 (800), Growth R$ 597,00 (2.000), Scale R$ 1.197,00 (6.500) e Enterprise R$ 2.397,00 (18.500). O anual sai pelo preço de 10 mensalidades, à vista ou em até 12× com juros. A taxa de processamento continua sendo a do seu gateway, paga direto a ele, e a Ribbo não cobra porcentagem sobre as suas vendas. Você testa 14 dias grátis, sem cartão.

### O que acontece se eu passar da cota de transações?

As suas vendas não param. A Ribbo avisa quando o uso chega a 50% e 80% da cota e quando ela acaba, para você escolher um plano maior. Se quiser, dá para ligar o upgrade automático: ele sobe um plano, cobrando só a diferença proporcional, e sempre avisa com 24 horas de antecedência e o preço do novo plano. Acima de 18.500 transações por mês, montamos um plano sob medida.

### Dá para trocar plano, cancelar e reembolsar pelo painel?

Sim. Pelo painel ou pela API você troca o plano com proração por dias (com prévia do valor no painel), cancela na hora ou no fim do período e desfaz um cancelamento agendado, reembolsa total ou parcialmente escolhendo o que acontece com o acesso, reagenda a próxima cobrança e manda um link para o cliente trocar o cartão ou passar para Pix sem cobrança. Quando a mudança gera cobrança, o painel cria um link para o cliente pagar.

### Como funciona o plano anual?

No anual você paga menos que doze mensalidades e a cota de transações vale pelo ano inteiro, não por mês. Serve bem para quem concentra as vendas em poucas épocas, como um SaaS que renova todo mundo no mesmo mês. Se desistir nos primeiros 7 dias, é só falar com o suporte: devolvemos o valor pago descontado o uso proporcional da cota.

### E se eu trocar de conta no gateway?

A Ribbo guarda em qual conta do gateway o cartão de cada cliente foi salvo. Se a conta conectada mudar, ela segura a renovação e avisa você no painel, em vez de tentar cobrar numa conta onde o cartão não existe. Para levar uma assinatura para outro gateway, você troca a oferta dela por uma oferta do novo gateway: a Ribbo manda ao cliente um link para cadastrar o pagamento lá, e a assinatura continua a mesma, com o tempo já pago.

### O dinheiro das vendas passa pela Ribbo?

Não. Você conecta a sua própria conta no gateway, e o pagamento cai direto nela. A Ribbo agenda, cobra, recupera e avisa, mas o dinheiro nunca fica com ela.

### Como a Ribbo trata a LGPD?

A Ribbo foi feita com a LGPD em mente: tem Encarregado de dados nomeado (privacidade@ribbo.app), Termos e Política de Privacidade públicos, mascara CPF, telefone e e-mail no suporte e no monitoramento de erros, apaga automaticamente dados de rastreamento e de avisos de gateway depois de 180 dias e não usa cookies de publicidade no checkout. Nos dados dos seus compradores, você é o controlador e a Ribbo atua como operadora.

### É seguro? Onde ficam os dados?

Nenhum número de cartão passa por você nem pelos servidores da Ribbo: ele é tokenizado no navegador, direto no gateway. O painel tem 2FA, os dados ficam no Brasil (AWS São Paulo) e a Ribbo trata dados pessoais conforme a LGPD, com Encarregado de dados e Política de Privacidade públicos. O enquadramento PCI é SAQ A-EP.

## Empresa

A Ribbo é operada por SPADETO CUGOLA SERVICOS DIGITAIS LTDA, CNPJ 52.192.397/0001-64, com sede em Brasília/DF, Brasil.
Suporte: suporte@ribbo.app
Termos de Uso: https://ribbo.app/legal/termos · Política de Privacidade: https://ribbo.app/legal/privacidade