Skip to main content
Equipos de finanzas y de producto necesitan que los movimientos lleguen solos a su sistema contable o a su panel. Con las llamadas de lectura y los webhooks automatizas ese trabajo y eliminas el polling manual.

​
Flujo

​
Paso a paso

1

Lee saldos

GET /wallets/{uuid} devuelve el saldo disponible en tiempo real de cada wallet.
2

Lista movimientos

GET /transactions con filtros y paginación, o GET /transactions/get_all_transactions para la vista completa.
3

Recibe eventos

Configura la URL con PUT /webhooks y elige las categorías. Valida siempre la firma antes de procesar.
4

Revisa entregas

GET /events muestra los últimos eventos y si tu servidor respondió 200. Útil para depurar entregas fallidas.

​
Buenas prácticas

Deduplica con event_id, tratándolo como texto opaco. No asumas formato.
Responde 200 rápido y procesa en segundo plano. Vita retiene y reintenta si tu servidor tarda; aprovecha la ventana corta.
Programa una conciliación nocturna que compare tu ledger con GET /transactions. Las discrepancias se arrastran si no las detectas pronto.

​
Patrón recomendado

1

Fuente de verdad

Trata tu propia base de datos como la fuente de verdad para saldos por cliente final, y la API como la fuente de verdad para saldos de la empresa.
2

Timestamps

Guarda created_at del evento para reconstruir la línea de tiempo exacta si hay que investigar.
3

Reintentos

Si un webhook falla, GET /events te permite replayar los últimos 10 — no hace falta tu propia cola.

​
Endpoints clave

Saldos

GET /wallets/{uuid}

Lista de transacciones

GET /transactions / GET /transactions/get_all_transactions

Configurar webhook

PUT /webhooks

Historial de eventos

GET /events