A plataforma de billing que dá aos seus devs APIs em OpenAPI, checkout e central do cliente em código aberto,
faturamento recorrente ou por consumo e NFS-e nacional — sem abrir mão da liberdade de gateway de pagamento (PSP).
RecoPay é uma plataforma SaaS brasileira de gestão de receita recorrente, cobranças, pagamentos
e NFS-e. Em vez de construir faturamento, inadimplência, checkout e portal do zero, o time de desenvolvimento
conecta o produto a uma camada pronta: a API REST documentada em OpenAPI recebe os eventos da
operação, enquanto o RecoPay preserva regras comerciais, conciliação, comunicação e documentos fiscais em um
fluxo rastreável.
O checkout de contratação e a central do cliente são projetos independentes,
disponíveis em código aberto no GitHub, para baixar, personalizar com a marca e publicar no
próprio domínio. O faturamento pode ser recorrente (valor fixo) ou por consumo
(valor variável), e a NFS-e tem cobertura nacional, disparada automaticamente após
o pagamento.
A arquitetura de pagamento é agnóstica a PSP: hoje operando com Mercado Pago, preparada para
novos provedores sob demanda ou em breve. O desenvolvedor não fica preso a um único banco.
Capacidades da API
Tudo o que o RecoPay expõe para o seu produto
Recursos REST com contrato OpenAPI, idempotência e validação de escopo.
REST
Clientes e assinaturas
Cadastre clientes por integração e contrate assinaturas pelo checkout. Produtos, planos e preços são configurados no painel e consultados pela API.
REST
Cobranças
Crie, consulte e cancele cobranças avulsas pelo seu backend. Nas assinaturas, o RecoPay gera as cobranças do ciclo e fatura o consumo registrado.
REST
Consumo (uso variável)
Registro de eventos de consumo (componentes medidos) para faturamento por uso: API calls, usuários ativos, armazenamento ou qualquer métrica.
Webhook
Pagamentos e conciliação
Pix, boleto e cartão via PSP, com webhook e conciliação automática. Status da cobrança atualizado após a confirmação do provedor.
Webhook
NFS-e nacional
Emissão de NFS-e para qualquer município do Brasil, automática após o pagamento ou sob demanda. PDF e XML quando retornados pelo provedor fiscal.
REST
Situação financeira e acesso
Consulte atrasos e links de pagamento para aplicar a política de acesso do seu produto. As réguas de e-mail e WhatsApp são configuradas no painel do RecoPay.
Início rápido
Faturamento por consumo em uma chamada
Autenticação por Bearer token. Registre eventos de consumo e o RecoPay cuida do preço contratado,
franquia, faturamento, conciliação e NFS-e. Sem prefixo /v1 — consulte sempre o contrato
OpenAPI atual.
O RecoPay é uma camada entre o seu produto e os provedores externos (PSP de pagamento e provedor fiscal).
O seu sistema continua sendo a fonte de verdade do negócio e envia eventos para o RecoPay; o RecoPay cuida do
faturamento, gera a cobrança, recebe o webhook do PSP, concilia, emite a NFS-e e notifica o cliente.
Fluxo padrão de integração
Cadastre produtos e planos no painel. Seu sistema consulta o catálogo, identifica o cliente e contrata a assinatura pelo checkout; integrações de cobrança avulsa usam as rotas protegidas de clientes e cobranças.
Para recorrência fixa, o RecoPay gera as cobranças conforme o ciclo. Para consumo, seu produto registra eventos de uso via /integracoes/usos.
O cliente paga no checkout público (ou no portal). O PSP confirma via webhook.
O RecoPay concilia e, conforme a regra, emite a NFS-e automaticamente.
Seu produto recebe webhooks de pagamento e NFS-e para atualizar o estado no seu domínio.
Gateway de pagamento (PSP) agnóstico
A arquitetura isola a integração com PSP em um gateway próprio. Hoje o RecoPay opera com Mercado Pago,
mas o gateway é uma abstração: novos PSPs podem ser adicionados sob demanda ou em breve, sem que o seu produto precise
mudar a integração. Você escolhe o provedor que oferece a melhor taxa e operação para o seu fluxo.
NFS-e nacional
A emissão de NFS-e atende qualquer município do Brasil, com certificado
digital A1. Pode ser disparada automaticamente após o pagamento ou sob demanda, retornando PDF e XML enviados por e-mail
ao cliente.
Casos de uso
Da dor do dia a dia à API que resolve
Cada caso é uma implementação guiada: contexto de negócio, endpoints reais e o caminho completo até a produção. Use como roadmap pronto para o seu time.
Disponível
Ciclo de venda completo
Integre a oferta, a contratação, o primeiro pagamento, o webhook de ativação, o onboarding e o acompanhamento da recorrência em seu produto.
Fature por API calls, armazenamento, usuários ativos ou transações aprovadas. Registre o consumo e o RecoPay aplica franquia e preço contratado no ciclo correto.
POST /integracoes/usosIdempotênciaConsumo variável
Contrate um plano já cadastrado, criando a assinatura e a primeira cobrança com idempotência. O checkout identifica o cliente e encaminha ao pagamento oficial.
POST /checkout/{checkoutPublicoId}/contratacoesCheckout
Localize ou crie o cliente e gere uma cobrança pontual a partir do seu backend, com escopos, idempotência, consulta de status e cancelamento explícito.
POST /integracoes/clientes/{id}/cobrancasIntegrações ExternasIdempotência
Escolha o plano pelo fluxo que pretende usar e pelo volume de chamadas. Os utilitários e as permissões da chave também precisam estar configurados.
API e volume de uso
O Starter oferece 100 requisições por mês para testes. Startup inclui até 10 mil, Growth até 25 mil e Scale até 100 mil requisições mensais, conforme a oferta atual.
Checkout, central e NFS-e
Checkout público e central do cliente estão incluídos no Growth e no Scale. NFS-e está disponível a partir do Startup, conforme os limites fiscais do plano. O Starter não inclui esses três recursos.
Utilitários e chaves
Avulsas, consultas financeiras e troca de planos via backend usam Integrações Externas. Para enviar consumo, ative também Cobrança variável por uso. Cada chave deve ter os escopos do guia escolhido.
O financeiro integrado ao seu dashboard usa a API e a sessão do seu produto. Ele é diferente da central pronta em código aberto. Consultar notas pela API não habilita emissão fiscal em um plano sem NFS-e.
