Índice de documentación

CONTRATO VERIFICABLE

Integrá sobre cosas
que existen.

Esta documentación se construye desde el mismo OpenAPI que publica Cimbra y describe únicamente el sandbox desplegado: autenticación, recursos, SDK, errores, eventos y límites operativos reales.

OpenAPI 3.1Contrato descargable

194Operaciones documentadas

37Scopes S2S canónicos

152Tipos de evento emitidos

Entorno sandbox, contrato de producción

Customers, KYC/KYB, cuentas, wallets, book transfers, estados de cuenta, tarjetas, beneficiarios, lotes de payouts, servicios, obligaciones, recargas, mandatos, movimientos, ledger, riesgo, conciliación, disputas, operaciones, aprobaciones, soporte, organización, topología de servicios y webhooks se persisten sobre el núcleo real. El host activo es sandbox, como sandbox.bind.com.ar, sandbox.pismolabs.io y sandbox.api.pomelo.la. Live exige hostname de producción, producto en Go Live, rieles oficiales BCRA/Coelsa/sponsor en live y un adaptador Cimbra registrado.

ENTORNOS

Un contrato. Un entorno activo. Live fail-closed.

ENTORNO ACTIVO · SANDBOX

https://cimbra-rose.vercel.app

Misma API, ledger y eventos que producción. Las claves usan cim_sk_test_. No mueve fondos de riel.

Consultar healthcheck JSON ↗

LIVE

Hostname no provisionado

Pismo entrega el hostname de producción en el onboarding comercial. BIND APIBANK no publica la URL productiva. Pomelo usa api.pomelo.la después de homologar. Hasta entonces no hay cim_sk_live_.

Consultar GET /api/v1/live-readiness

OpenAPI YAMLDisponibleDescargar

SDK TypeScript 0.1.0Preview verificableDescargar

Postman CollectionNo publicadaBacklog

SDKs Java / Python / GoNo publicadosBacklog

QUICKSTART

Primer request, sin pasos inventados.

Una API key sólo puede ser creada por Owner o Admin desde la sección Developers de la consola. El secreto se muestra una vez y Cimbra conserva únicamente su hash.

Entrá a la consola

Iniciá sesión, abrí Developers y generá una clave con customers:write.

Ingresar ↗

Guardá el secreto en backend

Usá una variable de entorno. Nunca expongas la clave en navegador, app móvil, repositorio o logs.

CIMBRA_API_KEY=cim_sk_test_••••

Creá un customer

Mandá una clave de idempotencia estable por operación lógica. El identificador y el tenant se resuelven en servidor.

CURL · EJECUTABLE

curl --request POST \
  --url https://cimbra-rose.vercel.app/api/v1/customers \
  --header "Authorization: Bearer $CIMBRA_API_KEY" \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: customer-quickstart-001" \
  --header "X-Request-Id: req_quickstart_001" \
  --data '{
    "type": "business",
    "name": "Comercio del Sur",
    "country": "AR",
    "taxId": "30712345678"
  }'

Respuesta real: HTTP 201 en la primera creación y HTTP 200 con Idempotent-Replayed: true al repetir exactamente el request.

JSON · 201 CREATED

{
  "ok": true,
  "customer": {
    "id": "<uuid>",
    "type": "business",
    "name": "Comercio del Sur",
    "country": "AR",
    "taxIdLast4": "5678",
    "status": "active",
    "createdAt": "<ISO-8601>"
  },
  "replayed": false
}

AUTENTICACIÓN Y AUTORIZACIÓN

Dos identidades, controles distintos.

HUMANOS

Sesión first-party

Cookie opaca, hasheada en servidor. RBAC decide qué puede ver y ejecutar cada rol; las mutaciones validan origen y las decisiones maker/checker requieren sesión humana.

__Host-cimbra_session

MACHINE-TO-MACHINE

API key con scopes

Bearer propio del tenant, revocable, con vencimiento y rate limit. No puede aprobar, rechazar ni cancelar solicitudes maker/checker.

Authorization: Bearer cim_sk_test_…

OwnerGobierno total

Gobierna el tenant, la seguridad, las políticas, los accesos y toda la operación.

Puede administrar API keys

AdminAdministración delegada

Configura la organización y gestiona operadores y viewers sin desplazar al owner.

Puede administrar API keys

OperatorOperación controlada

Ejecuta y resuelve flujos operativos sin administrar credenciales ni privilegios.

No administra credenciales

ViewerSólo lectura

Consulta operación, evidencia y auditoría sin acciones mutantes.

No administra credenciales

customers:readcustomers:writeaccounts:readaccounts:writecards:readcards:writetransfers:readtransfers:writepayments:readpayments:writepayouts:readpayouts:writebillers:readbillers:writewallets:readwallets:writerisk:readrisk:writedisputes:readdisputes:writereconciliation:readreconciliation:writesettlements:readsettlements:writeapprovals:readoperations:readoperations:writesupport:readsupport:writeorganization:readorganization:writeplatform:readledger:readevents:readcompliance:readcompliance:writewebhooks:manage

401 ≠ 403

401 significa que la identidad no fue autenticada. 403 significa que existe una sesión o API key válida, pero su rol o scope no permite esa operación.

CONTRATO HTTP

Idempotencia, trazabilidad y retry seguro.

Idempotency-Key

Obligatoria cuando el endpoint la declara: altas y movimientos reintentables. Admite 8–100 caracteres de A-Z a-z 0-9 . _ : -.

X-Request-Id

Podés enviarlo; si falta, Cimbra lo genera. Se devuelve en toda respuesta y el SDK lo conserva durante reintentos.

Replays

Misma clave y mismo payload: respuesta original y header Idempotent-Replayed: true. Payload distinto: HTTP 409.

Cimbra-Should-Retry

La API marca explícitamente si un error puede reintentarse. El SDK aplica backoff sólo en requests seguros.

Límite actual

Configuración de webhooks, carga de evidencia y desactivación de reglas todavía no ofrecen replay idempotente; el SDK no las reintenta. La referencia de cada operación indica si acepta Idempotency-Key.

MODELO DE DATOS

Cursores estables y montos exactos.

Paginación

Customers, accounts, account statements, cards, transfers, book transfers y events aceptan limit entre 1 y 100. Reutilizá nextCursor mientras hasMore sea true.

{
  "data": [/* recursos */],
  "hasMore": true,
  "nextCursor": "<base64url_opaco>"
}

Dinero

En requests, enviá montos como string decimal en unidad mayor. En respuestas financieras, amountMinor conserva la representación contable exacta como string.

{
  "amount": "1250.50",
  "amountMinor": "125050",
  "currency": "ARS"
}

Monedas modeladas: ARS, USD, MXN, COP, BRL, CLP y PEN. Esto no implica disponibilidad de rieles reales en esos países.

ERRORES Y LÍMITES

Fallos estructurados y accionables.

JSON · ERROR EN API V1

{
  "error": {
    "type": "cimbra_api_error",
    "code": "insufficient_scope",
    "message": "La API key no incluye el scope customers:write.",
    "requestId": "req_<id>"
  }
}

400invalid_requestPayload, parámetros o Idempotency-Key inválidos.

401authentication_required / invalid_api_keyFalta la identidad, o la API key es inválida, fue revocada o venció.

403insufficient_scope / insufficient_roleLa identidad existe, pero no tiene el scope o rol requerido.

404not_foundEl recurso no existe dentro del tenant autenticado.

409conflict / idempotency_mismatchConflicto de estado o clave reutilizada con otro payload.

422unprocessable_entityLa solicitud es válida, pero saldo, riesgo o estado impiden ejecutarla.

429rate_limit_exceededSe agotó la ventana de la API key; respetar Retry-After.

5xxinternal_errorError transitorio; reintentar sólo cuando Cimbra-Should-Retry sea true.

Rate limit efectivo

Las API keys nuevas tienen hoy un límite de 300 requests/minuto. Después de autorizar la API key, las respuestas incluyen X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset. Un 429 agrega Retry-After: 60.

SDK TYPESCRIPT

Un paquete real, descargable y con checksum.

PREVIEW OFICIAL

@cimbra/sdk · v0.1.0

Node.js 20+. ESM, declaraciones TypeScript, source maps, timeouts, errores tipados, cursores, reintentos seguros y verificación de webhooks.

Descargar .tgz ↗SHA-256 ↗43.2 kB · licencia propietaria

Distribución honesta

El SDK todavía no está en npm. El comando instala el artefacto servido por Cimbra; el checksum publicado permite verificar exactamente qué paquete se recibió.

TERMINAL

npm install https://cimbra-rose.vercel.app/sdk/cimbra-sdk-0.1.0.tgz

SHA-256a94b89beca3ce8a03823a212cf1cbf53f371c779c51ca1f134a4be7f12b5d78d

TYPESCRIPT

import { Cimbra } from '@cimbra/sdk';

const cimbra = new Cimbra({
  apiKey: process.env.CIMBRA_API_KEY!,
  baseUrl: 'https://cimbra-rose.vercel.app',
});

const result = await cimbra.customers.create({
  type: 'business',
  name: 'Comercio del Sur',
  country: 'AR',
  taxId: '30712345678',
});

console.log(result.data.customer.id, result.requestId);

BILLER INFRASTRUCTURE

Servicios propios, no un adaptador a competidores.

El originador directo registra su catálogo y emite obligaciones dentro del tenant. Cimbra protege la referencia del suscriptor, ejecuta el pago o la recarga contra el mismo ledger y riesgo del core, y conserva todo el lifecycle para conciliación, reversa y eventos.

Contrato S2S

billers:read/write gobierna catálogo y deuda; payments:read/write gobierna órdenes y mandatos.

Dinero consistente

Una orden comparte ledger de doble partida, límites, evaluación de riesgo y holds. La reversa crea postings compensatorios.

Recurrencia controlada

Mandatos semanales o mensuales conservan consentimiento, límite por ejecución, agenda, reintentos y pausa/cancelación.

Límite real

El sandbox no consulta una deuda externa ni afirma cobertura. Producción exige contrato directo, consentimiento exigible, riel oficial y certificación por país.

TYPESCRIPT · SDK REAL

const biller = await cimbra.billers.create({
  code: 'ENERGIA_AR',
  name: 'Energía Regional',
  country: 'AR',
  category: 'utilities',
  serviceType: 'bill_payment',
  currency: 'ARS',
  amountMode: 'exact',
  contractReference: 'DIRECT-2026-001',
});

const debt = await cimbra.billers.createObligation(biller.data.biller.id, {
  externalReference: 'INV-2026-0001',
  subscriberReference: 'CLIENTE-00123456',
  amount: '18250.00',
  dueAt: '2026-09-10T21:00:00.000Z',
  description: 'Servicio agosto 2026',
});

const payment = await cimbra.billPayments.create({
  accountId: '<account_uuid>',
  billerId: biller.data.biller.id,
  obligationId: debt.data.obligation.id,
});

console.log(payment.data.order.status);

CORE BANKING

Un movimiento, dos postings, historial completo.

Un book transfer mueve saldo entre dos cuentas activas del mismo tenant y moneda. Cimbra bloquea ambos recursos, descuenta reservas del saldo disponible y crea el débito y crédito dentro de la misma transacción SQL.

Atomicidad

La operación nunca deja un solo leg: el journal exige débitos iguales a créditos y el trigger protege tenant y moneda.

Riesgo y doble control

Una decisión review reserva sólo el origen. La política transfer.create puede exigir un checker distinto con MFA antes de crear el movimiento.

Estados de cuenta

accounts:read devuelve postings paginados, saldo de apertura y cierre para un período máximo de 366 días.

Reversas

Una reversa crea postings opuestos y queda enlazada; jamás edita ni borra el asiento original.

Rail interno, no transferencia bancaria

El contrato está operativo dentro del sandbox persistente. Pix, SPEI, CBU/CVU u otros rieles externos requieren una conexión directa homologada, licencia o sponsor y conciliación oficial por país.

TYPESCRIPT · SDK REAL

const movement = await cimbra.bookTransfers.create({
  externalReference: 'BT-2026-0001',
  sourceAccountId: '<source_account_uuid>',
  destinationAccountId: '<destination_account_uuid>',
  description: 'Distribución de saldo marketplace',
  amount: '1250.00',
  currency: 'ARS',
});

if (!movement.data.requiresApproval) {
  const statement = await cimbra.accounts.statement(movement.data.transfer.sourceAccountId, {
    from: '2026-08-01T00:00:00.000Z',
    to: '2026-09-01T00:00:00.000Z',
    limit: 50,
  });
  console.log(statement.data.period.closingBalance, statement.data.data);
}

EMBEDDED FINANCE

Una wallet, bolsillos reales, sin ledger paralelo.

Un programa tenant configura marca y kinds de bolsillo. Abrir una wallet crea cuentas de producto; mover saldo entre pockets ejecuta un book transfer con riesgo, holds y maker/checker.

Programas

Owner/Admin define nombre visible, moneda, bolsillos available, pending o rewards y URLs de soporte. No se publica una app de consumidor.

Pockets

Cada bolsillo es una cuenta de producto. El saldo se deriva de postings; freeze y close inactivan esas cuentas.

Movimientos

wallets:write resuelve pocket IDs y reutiliza el rail interno. Una wallet inactiva rechaza el movimiento con 409.

Límite real

El sandbox no custodia fondos. Una wallet productiva exige marco PSP o entidad habilitada, safeguarding y riel de fondeo por país.

TYPESCRIPT · SDK REAL

const program = await cimbra.walletPrograms.create({
  name: 'Wallet marketplace ARS',
  displayName: 'Billetera Comercio Sur',
  defaultCurrency: 'ARS',
  pocketKinds: ['available', 'pending'],
});

const wallet = await cimbra.wallets.create({
  programId: program.data.program.id,
  customerId: '<customer_uuid>',
  externalReference: 'WALLET-001',
});

const movement = await cimbra.wallets.transfer(wallet.data.wallet.id, {
  externalReference: 'WP-001',
  sourcePocketId: wallet.data.pockets[0].id,
  destinationPocketId: wallet.data.pockets[1].id,
  description: 'Reserva operativa',
  amount: '25.00',
  currency: 'ARS',
});

ARGENTINA · SANDBOX

CVU propio, alias de tenant, sin fingir Coelsa.

Cimbra emite CVU con prefijo 000 y código PSP 9999, asigna o cambia el alias del tenant sobre un CVU existente, confirma titular y liquida el crédito interno sobre el ledger. Un CBU externo sale a settlement. El débito y el QR sólo operan entre cuentas del tenant.

Instrumentos

Un CVU por cuenta ARS argentina. El alias se asigna o cambia sobre ese CVU; es único en el tenant y un cambio real queda bloqueado 24 horas. Eliminar el CVU no borra la cuenta ni el saldo. No se emite CBU porque Cimbra no es banco.

Confirmación

El crédito exige confirmHolder, nombre y últimos cuatro del CUIT. Un mismatch interno responde 422 holder_mismatch.

Débito y QR

El débito externo responde external_debit_not_supported. El dinámico cimbra:qr:v1 vence y se consume; el estático cimbra:qr:static:v1 es reutilizable. Una orden de venta fija el monto cerrado sobre ese QR. El QR de deuda cimbra:qr:debt:v1 es un recurso primario de un solo pago.

Límite real

Transferencias 3.0, DEBIN y directorio nacional entran con membresía o sponsor directo. BIND y el resto siguen como benchmarks, no conectores.

TYPESCRIPT · SDK REAL

const issued = await cimbra.railInstruments.issue({
  accountId: '<account_uuid>',
});
await cimbra.railInstruments.assignAlias(issued.data.instruments[0].id, {
  alias: 'COMERCIO.SUR',
});
const preview = await cimbra.railDirectory.lookup(issued.data.instruments[0].value);
const credit = await cimbra.instantTransfers.create({
  externalReference: 'IP-001',
  accountId: '<source_account_uuid>',
  destination: issued.data.instruments[0].value,
  description: 'Cobro inmediato',
  amount: '1500.00',
  currency: 'ARS',
  confirmHolder: true,
  holderName: preview.data.holderName!,
  taxIdLast4: preview.data.taxIdLast4!,
});
const staticQr = await cimbra.paymentQrs.create({
  accountId: '<account_uuid>',
  description: 'Mostrador',
  kind: 'static',
});
await cimbra.qrSaleOrders.create({
  paymentQrId: staticQr.data.qr.id,
  externalReference: 'OV-001',
  description: 'Ticket mostrador',
  amount: '1500.00',
});
const debt = await cimbra.qrDebts.create({
  accountId: '<account_uuid>',
  externalReference: 'DEUDA-001',
  description: 'Cuota única',
  amount: '2500.00',
});

ARGENTINA · COBRANZAS

Un link de cobro y un punto de recaudación, sin fingir adquirencia de red.

El comercio emite un link contra una cuenta ARS argentina, opcionalmente asociado a una deuda QR abierta o a un punto de recaudación. El pagador liquida desde otra cuenta Cimbra, con inbound sandbox, pagando el QR de la deuda o acreditando el CVU del till. La devolución usa postings compensatorios: total o parcial. Un link CVU puede reabrirse si el neto queda por debajo del monto; no se reabre la deuda QR.

Link

Monto, vencimiento y payload cimbra:link:v1. Puede llevar qrDebtId, collectionTillId e items de detalle. GET embebe credits, refunds, partiallyCollected y partiallyRefunded. Owner/Admin/Operator crean y devuelven; Viewer sólo consulta.

Punto de recaudación

collection_tills emite un CVU 000+9999 del till. Transferencias internas e inbound quedan con collectionTillId. No es caja BIND.

Scopes

payments:read/write protege S2S. El cobro entra al motor de riesgo y puede quedar en hold.

Límite real

No hay checkout PCI, marcas, sucursales ni liquidación a un adquirente. El cobro por CVU admite parciales, overpay y devolución parcial; QR e internal siguen monto cerrado. Un inbound suelto al till no imputa el link. El CVU del till no viaja por Coelsa. BIND y el resto siguen como benchmarks, no conectores.

TYPESCRIPT · SDK REAL

const till = await cimbra.collectionTills.create({
  accountId: '<merchant_account_uuid>',
  externalReference: 'TILL-001',
  name: 'Mostrador Sur',
  issueStaticQr: true,
  closedAmountOnly: true,
});
await cimbra.qrSaleOrders.create({
  paymentQrId: till.data.till.paymentQrId!,
  externalReference: 'OV-TILL-001',
  description: 'Ticket mostrador',
  amount: '1500.00',
});
await cimbra.collectionTills.inbound(till.data.till.id, {
  externalReference: 'INB-001',
  description: 'Transferencia recibida',
  amount: '1500.00',
});
const link = await cimbra.paymentLinks.create({
  accountId: '<merchant_account_uuid>',
  externalReference: 'FAC-001',
  description: 'Honorarios agosto',
  amount: '18500.00',
  currency: 'ARS',
  methods: ['cimbra_qr', 'cimbra_cvu'],
  qrDebtId: '<qr_debt_uuid>',
  collectionTillId: till.data.till.id,
  items: [{ description: 'Honorarios agosto', amount: '18500.00', quantity: 1 }],
});
await cimbra.paymentLinks.pay(link.data.link.id, {
  method: 'cimbra_qr',
  payerAccountId: '<payer_account_uuid>',
});
await cimbra.paymentLinks.refund(link.data.link.id, { amount: '3.00' });

PAYOUT INFRASTRUCTURE

De un beneficiario protegido a un resultado conciliable.

Cimbra acepta un lote como borrador inmutable, lo somete a doble control si el tenant lo exige y procesa cada ítem por separado. Un fallo funcional no duplica ni bloquea los payouts ya resueltos; el estado y el archivo se derivan de datos persistidos.

Scheduling del entorno actual

Los lotes inmediatos se despachan al responder. En el deployment gratuito actual, el recovery sweep de lotes programados corre diariamente y no promete precisión horaria; la infraestructura AWS preparada usa EventBridge cada minuto, pero no se activa hasta autorizar presupuesto.

Scopes y roles

payouts:read/write protege S2S. Owner/Admin administra destinos, Operator puede crear/enviar lotes y Viewer sólo consulta.

Privacidad

El destino completo es write-only: se normaliza, se convierte en digest tenant-scoped y sólo vuelven tipo y últimos cuatro.

Ejecución durable

De 1 a 100 ítems, programación y deadline, lease recuperable, tres intentos transitorios, riesgo, saldo, holds y ledger por ítem.

Límite real

El sandbox contabiliza contra settlement interno. Producción requiere riel bancario/cámara directo, reason codes, returns, conciliación y homologación.

TYPESCRIPT · SDK REAL

const beneficiary = await cimbra.payoutBeneficiaries.create({
  externalReference: 'PROVIDER-001',
  name: 'Proveedor Regional',
  entityType: 'business',
  country: 'AR',
  currency: 'ARS',
  destinationType: 'alias',
  destination: 'proveedor.cimbra',
});

const batch = await cimbra.payoutBatches.create({
  sourceAccountId: '<account_uuid>',
  externalReference: 'PAYOUT-2026-09-001',
  description: 'Liquidación de proveedores',
  currency: 'ARS',
  processBefore: '2026-09-01T21:00:00.000Z',
  items: [{
    externalReference: 'ITEM-001',
    beneficiaryId: beneficiary.data.beneficiary.id,
    amount: '125000.00',
    description: 'Liquidación agosto',
  }],
});

const submitted = await cimbra.payoutBatches.submit(batch.data.batch.id);
const csv = await cimbra.payoutBatches.resultCsv(batch.data.batch.id);
console.log(submitted.data.batch.status, csv.data);

CUSTOMER DUE DILIGENCE

KYC/KYB orquestado, con decisión humana independiente.

El tipo del customer determina KYC o KYB. Cada caso congela jurisdicción, versión de política y checks requeridos; partes, evidencia y observaciones se conservan append-only y el vencimiento es terminal.

Preparación S2S

compliance:read/write permite crear, completar, consultar, enviar o cancelar un expediente desde backend.

KYB completo

Exige representante legal y al menos un beneficiario final; la participación declarada total no puede superar 100%.

Maker / checker

Aprobar o rechazar es session-only: otro Owner/Admin con MFA decide y una API key recibe 403 session_required.

Límite real

El sandbox no afirma biometría, prueba de vida, listas o registros oficiales sin una fuente directa certificada.

TYPESCRIPT · SDK REAL

const opened = await cimbra.dueDiligence.create({
  customerId: '<business_customer_uuid>',
  expiresInDays: 90,
});

await cimbra.dueDiligence.addParty(opened.data.case.id, {
  role: 'beneficial_owner',
  name: 'Ana Sur',
  taxId: '20123456789',
  ownershipPercentage: 25,
});

await cimbra.dueDiligence.recordCheck(opened.data.case.id, {
  checkType: 'sanctions',
  source: 'official_registry',
  status: 'passed',
  resultCode: 'no_match',
  note: 'Consulta directa documentada.',
});

// Completá todos los checks/partes exigidos antes de enviar.
await cimbra.dueDiligence.submit(opened.data.case.id);

RISK STEP-UP

Autenticación reforzada, sin confundirla con una red.

Una evaluación review puede abrir un challenge OTP. Cimbra genera la credencial, conserva hash y ciphertext, limita intentos, expira el challenge y registra cada intento sin guardar el código en claro. El integrador recibe la credencial sólo en el create/replay pendiente y la entrega desde backend por su canal aprobado.

Lifecycle

pending → verified | failed | expired. Un challenge terminal no se reabre.

Interconexión

La verificación queda vinculada a la evaluación y al caso; no resuelve fondos ni evita maker/checker.

SLO medido

El estado de riesgo publica muestras, p50, p95, p99 y porcentaje ≤ 250 ms de decisiones nuevas.

Límite real

No implementa EMV 3DS, ACS, liability shift, SMS, push ni biometría. Esas capas requieren canal, riel y certificación directos.

TYPESCRIPT · SDK REAL

const evaluationId = '<evaluation_in_review_uuid>';
const created = await cimbra.risk.createStepUpChallenge(evaluationId, {
  expiresInSeconds: 300,
  maxAttempts: 5,
});

// Entregá esta credencial desde tu backend por un canal aprobado.
const credential = created.data.credential!;

const result = await cimbra.risk.verifyStepUpChallenge(
  evaluationId,
  created.data.challenge.id,
  { credential },
);

console.log(result.data.verified, result.data.challenge.status);

WEBHOOKS

Outbox durable, firma y replay operativo.

Entrega

POST HTTPS público, puerto 443, timeout de 4 segundos y éxito ante cualquier respuesta 2xx. Redirecciones no se siguen.

Firma

HMAC-SHA256 sobre timestamp.raw_body. Ventana predeterminada del SDK: 5 minutos y comparación en tiempo constante.

Reintentos

Hasta 7 intentos totales. Backoff después de cada fallo: 1m, 5m, 30m, 2h, 6h y 24h.

Operación

Estados, status HTTP, error e historial de intentos quedan persistidos. Owner/Admin puede reencolar una entrega.

JSON · EVENTO REAL

{
  "id": "<event_uuid>",
  "type": "transfer.created",
  "created_at": "<ISO-8601>",
  "data": {
    "resource_type": "transaction",
    "resource_id": "<transaction_uuid>"
  }
}

TYPESCRIPT · VERIFICACIÓN

import { constructWebhookEvent } from '@cimbra/sdk';

const rawBody = await request.text();
const event = await constructWebhookEvent({
  payload: rawBody,
  signature: request.headers.get('cimbra-signature')!,
  timestamp: request.headers.get('cimbra-timestamp'),
  secret: process.env.CIMBRA_WEBHOOK_SECRET!,
});

console.log(event.id, event.type, event.created_at);
return new Response(null, { status: 204 });

152 tipos de evento implementados Ver catálogo

customer.createdaccount.createdcard.createdcard.program_createdcard.activatedcard.frozencard.unfrozencard.terminatedcard.controls_updatedtransfer.createdtransfer.reversedbook_transfer.createdbook_transfer.settledbook_transfer.cancelledbook_transfer.reversedwallet.program_createdwallet.createdwallet.frozenwallet.unfrozenwallet.closedwallet.pocket_transfer_createdrail.instrument_issuedrail.alias_assignedrail.instrument_revokedinstant.transfer_createdinstant.transfer_returnedinstant.transfer_settledinstant.transfer_cancelledinstant.debit_requestedinstant.debit_acceptedinstant.debit_rejectedinstant.qr_createdinstant.qr_paidinstant.qr_cancelledinstant.sale_order_createdinstant.sale_order_paidinstant.sale_order_cancelledinstant.sale_order_supersededinstant.debt_createdinstant.debt_paidinstant.debt_cancelledcollection.link_createdcollection.link_cancelledcollection.link_paidcollection.link_creditedcollection.link_refundedcollection.till_createdcollection.till_alias_assignedcollection.till_qr_issuedcollection.till_creditedcollection.till_disabledecheq.issuedecheq.acceptedecheq.endorsedecheq.depositedecheq.cancelledecheq.returnedecheq.rejectedhold.capturedhold.releasedpayment.createdpayment.reversedpayout.beneficiary_createdpayout.beneficiary_activatedpayout.beneficiary_suspendedpayout.batch_createdpayout.batch_submittedpayout.batch_approval_pendingpayout.batch_approvedpayout.batch_scheduledpayout.batch_processingpayout.batch_requires_attentionpayout.batch_completedpayout.batch_partially_failedpayout.batch_failedpayout.batch_cancelledpayout.item_settledpayout.item_reviewpayout.item_failedbiller.createdbiller.activatedbiller.suspendedbiller.obligation_createdbiller.obligation_reopenedbill_payment.createdbill_payment.declinedbill_payment.reviewbill_payment.settledbill_payment.cancelledbill_payment.reversedbill_payment.order_reversedrecurring_mandate.createdrecurring_mandate.pausedrecurring_mandate.resumedrecurring_mandate.cancelledrecurring_mandate.execution_completedrecurring_mandate.execution_skippedrecurring_mandate.execution_failedrisk.rule_createdrisk.rule_version_createdrisk.rule_promotedrisk.rule_disabledrisk.simulation_completedrisk.list_entry_createdrisk.list_entry_disabledrisk.outcome_reportedrisk.case_createdrisk.case_resolvedrisk.step_up_challenge_createdrisk.step_up_challenge_verifiedrisk.step_up_challenge_failedrisk.step_up_challenge_expiredrisk.step_up_attempt_faileddispute.createddispute.start_reviewdispute.mark_network_readydispute.resolve_wondispute.resolve_lostdispute.rejectdispute.cancelreconciliation.run_createdreconciliation.exception_resolvedoperations.work_item_updatedoperations.note_addedoperations.evidence_linkedsettlement.cycle_createdsettlement.cycle_settledapproval.policy_updatedapproval.request_createdapproval.request_executedapproval.request_rejectedapproval.request_cancelledapproval.request_expiredapproval.request_failedorganization.updatedorganization.invitation_createdorganization.invitation_acceptedorganization.invitation_revokedorganization.member_role_updatedorganization.member_removedcompliance.document_uploadeddue_diligence.createddue_diligence.party_addeddue_diligence.check_recordeddue_diligence.submitteddue_diligence.approveddue_diligence.rejecteddue_diligence.cancelleddue_diligence.expiredsupport.case_openedsupport.message_addedsupport.status_updated

API REFERENCE

Todo el contrato publicado.

La lista siguiente se genera desde public/openapi.yaml; no existe un inventario paralelo escrito a mano. Cada operación muestra autenticación, scope, Content-Type, parámetros y respuestas declaradas.

Buscar en el contrato194 de 194 operaciones

Identidad y estado

7 operaciones

POST/api/auth/loginStart a session with email/username and password+

Autenticación: Pública
Scope S2S: No aplica
Content-Type: Sin body

Respuestas documentadas

200Authenticated

401Invalid credentials

429Too many attempts

Integrá sobre cosasque existen.

Un contrato. Un entorno activo. Live fail-closed.

Primer request, sin pasos inventados.

Dos identidades, controles distintos.

Sesión first-party

API key con scopes

Idempotencia, trazabilidad y retry seguro.

Idempotency-Key

X-Request-Id

Replays

Cimbra-Should-Retry

Cursores estables y montos exactos.

Paginación

Dinero

Fallos estructurados y accionables.

Un paquete real, descargable y con checksum.

@cimbra/sdk · v0.1.0

Servicios propios, no un adaptador a competidores.

Un movimiento, dos postings, historial completo.

Una wallet, bolsillos reales, sin ledger paralelo.

CVU propio, alias de tenant, sin fingir Coelsa.

Un link de cobro y un punto de recaudación, sin fingir adquirencia de red.

De un beneficiario protegido a un resultado conciliable.

KYC/KYB orquestado, con decisión humana independiente.

Autenticación reforzada, sin confundirla con una red.

Outbox durable, firma y replay operativo.

Todo el contrato publicado.

Respuestas documentadas

Respuestas documentadas

Respuestas documentadas

Respuestas documentadas

Respuestas documentadas

Respuestas documentadas

Respuestas documentadas

Parámetros

Respuestas documentadas

Parámetros

Respuestas documentadas

Parámetros

Respuestas documentadas

Parámetros

Respuestas documentadas

Parámetros

Respuestas documentadas

Parámetros

Respuestas documentadas

Parámetros

Respuestas documentadas

Parámetros

Respuestas documentadas

Parámetros

Respuestas documentadas

Parámetros

Respuestas documentadas

Parámetros

Respuestas documentadas

Parámetros

Respuestas documentadas

Parámetros

Respuestas documentadas

Parámetros

Respuestas documentadas

Parámetros

Respuestas documentadas

Parámetros

Respuestas documentadas

Parámetros

Respuestas documentadas

Parámetros

Respuestas documentadas

Parámetros

Respuestas documentadas

Parámetros

Respuestas documentadas

Parámetros

Respuestas documentadas

Parámetros

Respuestas documentadas

Parámetros

Respuestas documentadas

Integrá sobre cosas
que existen.