SDKs
Clientes oficiales, tipados de punta a punta. Tres paquetes para los tres lugares donde tocás Cauril: tu servidor, el browser del comprador y tus agentes.
Todos los SDKs hablan con la misma API /v1 y comparten sus contratos: montos en unidad mínima, estados normalizados y errores con la misma forma. Elegí el que corresponde a dónde corre tu código.
Cliente de servidor para Node.js. Crea pagos, reembolsos, sesiones de checkout y verifica webhooks, idempotente y con reintentos.
El drop-in de checkout para el browser. Monta el campo del PSP, maneja 3DS y reroutea. Los datos de tarjeta nunca pasan por tu código.
Servidor MCP que expone la API como herramientas que un agente puede llamar, con candados de seguridad.
Cuál uso
| Paquete | Dónde corre | Para qué |
|---|---|---|
@cauril/node | Tu backend (Node ≥ 20) | Operar pagos con tu sk_: crear, listar, reembolsar, verificar webhooks. |
@cauril/checkout-js | El browser del comprador | Cobrar dentro de tu sitio con el drop-in, sin tocar datos de tarjeta (SAQ-A). |
@cauril/mcp | Junto a tu agente (CLI o hosteado) | Que un agente lea y opere pagos como herramientas MCP. |
curl. Si algo no está en el SDK, está en la referencia de API.Versión de la API
La API está versionada por fecha (header Cauril-Version). El SDK de Node fija una versión por default y la podés pinear vos; así una versión nueva de la API no te cambia el comportamiento sin que lo decidas.
Empezá
# servidor
npm install @cauril/node
# browser (o usá el <script> del CDN, ver la página de Checkout.js)
npm install @cauril/checkout-js
# agentes: corré el server con npx, sin instalar
npx -y @cauril/mcp