Pix recorrente, autorizado uma vez pelo cliente.
Para um plano mensal pago no Brasil. O codespar_charge cria a recorrência de Pix Automático na Celcoin de um de três jeitos: um pedido enviado ao app do banco do pagador, sem QR; um QR que carrega só a recorrência; ou um QR que cobra agora e carrega a recorrência. O cliente autoriza no app do banco, e cada ciclo é cobrado sobre essa autorização; os resultados voltam da Celcoin. Exige o Pix Automático ativado para a sua organização. Cobrar um preço em várias moedas e régua de cobrança não são oferecidos; o documento fiscal de cada ciclo vai pela NFe.io, só em projetos live.
Uma autorização, depois cada ciclo.
Um exemplo com dados de demonstração: o agente cria uma recorrência mensal de Pix Automático de R$ 52,00; o cliente autoriza no app do banco, e o documento fiscal de cada ciclo é emitido num projeto live.
- O cliente autoriza uma vez, no app do banco
- A recorrência é criada na Celcoin
- Várias moedas e régua de cobrança não são oferecidas
A conversa é a parte fácil.
Cobrança recorrente no Brasil era um cartão salvo ou um boleto todo mês, e cobranças falhadas perseguidas à mão.
Pedir ao cliente um cartão salvo
Pix Automático: o cliente autoriza a recorrência no app do banco
Mandar um boleto todo mês
Cada ciclo é cobrado sobre a autorização que o cliente deu
Emitir o documento fiscal no fim do mês
O codespar_invoice emite por ciclo, num projeto live
Começar toda recorrência do mesmo jeito
Três jeitos de começar: sem QR, um QR de recorrência, ou um QR que cobra agora
Pix recorrente, autorizado pelo cliente.
O codespar_charge cria a recorrência de Pix Automático na Celcoin numa de três jornadas: um pedido ao app do banco do pagador sem QR, um QR que carrega só a recorrência, ou um QR que cobra agora e a carrega. É a autorização do cliente no app do banco que permite cobrar cada ciclo, e a Celcoin informa o resultado. Cobrar um preço base em várias moedas e régua de cobrança não são oferecidos; o documento fiscal de cada ciclo vai pela NFe.io, só em projetos live.
Preço e ciclo
codespar_chargePix Automático
CelcoinNo app do banco
Cobrado sobre a autorização
codespar_invoiceNF-e · só em projetos live
NFe.ioO codespar_charge com um bloco de recorrência leva a jornada ao seu endpoint na Celcoin: jornada 1 (sem QR, o pedido chega ao app do banco do pagador), jornada 2 (um QR que carrega só a recorrência) ou jornada 3 (um QR que cobra agora e a carrega; pagar é o aceite). A autorização do pagador no banco e o mandato do agente são objetos separados. Cada ciclo é uma instrução à Celcoin, e o resultado chega por webhook. A NF-e de cada ciclo é o codespar_invoice pela NFe.io, num projeto live.
O código, e o que ele pressupõe.
// Prerequisites: CODESPAR_API_KEY set to a test key (csk_test_…), a Celcoin // connection, Pix Automático activated for your organization, and a mandate of // the receiving consumer to create the recurrence under. import { CodeSpar } from "@codespar/sdk"; const session = await new CodeSpar().create("user_0000", { preset: "brazilian" }); // the agent fills codespar_charge with the recurrence block const run = await session.send( "Create a monthly Pix Automático recurrence of R$ 52.00 for Ana Souza (CPF 123.456.789-09), plan Pro, with a QR that charges the first month now.", ); const created = run.tool_calls.find((c) => c.tool_name === "codespar_charge"); console.log(created?.status, created?.output); // the QR the customer pays and authorizes in the bank app
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_chargeCria a recorrência de Pix Automático na Celcoin, numa de três jornadas.
codespar_invoiceEmite o documento fiscal de um ciclo pela NFe.io; só em projetos live.
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.