Desarrolladores y API
Conecte sus sistemas a su cuenta Valtora.
Una API REST para cuentas de empresa: consulte saldos, gestione destinatarios, cotice y cree pagos, y reciba webhooks firmados. Cada pago hecho por la API espera la llave de acceso de un aprobador en la app.
- Claves con permisos y caducidad
- Webhooks firmados
- Pagos aprobados con llave de acceso
- Referencia OpenAPI
Qué incluye
Saldos y cuentas
Liste sus cuentas con su saldo contabilizado, retenido y disponible.
Destinatarios
Liste sus destinatarios guardados y añada otros nuevos, con las mismas comprobaciones que en la app.
Pagos
Obtenga todas las formas de pagar con su comisión y plazo, y pague con la cotización que elija. Un aprobador lo libera con su llave de acceso en la app; por encima de su umbral, dos aprobadores.
Webhooks
Eventos firmados a hasta 5 direcciones https, cada una con su propio secreto. Envíe un evento de prueba, reenvíe una entrega fallida o reenvíe todo lo que falló en las últimas 24 horas.
Claves y límites
El titular de la cuenta crea las claves con su llave de acceso, eligiendo permisos y una caducidad de 30 a 365 días. Hasta 120 peticiones por minuto por clave; una clave revocada deja de funcionar al instante.
Partner API
Módulos de banca, servicios para comercios, y cripto y divisas para empresas que construyen sobre Valtora, con conversiones, pagos salientes y retiros de cripto. Se activan para cada cliente tras nuestra revisión.
Un pago en dos llamadas
Primero la cotización, después el pago con ella. Los importes son cadenas en unidades mínimas, y cada llamada que crea algo lleva una clave de idempotencia.
1. Obtenga las formas de pagar
curl https://valtorapro.com/api/v1/payments/quotes \
-H "Authorization: Bearer vt_live_…" \
-H "Content-Type: application/json" \
-d '{"beneficiary_id": "5b2f…", "amount": "125000"}'2. Pague con la cotización
curl https://valtorapro.com/api/v1/payments \
-H "Authorization: Bearer vt_live_…" \
-H "Idempotency-Key: inv-2041" \
-H "Content-Type: application/json" \
-d '{"quote_id": "9a8b…", "reference": "INV-2041"}'Referencia de la API (OpenAPI)Referencia de la Partner API (OpenAPI)
Quién lo usa
Finanzas y ERP
Lleve los saldos a su contabilidad y cree pagos a proveedores desde su sistema contable; sus aprobadores los liberan en la app.
Marketplaces y plataformas
Pague a vendedores y socios desde su propio sistema, con webhooks que le informan del estado de cada pago.
Tesorería
Siga saldos y estados de pago desde sus herramientas de tesorería sin iniciar sesión.
Precios
Los pagos hechos por la API cuestan lo mismo que en la app. El precio de la Partner API se acuerda al revisar su caso. Las tarifas estándar están en la página de precios.
Preguntas
¿Quién puede usar la API?
Las cuentas de empresa. El titular de la cuenta crea las claves en Desarrolladores con su llave de acceso.
¿Puede una clave de API enviar dinero por sí sola?
No. Cada pago hecho por la API espera la llave de acceso de un aprobador en la app, y se aplican su umbral de aprobación y sus límites.
¿Podemos convertir divisas, pagar o retirar cripto por la API?
Sí, mediante la Partner API. Se activa para cada cliente tras nuestra revisión.
¿Dónde está la referencia de la API?
Los archivos OpenAPI son públicos y están enlazados en esta página. Los clientes con sesión iniciada también la encuentran en Desarrolladores.
Hable con nosotros sobre la API.
Cuéntenos cómo se mueve el dinero en su empresa y le responderemos por correo electrónico para concertar una llamada.
Chatear en TelegramValtora coordina la revisión de su empresa y el proceso de alta.