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.
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.
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
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.
No seu app
codespar_kycConta de pagamento, CPF ou CNPJ
Celcoincodespar_payPix ou boleto
codespar_paycodespar_walletOs lançamentos do assinante
CarteiraO histórico no seu app
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.
O código, e o que ele pressupõe.
// 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.
codespar_kycAbre a conta de pagamento do assinante pela Celcoin: onboarding (CPF) ou onboarding-business (CNPJ).
codespar_payPaga um Pix ou um boleto existente a partir da conta do assinante.
codespar_walletLê o saldo e o extrato do assinante.
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.