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).
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.
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
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.
En tu app
codespar_kycCuenta de pago, CPF o CNPJ
Celcoincodespar_payPix o boleto
codespar_paycodespar_walletLos asientos del suscriptor
BilleteraEl historial en tu app
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.
El código, y lo que supone.
// 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.
codespar_kycAbre la cuenta de pago del suscriptor por Celcoin: onboarding (CPF) u onboarding-business (CNPJ).
codespar_payPaga un Pix o un boleto existente desde la cuenta del suscriptor.
codespar_walletLee el saldo y el extracto del suscriptor.
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.