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

Tu marca y tu app, con los pagos de CodeSpar por debajo.

Una fintech (Fintera, en este ejemplo) quiere que sus suscriptores paguen boletos y cuentas por Pix dentro de su propia app. En CodeSpar, cada suscriptor es un consumidor de la organización de Fintera: el onboarding de codespar_kyc abre la cuenta de pago del suscriptor por Celcoin (CPF, o CNPJ para una empresa), y codespar_pay paga un Pix o un boleto existente desde esa cuenta. La app de Fintera es la interfaz; CodeSpar corre los pagos por debajo.

Consulta los precios y las condiciones aplicables en la página de precios (en inglés).

AntesFlujos de pago fuera de tu app
DespuésLos suscriptores pagan dentro de tu app, como consumidores de tu organización
org → consumers
cada suscriptor, un consumidor de tu organización
Pruébalo en el Sandbox
org
Tu organización
Cada suscriptor es un consumidor dentro de ella
codespar_kyc
Onboarding
Abre la cuenta de pago del suscriptor por Celcoin: CPF o CNPJ
Pix · boleto
Pagos
codespar_pay paga un Pix o un boleto existente
statement
Historial
codespar_wallet action=statement lista los asientos de cada suscriptor
Ejemplo ilustrativo · datos de demostración

Una organización, muchos suscriptores.

Un ejemplo con datos de demostración: la organización de Fintera, sus suscriptores como consumidores, y los pagos por Pix y boleto que hicieron desde sus propias cuentas en agosto.

  • Cada suscriptor es un consumidor de la organización de Fintera
  • La cuenta del suscriptor se abre con el onboarding de codespar_kyc
  • Cada pago sale de la cuenta del propio suscriptor

Muéstrame los pagos de agosto de los suscriptores de Fintera.

Listando los pagos de agosto entre los consumidores de Fintera.

Pagos de los suscriptores · ejemplo
org_fintera · 2026-08
Ejemplo
Organizaciónorg_fintera
Suscriptores41,200
RielesPix + boleto
Pagado concodespar_pay
payments-2026-08.csv
✓ ejemploorg_fintera
El problema

La conversación es la parte fácil.

Las fintechs de consumo que quieren pago de cuentas terminan rearmando onboarding, cuentas y pagos alrededor de un procesador, fuera de la app que sus suscriptores ya usan.

Mandar al suscriptor a otra app para pagar una cuenta

Los suscriptores pagan dentro de tu app, con CodeSpar por debajo

Construir onboarding y cuentas desde cero

El onboarding de codespar_kyc abre la cuenta de pago de cada suscriptor

Construir una integración de pago por riel

codespar_pay paga un Pix o un boleto existente

Rearmar el historial de cada suscriptor

codespar_wallet action=statement lista los asientos del suscriptor

Cómo lo hace el agente

Tu organización, tus suscriptores como consumidores.

Cada suscriptor es un consumidor de tu organización. codespar_kyc con check_type onboarding (CPF) u onboarding-business (CNPJ) abre la cuenta de pago del suscriptor por Celcoin; codespar_pay paga un Pix o un boleto existente desde ella; codespar_wallet lee el saldo y el extracto. Tu app es la interfaz.

01
Registro
Tu app

En tu app

02
Onboarding
codespar_kyc

Cuenta de pago, CPF o CNPJ

Celcoin
03
Pagar
codespar_pay

Pix o boleto

codespar_pay
04
Extracto
codespar_wallet

Los asientos del suscriptor

Billetera
05
Mostrar
Tu app

El historial en tu app

Arquitectura

Tu organización mantiene a tus suscriptores como consumidores. codespar_kyc abre la cuenta de pago de cada consumidor en Celcoin (onboarding para CPF, onboarding-business para CNPJ), devolviendo una verificación a consultar hasta que la cuenta exista. codespar_pay paga desde esa cuenta: un Pix a una clave o un copia-e-cola, o un boleto existente por su línea, con clave de idempotencia. codespar_wallet lee el saldo y el extracto del consumidor para tu app.

En código

El código, y lo que supone.

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);

Ejemplo con el SDK publicado (@codespar/sdk 0.16.11). Los requisitos están en los comentarios. Compilar no prueba la integración: ejecútalo primero en modo de prueba.

Herramientas destacadas
codespar_kyc

Abre la cuenta de pago del suscriptor por Celcoin: onboarding (CPF) u onboarding-business (CNPJ).

codespar_pay

Paga un Pix o un boleto existente desde la cuenta del suscriptor.

codespar_wallet

Lee el saldo y el extracto del suscriptor.

Ver la referencia de meta-tools
Servidores MCP conectados

Empieza con una clave de prueba.

Las claves de prueba son gratuitas. Abre el sandbox, conecta los proveedores que usa tu proyecto y mira qué herramientas puede llamar antes de construir.

Monetización white-label — CodeSpar | CodeSpar