Skip to main content
Todos os casos de uso
White-label / EmbedFintechs

A sua marca e o seu app, com os pagamentos da CodeSpar por baixo.

Uma fintech (a Fintera, neste exemplo) quer que os seus assinantes paguem boletos e contas via Pix dentro do próprio app. Na CodeSpar, cada assinante é um consumidor da organização da Fintera: o onboarding do codespar_kyc abre a conta de pagamento do assinante pela Celcoin (CPF, ou CNPJ para empresa), e o codespar_pay paga um Pix ou um boleto existente a partir dessa conta. O app da Fintera é a interface; a CodeSpar roda os pagamentos por baixo.

Consulte os preços e as condições aplicáveis na página de preços.

AntesFluxos de pagamento fora do seu app
DepoisAssinantes pagam dentro do seu app, como consumidores da sua organização
org → consumers
cada assinante, um consumidor da sua organização
Teste no Sandbox
org
Sua organização
Cada assinante é um consumidor dentro dela
codespar_kyc
Onboarding
Abre a conta de pagamento do assinante pela Celcoin: CPF ou CNPJ
Pix · boleto
Pagamentos
O codespar_pay paga um Pix ou um boleto existente
statement
Histórico
O codespar_wallet action=statement lista os lançamentos de cada assinante
Exemplo ilustrativo · dados de demonstração

Uma organização, muitos assinantes.

Um exemplo com dados de demonstração: a organização da Fintera, os seus assinantes como consumidores, e os pagamentos por Pix e boleto que eles fizeram das próprias contas em agosto.

  • Cada assinante é um consumidor da organização da Fintera
  • A conta do assinante é aberta pelo onboarding do codespar_kyc
  • Cada pagamento sai da conta do próprio assinante

Mostre os pagamentos de agosto dos assinantes da Fintera.

Listando os pagamentos de agosto entre os consumidores da Fintera.

Pagamentos dos assinantes · exemplo
org_fintera · 2026-08
Exemplo
Organizaçãoorg_fintera
Assinantes41,200
RailsPix + boleto
Pago comcodespar_pay
payments-2026-08.csv
✓ exemploorg_fintera
A dor

A conversa é a parte fácil.

Fintechs de consumo que querem pagamento de contas acabam remontando onboarding, contas e pagamentos em volta de um processador, fora do app que os assinantes já usam.

Mandar o assinante para outro app para pagar uma conta

Assinantes pagam dentro do seu app, com a CodeSpar por baixo

Construir onboarding e contas do zero

O onboarding do codespar_kyc abre a conta de pagamento de cada assinante

Construir uma integração de pagamento por rail

O codespar_pay paga um Pix ou um boleto existente

Remontar o histórico de cada assinante

O codespar_wallet action=statement lista os lançamentos do assinante

Como o agente faz isso

A sua organização, os seus assinantes como consumidores.

Cada assinante é um consumidor da sua organização. O codespar_kyc com check_type onboarding (CPF) ou onboarding-business (CNPJ) abre a conta de pagamento do assinante pela Celcoin; o codespar_pay paga um Pix ou um boleto existente a partir dela; o codespar_wallet lê o saldo e o extrato. O seu app é a interface.

01
Cadastro
Seu app

No seu app

02
Onboarding
codespar_kyc

Conta de pagamento, CPF ou CNPJ

Celcoin
03
Pagar
codespar_pay

Pix ou boleto

codespar_pay
04
Extrato
codespar_wallet

Os lançamentos do assinante

Carteira
05
Mostrar
Seu app

O histórico no seu app

Arquitetura

A sua organização guarda os seus assinantes como consumidores. O codespar_kyc abre a conta de pagamento de cada consumidor na Celcoin (onboarding para CPF, onboarding-business para CNPJ), devolvendo uma verificação a consultar até a conta existir. O codespar_pay paga a partir dessa conta: um Pix para uma chave ou um copia-e-cola, ou um boleto existente pela linha digitável, com chave de idempotência. O codespar_wallet lê o saldo e o extrato do consumidor para o seu app.

Em código

O código, e o que ele pressupõe.

white-label-monetization.ts
// Prerequisites: CODESPAR_API_KEY set to a test key (csk_test_…), a Celcoin
// connection, and a subscriber (sub_8821) whose payment account was opened with
// codespar_kyc (check_type "onboarding"; see the meta-tool reference for its fields).
import { CodeSpar } from "@codespar/sdk";

const session = await new CodeSpar().create("sub_8821", { preset: "brazilian" });

// the subscriber pays an existing boleto from their own account
const pay = await session.execute("codespar_pay", {
  action: "pay",
  method: "boleto",
  linha_digitavel: "<the boleto's 47-digit line>",
  amount: 12_990, // centavos
  currency: "BRL",
  description: "Electricity bill",
  consumer_id: "sub_8821",
  idempotency_key: "bill-8821-2026-08", // required for a boleto
});
console.log(pay.success, pay.data);

// the subscriber's history, for your app
const statement = await session.execute("codespar_wallet", { action: "statement", consumer_id: "sub_8821", limit: 20 });
console.log(statement.data);

Exemplo com o SDK publicado (@codespar/sdk 0.16.11). Os pré-requisitos estão nos comentários. Compilar não prova a integração: rode primeiro em modo de teste.

Ferramentas em destaque
codespar_kyc

Abre a conta de pagamento do assinante pela Celcoin: onboarding (CPF) ou onboarding-business (CNPJ).

codespar_pay

Paga um Pix ou um boleto existente a partir da conta do assinante.

codespar_wallet

Lê o saldo e o extrato do assinante.

Ver a referência das meta-tools
Servidores MCP conectados

Comece com uma chave de teste.

Chaves de teste são gratuitas. Abra o sandbox, conecte os provedores que o seu projeto usa e veja quais ferramentas ele pode chamar antes de construir.

Monetização white-label — CodeSpar | CodeSpar