Pix recurrente, autorizado una vez por el cliente.
Para un plan mensual pagado en Brasil. codespar_charge crea la recurrencia de Pix Automático en Celcoin de una de tres formas: una solicitud enviada a la app del banco del pagador, sin QR; un QR que lleva solo la recurrencia; o un QR que cobra ahora y la lleva. El cliente la autoriza en la app del banco, y cada ciclo se cobra sobre esa autorización; los resultados vuelven de Celcoin. Requiere Pix Automático activado para tu organización. Cobrar un precio en varias monedas y la gestión de cobranza no se ofrecen; el documento fiscal de cada ciclo va por NFe.io, solo en proyectos live.
Una autorización, luego cada ciclo.
Un ejemplo con datos de demostración: el agente crea una recurrencia mensual de Pix Automático de R$ 52,00; el cliente la autoriza en la app del banco, y el documento fiscal de cada ciclo se emite en un proyecto live.
- El cliente autoriza una vez, en la app del banco
- La recurrencia se crea en Celcoin
- Varias monedas y la gestión de cobranza no se ofrecen
La conversación es la parte fácil.
La facturación recurrente en Brasil era una tarjeta guardada o un boleto cada mes, y cobros fallidos perseguidos a mano.
Pedirle al cliente una tarjeta guardada
Pix Automático: el cliente autoriza la recurrencia en la app del banco
Enviar un boleto cada mes
Cada ciclo se cobra sobre la autorización que dio el cliente
Emitir el documento fiscal a fin de mes
codespar_invoice lo emite por ciclo, en un proyecto live
Empezar toda recurrencia igual
Tres formas de empezar: sin QR, un QR de recurrencia, o un QR que cobra ahora
Pix recurrente, autorizado por el cliente.
codespar_charge crea la recurrencia de Pix Automático en Celcoin en uno de tres recorridos: una solicitud a la app del banco del pagador sin QR, un QR que lleva solo la recurrencia, o un QR que cobra ahora y la lleva. Es la autorización del cliente en la app del banco la que permite cobrar cada ciclo, y Celcoin informa el resultado. Cobrar un precio base en varias monedas y la gestión de cobranza no se ofrecen; el documento fiscal de cada ciclo va por NFe.io, solo en proyectos live.
Precio y ciclo
codespar_chargePix Automático
CelcoinEn la app del banco
Cobrado sobre la autorización
codespar_invoiceNF-e · solo en proyectos live
NFe.iocodespar_charge con un bloque de recurrencia lleva el recorrido a su endpoint en Celcoin: recorrido 1 (sin QR, la solicitud llega a la app del banco del pagador), recorrido 2 (un QR que lleva solo la recurrencia) o recorrido 3 (un QR que cobra ahora y la lleva; pagarlo es la aceptación). La autorización del pagador en su banco y el mandato del agente son objetos distintos. Cada ciclo es una instrucción a Celcoin, y su resultado llega por webhook. La NF-e de cada ciclo es codespar_invoice por NFe.io, en un proyecto live.
El código, y lo que supone.
// 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
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_chargeCrea la recurrencia de Pix Automático en Celcoin, en uno de tres recorridos.
codespar_invoiceEmite el documento fiscal de un ciclo por NFe.io; solo en proyectos live.
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.