Registra lo que esperas cobrar
Cada pedido, factura o mensualidad entra como un pago esperado: monto, referencia que reportó el pagador, teléfono o cédula, y hasta cuándo vale.
POST /v1/expected-payments
Para comercios que cobran por Pago Móvil
Concilia Pago Móvil sin perseguir capturas.
Registra lo que esperas cobrar, conecta tu banco o sube el estado de cuenta, y Xaldos cruza cada pago por referencia, teléfono o documento. Lo que no cuadra, te lo marca. Lo que cuadra, te lo avisa.
Bolívares y USDT. Modo de prueba incluido. Sin custodia de fondos.
Lee los estados de cuenta de seis bancos y se conecta por API donde el banco lo permite.
Banco de VenezuelaAPI
MercantilAPI
BanescoAPI
BNCAPI- BPBanco PlazaAPI
- PRProvincialarchivo
- BCBancaribearchivo
- ₮Binance USDTAPI
Te suena
Cobrar por Pago Móvil es fácil. Saber quién te pagó, no.
La plata llega al banco; la confirmación llega por WhatsApp. Y alguien tiene que cuadrar las dos cosas a mano, todos los días.
Me mandan la captura, busco la referencia en el estado de cuenta y a veces el monto no es el mismo.
Dos clientes pagaron Bs. 500 el mismo día, con la misma referencia corta. ¿Cuál es cuál?
Cierro el día a las once de la noche cuadrando el Excel del banco con los pedidos.
Cómo funciona
Tres pasos, y el cuadre deja de ser un trabajo.
Xaldos no mueve dinero: lee los movimientos de tu cuenta y los compara con lo que esperas cobrar.
Conecta el banco o sube el estado de cuenta
Con API bancaria, Xaldos sincroniza solo. Sin API, arrastras el CSV o XLSX que descargas de la banca en línea y listo.
PUT /v1/accounts/{id}/connection
Recibe el cruce y actúa
Cada pago queda cruzado, marcado para revisión o vencido. Tu tienda recibe un webhook firmado y tu equipo lo ve en el panel.
expected_payment.matched
Cruce 1referencia exactaEl número completo que reportó el pagador coincide con el del banco.
Cruce 2sufijo de referenciaLos últimos 4 a 6 dígitos, como los muestra el recibo del pagador.
Cruce 3teléfono o cédulaMismo pagador, mismo monto, misma ventana de tiempo.
Para revisarpara revisiónMonto distinto, referencia repetida o varios candidatos: una persona decide, con los datos a la vista.
Lo que cambia
Menos capturas. Menos dudas. Menos noches cuadrando.
Confirmas en minutos, no al cierre
Con API bancaria la sincronización corre cada pocos minutos; con archivo, el cruce termina segundos después de subirlo.
Bolívares y USDT en un solo cuadre
Un pago esperado en USDT se compara con la tasa del BCV del día y una tolerancia que tú defines. Binance entra como una cuenta más.
Lo dudoso se revisa, no se pierde
Monto distinto, referencia duplicada, dos pedidos para un mismo pago: cada caso queda en una cola con sus candidatos y su historial.
Varias cuentas, varios bancos
Cada cuenta se conecta como mejor le queda a ese banco: API donde existe, archivo donde no. El motor de cruce es el mismo.
Modo de prueba desde el día uno
API keys de prueba y de producción, separadas. Prueba tu integración con datos ficticios antes de tocar un pago real.
Tu tienda se entera sola
Webhooks firmados con siete reintentos a lo largo de un día y un registro de cada entrega. Si tu servidor estaba caído, el aviso vuelve.
Para desarrolladores
Una API REST, un contrato OpenAPI y nada que adivinar.
Autenticación por API key, idempotencia en cada escritura, errores tipados y documentación generada del mismo código que corre en producción.
- OpenAPI 3.1 versionadoEl documento vive en el repositorio y la integración continua falla si cambia sin querer.
- Idempotencia con Idempotency-KeyReintenta sin miedo: la misma clave devuelve la misma respuesta.
- Webhooks firmadosFirma HMAC en cada entrega, identificador de evento y reintentos con espera creciente.
- Mock bancario para pruebasUn banco de mentira con escenarios: pagos pendientes, duplicados, montos distintos, caídas.
curl https://app.xaldos.com/v1/expected-payments \
-H "Authorization: Bearer sk_test_…" \
-H "Idempotency-Key: ord-1042-1" \
-H "Content-Type: application/json" \
-d '{
"accountId": "acct_01J…",
"externalId": "ORD-1042",
"amount": 125000,
"currency": "VES",
"reportedReference": "4821",
"payer": { "phone": "+584141234567" },
"expiresAt": "2026-11-15T23:59:59-04:00"
}'
# 201 Created
{ "id": "exp_01J…", "status": "pending", "livemode": false }POST https://tu-tienda.com/webhooks/xaldos
X-Signature: t=1763040000,v1=…
X-Event-Id: evt_01J…
{
"id": "evt_01J…",
"type": "expected_payment.matched",
"createdAt": "2026-11-13T10:42:11-04:00",
"data": {
"id": "exp_01J…",
"externalId": "ORD-1042",
"amount": 125000,
"currency": "VES",
"status": "matched",
"remainingAmount": 0,
"livemode": true
}
}También desde Claude o ChatGPT
Xaldos expone un servidor MCP con 38 herramientas: pregúntale a tu asistente qué pagos faltan por cuadrar hoy, cruza uno a mano o crea un pago esperado desde el chat, con tu sesión y tus permisos.
Seguridad
Lee tus movimientos. Nunca toca tu plata.
Xaldos no recibe, guarda ni mueve fondos. Trabaja con lo que tu banco ya te muestra, con tu autorización.
Credenciales cifradas en reposo
Las credenciales del banco y los datos sensibles se guardan cifrados con AES-256-GCM. Nadie del equipo los ve en claro.
Claves de prueba y de producción
Las API keys se muestran una sola vez y se guardan con hash. Las de prueba no ven datos reales, ni al revés.
Datos personales con fecha de caducidad
Los archivos crudos se borran a los 90 días y los datos de pagadores se anonimizan a los 180. Tú puedes acortarlo.
Registro de auditoría
Cada inicio de sesión, cada clave creada y cada cruce manual queda registrado con quién, cuándo y desde dónde.
Preguntas frecuentes
Lo que nos preguntan antes de empezar.
¿Xaldos recibe o mueve mi dinero?
No. Los pagos siguen llegando a tu cuenta bancaria de siempre. Xaldos solo lee los movimientos, por API o por el estado de cuenta que subes, y los compara con lo que esperas cobrar.
¿Necesito que mi banco tenga API?
No. Si tu banco no ofrece API, descargas el estado de cuenta de la banca en línea (CSV o XLSX) y lo subes. El cruce es el mismo. Hoy leemos los formatos de Banco de Venezuela, Mercantil, Provincial, Bancaribe, Banesco y BNC, y se conecta por API con BDV, Banesco, Banco Plaza, Mercantil y Binance.
¿Qué pasa cuando un pago no cuadra?
Queda marcado para revisión con el motivo (monto distinto, referencia repetida, varios candidatos) y los pagos del banco que podrían corresponderle. Una persona de tu equipo lo cruza a mano desde el panel, o lo deja vencer.
¿Puedo cobrar en USDT y cuadrarlo con bolívares?
Sí. Un pago esperado puede estar en bolívares o en USDT. Xaldos compara el monto con la tasa oficial del BCV del día y una tolerancia en porcentaje que tú configuras.
¿Cómo se integra con mi tienda o mi sistema?
Por la API REST (con documentación OpenAPI) y webhooks firmados. Si prefieres no programar, el panel web sirve para registrar pagos esperados, subir estados de cuenta y revisar el cruce. También puedes operarlo desde Claude o ChatGPT con el servidor MCP.
¿Cuánto cuesta?
Estamos en acceso anticipado con un grupo de comercios. Escríbenos y te contamos cómo funciona en esta etapa.
Empieza a cuadrar sin capturas.
Cuéntanos qué bancos usas y cuántos pagos recibes al día. Te abrimos una cuenta de prueba con datos de ejemplo y te acompañamos en la primera conciliación real.