# API 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](/docs/primer-pago/). No necesitas cuenta.
- **Quiero probar con estado real.** Sigue el [inicio rápido de la cuenta de prueba](/docs/sandbox/inicio-rapido/).
- **Quiero recibir eventos.** Sigue el [inicio rápido de webhooks](/docs/webhooks/inicio-rapido/).
- **Quiero integrar.** Empieza por [Conceptos](/docs/conceptos/), [Cobertura](/docs/cobertura/), [Autenticación](/docs/autenticacion/) e [Idempotencia](/docs/idempotencia/).
- **Quiero consultar una operación.** Ve a la [referencia por operación](/docs/operaciones/), a la [referencia interactiva](/docs/referencia/) o a su [versión en texto](/docs/referencia.md).

## Lo que puedes hacer hoy

| Necesidad | Operaciones | Guía |
|---|---|---|
| Consultar saldos, wallets, cuentas y límites | [`GET /v1/balances`](/docs/operaciones/listar-saldos/), [`GET /v1/wallets`](/docs/operaciones/listar-wallets/), [`GET /v1/receiving-accounts`](/docs/operaciones/listar-cuentas-para-recibir/), [`GET /v1/limits`](/docs/operaciones/consultar-limites/) | [Conceptos](/docs/conceptos/) |
| Abrir una cuenta para recibir | [`POST /v1/receiving-accounts`](/docs/operaciones/abrir-cuenta-para-recibir/) | [Cuentas para recibir](/docs/recetas/cuentas-para-recibir/) |
| Registrar a quién pagas | [`POST /v1/beneficiaries`](/docs/operaciones/crear-beneficiario/) | [Pago SPEI](/docs/recetas/pago-spei/) |
| Pagar | [`POST /v1/quotes`](/docs/operaciones/crear-cotizacion/), [`POST /v1/payments`](/docs/operaciones/crear-pago/) | [Cobertura](/docs/cobertura/), con una guía por riel |
| Cobrar | [`POST /v1/collections`](/docs/operaciones/crear-cobro/) | [Cobros](/docs/recetas/cobros/) |
| Recibir por dirección de depósito | [`POST /v1/deposit-addresses`](/docs/operaciones/crear-direccion-de-deposito/) | [Direcciones de depósito](/docs/recetas/direcciones-deposito/) |
| Saber quién te pagó | [`GET /v1/deposits`](/docs/operaciones/listar-depositos/) | [Quién pagó](/docs/recetas/quien-pago/) |
| Conciliar | [`GET /v1/movements`](/docs/operaciones/listar-movimientos/), [`GET /v1/movements/{id}/receipt`](/docs/operaciones/descargar-recibo/) | [Movimientos y recibos](/docs/recetas/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`](https://merchants.fital.xyz/llms.txt) y el contrato en [`/openapi.json`](https://merchants.fital.xyz/openapi.json). Ver [Herramientas](/docs/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.

## Qué sigue

[Tu primer pago de prueba](/docs/primer-pago/).