Skip to main content
Todos los casos de uso
Tesorería / TarjetaOperations

Una tarjeta vinculada al mandato, con cada intento verificado.

Para las compras puntuales que terminan en la tarjeta personal de alguien. codespar_issue emite la tarjeta por Pomelo; la conexión de Pomelo apunta al host de staging de Pomelo. En cada intento de cobro Pomelo llama al autorizador de CodeSpar, que verifica el mandato firmado del agente: vigencia, moneda, tope por transacción, tope total y comercios permitidos. En modo observe el autorizador registra su decisión y responde aprobado, así que un cobro que el mandato rechazaría pasa igual y queda registrado como excepción. En modo enforce la decisión es la respuesta.

AntesUna tarjeta corporativa compartida, revisada semanas después
DespuésUna tarjeta por mandato, cada intento decidido y registrado
5
verificaciones en cada intento de cobro
Pruébalo en el Sandbox
Pomelo
Emisor
codespar_issue emite y controla la tarjeta; la conexión apunta al host de staging de Pomelo
5
Verificaciones por intento
Vigencia, moneda, tope por transacción, tope total, comercios permitidos
observe · enforce
Dos modos
Observe registra la decisión y aprueba; enforce la hace vinculante
≠
Divergencia registrada
En observe, un cobro que el mandato rechazaría pasa y queda registrado como excepción
Ejemplo ilustrativo · datos de demostración

Un intento, una decisión registrada.

Un ejemplo con datos de demostración: el agente renueva una suscripción con su tarjeta. Pomelo consulta al autorizador, que verifica el mandato y registra su decisión. En modo observe el emisor recibe aprobado sea cual sea la decisión; en modo enforce un rechazo deniega el cobro.

  • El emisor llama al autorizador en cada intento; el agente no
  • La decisión verifica el mandato: vigencia, moneda, topes, comercios permitidos
  • El modo observe aprueba y registra; solo el modo enforce deniega

Renovar la suscripción de analítica con la tarjeta de operaciones.

Cobrando USD 340.00 a SubscriptionCo con la tarjeta vinculada al mandato de operaciones.

Intento de autorización de tarjeta · ejemplo
auth_demo · SubscriptionCo
Decisión registrada · ejemplo
ComercioSubscriptionCo · MCC 5817
MontoUSD 340.00
Mandatomnd_demo · USD 2000.00
Decisiónwithin_mandate
Respuesta al emisorAPPROVED
authorization-trace.json
✓ decisión registrada · ejemploauth_demo
El problema

La conversación es la parte fácil.

La gobernanza de una tarjeta corporativa hoy es un número compartido, una lista de quién puede usarla y un estado de cuenta revisado semanas después. Un agente que compra de forma puntual lo empeora: nadie ve un cobro equivocado antes de que pase.

Un número de tarjeta compartido para quien necesite comprar

Una tarjeta vinculada al mandato firmado del propio agente

Aprobaciones después de que llega el estado de cuenta

Cada intento se decide contra el mandato en el momento

Ningún registro de por qué se permitió un cobro

Cada decisión queda registrada con su motivo

Bloquear una tarjeta exige llamar al banco

codespar_issue congela, descongela o cancela la tarjeta en el emisor

Cómo lo hace el agente

Un mandato en la tarjeta, una decisión en cada intento.

codespar_issue emite y controla la tarjeta en Pomelo (card-virtual, card-physical, card-control, card-get). Pomelo llama al autorizador de CodeSpar en cada intento; el autorizador busca el mandato de la tarjeta, verifica vigencia, moneda, tope por transacción, tope total y comercios permitidos, y registra la decisión. Si esa decisión vale depende del modo: en observe se registra y el emisor recibe aprobado; en enforce es la respuesta.

01
Emitir
codespar_issue

Una tarjeta vinculada al mandato

codespar_issue
02
Intento
Pomelo

Un comercio cobra la tarjeta

03
Verificar
Autorizador

Vigencia, moneda, topes, comercios

04
Responder
Autorizador

Observe: aprobado · enforce: la decisión

05
Registrar
Registro de auditoría

Decisión y motivo registrados

Arquitectura

Pomelo firma cada solicitud de autorización a POST /v1/webhooks/pomelo/authorize. La ruta verifica la firma; el núcleo compartido busca el mandato de la tarjeta, decide (vigencia, moneda, tope por transacción, tope total, comercios permitidos por MCC o id de comercio), persiste la decisión y la sella en el registro de auditoría. En modo observe el emisor recibe aprobado y una decisión que el mandato rechazaría queda registrada como excepción; en modo enforce la decisión es la respuesta. Una pausa de la organización se envía como rechazo en cualquier modo, cuando el emisor espera la respuesta.

En código

El código, y lo que supone.

governed-agent-card.ts
// Prerequisites: CODESPAR_API_KEY set to a test key (csk_test_…), a Pomelo
// connection (it points at Pomelo's staging host) and a card already issued to
// the agent (card_id). The authorizer is not called from here: Pomelo calls it
// on every charge attempt.
import { CodeSpar } from "@codespar/sdk";

const session = await new CodeSpar().create("user_0000", { preset: "brazilian" });

// read the card at the issuer
const card = await session.execute("codespar_issue", { action: "card-get", card_id: "crd_demo" });
console.log(card.data);

// freeze it at the issuer, for instance when the agent is paused
await session.execute("codespar_issue", { action: "card-control", card_id: "crd_demo", control: "freeze", reason: "agent paused" });

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_issue

Emite tarjetas virtuales o físicas en Pomelo, las consulta, y las congela, descongela o cancela.

POST /v1/webhooks/pomelo/authorize

El autorizador que el emisor llama en cada intento; el agente nunca lo llama.

Mandate

Vigencia, moneda, topes por transacción y total, y los comercios permitidos que verifica el autorizador.

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.

Tarjeta gobernada del agente — CodeSpar | CodeSpar