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.
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.
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
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.
codespar_issueUna tarjeta vinculada al mandato
codespar_issueUn comercio cobra la tarjeta
Vigencia, moneda, topes, comercios
Observe: aprobado · enforce: la decisión
Decisión y motivo registrados
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.
El código, y lo que supone.
// 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.
codespar_issueEmite tarjetas virtuales o físicas en Pomelo, las consulta, y las congela, descongela o cancela.
POST /v1/webhooks/pomelo/authorizeEl autorizador que el emisor llama en cada intento; el agente nunca lo llama.
MandateVigencia, moneda, topes por transacción y total, y los comercios permitidos que verifica el autorizador.
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.