APIAPI de FITAL
Paga, cobra y concilia desde tus sistemas con una sola cuenta.
Con la API de FITAL tu sistema paga a proveedores, cobra a clientes, recibe depósitos y concilia cada movimiento. Todo se opera en HTTPS con JSON, con una sola cuenta por empresa.
| Ambiente | Base | Para qué |
|---|---|---|
| Simulador público | https://widget.fital.xyz/explorar/v1 | Explorar sin cuenta, con ejemplos fijos |
| Cuenta de prueba | https://widget.fital.xyz/sandbox/v1 | Probar tu integración con datos ficticios |
| Producción | https://widget.fital.xyz/v1 | Mover dinero real |
Tres caminos
- Quiero verlo funcionar. Sigue Tu primer pago de prueba. No necesitas cuenta.
- Quiero probar con estado real. Sigue el inicio rápido de la cuenta de prueba.
- Quiero recibir eventos. Sigue el inicio rápido de webhooks.
- Quiero integrar. Empieza por Conceptos, Cobertura, Autenticación e Idempotencia.
- Quiero consultar una operación. Ve a la referencia por operación, a la referencia interactiva o a su versión en texto.
Lo que puedes hacer hoy
| Necesidad | Operaciones | Guía |
|---|---|---|
| Consultar saldos, wallets, cuentas y límites | GET /v1/balances, GET /v1/wallets, GET /v1/receiving-accounts, GET /v1/limits | Conceptos |
| Abrir una cuenta para recibir | POST /v1/receiving-accounts | Cuentas para recibir |
| Registrar a quién pagas | POST /v1/beneficiaries | Pago SPEI |
| Pagar | POST /v1/quotes, POST /v1/payments | Cobertura, con una guía por riel |
| Cobrar | POST /v1/collections | Cobros |
| Recibir por dirección de depósito | POST /v1/deposit-addresses | Direcciones de depósito |
| Saber quién te pagó | GET /v1/deposits | Quién pagó |
| Conciliar | GET /v1/movements, GET /v1/movements/{id}/receipt | Movimientos y recibos |
Para asistentes de IA y herramientas
Cada página existe también en Markdown: agrega .md a su ruta. El índice está en /llms.txt y el contrato en /openapi.json. Ver Herramientas.
Errores comunes
- Usar una llave de un ambiente en la base de otro: responde
401 wrong_environment. - Pegar una llave real en la referencia interactiva. El botón de prueba sólo habla con el simulador público.