# FITAL API

> API B2B para pagar, cobrar y conciliar con una cuenta FITAL. Base de producción: https://widget.fital.xyz/v1. Simulador público: https://widget.fital.xyz/explorar/v1.

Este índice describe la documentación pública. Cada enlace apunta a Markdown.

## Empezar

- [API de FITAL](https://merchants.fital.xyz/docs/index.md): Paga, cobra y concilia desde tus sistemas con una sola cuenta.
- [Tu primer pago de prueba](https://merchants.fital.xyz/docs/primer-pago.md): Cinco pasos contra el simulador público, sin cuenta y sin dinero.
- [Inicio rápido de la cuenta de prueba](https://merchants.fital.xyz/docs/sandbox/inicio-rapido.md): Tu primer pago ficticio con estado real, firmado y con su webhook.
- [Conceptos](https://merchants.fital.xyz/docs/conceptos.md): Una empresa, una cuenta FITAL, y lo que se mueve dentro de ella.
- [Cobertura](https://merchants.fital.xyz/docs/cobertura.md): Países, monedas y rieles disponibles, y lo que puedes hacer en cada uno.
- [Ambientes](https://merchants.fital.xyz/docs/ambientes.md): Simulador público, cuenta de prueba y producción, y cómo pasar de uno a otro.
- [Cuenta de prueba](https://merchants.fital.xyz/docs/sandbox/cuenta-de-prueba.md): Tu ambiente propio con datos ficticios, escenarios y webhooks simulados.
- [Autenticación](https://merchants.fital.xyz/docs/autenticacion.md): Llaves, scopes, firma de petición e IP permitidas.

## Construir

- [Idempotencia](https://merchants.fital.xyz/docs/idempotencia.md): Reintentar sin pagar dos veces.
- [Errores](https://merchants.fital.xyz/docs/errores.md): Cada código, su causa, su solución y si se reintenta.
- [Webhooks](https://merchants.fital.xyz/docs/webhooks.md): Recibe eventos firmados, verifícalos y recupera lo que falte.
- [Inicio rápido de webhooks](https://merchants.fital.xyz/docs/webhooks/inicio-rapido.md): Un receptor que verifica firmas, corriendo en tu máquina y sin cuenta.
- [Verificar la firma](https://merchants.fital.xyz/docs/webhooks/verificar-firma.md): Comprueba que cada entrega viene de FITAL, con muestras que corren tal cual.
- [Catálogo de eventos](https://merchants.fital.xyz/docs/webhooks/eventos.md): Qué evento sale y cuándo.
- [Límites](https://merchants.fital.xyz/docs/limites.md): Peticiones, cuerpo, tiempos y montos.
- [Paginación](https://merchants.fital.xyz/docs/paginacion.md): Cursores, orden y consistencia.
- [Montos y fechas](https://merchants.fital.xyz/docs/montos-y-fechas.md): Montos como texto decimal, monedas y zona horaria.
- [Versionado](https://merchants.fital.xyz/docs/versionado.md): Qué cambia sin aviso y qué rompe.

## Recetas

- [Cobros](https://merchants.fital.xyz/docs/recetas/cobros.md): Crear un cobro y seguirlo hasta que se pague.
- [Conciliar](https://merchants.fital.xyz/docs/recetas/conciliar.md): Cuadrar tus movimientos contra tus registros.
- [Cuentas para recibir](https://merchants.fital.xyz/docs/recetas/cuentas-para-recibir.md): Abrir una cuenta en otra moneda y dar sus datos a quien te paga.
- [Direcciones de depósito](https://merchants.fital.xyz/docs/recetas/direcciones-deposito.md): Crea una dirección para recibir un token por una red.
- [Movimientos y recibos](https://merchants.fital.xyz/docs/recetas/movimientos-y-recibos.md): Lista cada entrada y salida de tu cuenta y descarga su recibo.
- [Pago ACH](https://merchants.fital.xyz/docs/recetas/pago-ach.md): Pagar en dólares a una cuenta de Estados Unidos por ACH.
- [Pago Bre-B](https://merchants.fital.xyz/docs/recetas/pago-bre-b.md): Pagar en pesos colombianos con una llave Bre-B.
- [Pago FPS](https://merchants.fital.xyz/docs/recetas/pago-fps.md): Pagar en libras a una cuenta de Reino Unido por Faster Payments.
- [Pago LatAm](https://merchants.fital.xyz/docs/recetas/pago-latam.md): Pagar en moneda local en otros países de América Latina.
- [Pago masivo](https://merchants.fital.xyz/docs/recetas/pago-masivo.md): Dispersar un lote con idempotencia y saldo.
- [Pago PIX](https://merchants.fital.xyz/docs/recetas/pago-pix.md): Pagar por PIX si tu empresa ya lo tiene habilitado.
- [Pago SEPA](https://merchants.fital.xyz/docs/recetas/pago-sepa.md): Pagar en euros a una cuenta de la zona euro.
- [Pago SPEI](https://merchants.fital.xyz/docs/recetas/pago-spei.md): Dispersar en México, desde el alta del beneficiario hasta el recibo.
- [Pago wire](https://merchants.fital.xyz/docs/recetas/pago-wire.md): Pagar en dólares a una cuenta de Estados Unidos por wire.
- [Quién pagó](https://merchants.fital.xyz/docs/recetas/quien-pago.md): Consulta los depósitos recibidos y los datos del pagador.
- [Reintentos](https://merchants.fital.xyz/docs/recetas/reintentos.md): Qué repetir, qué hacer ante un timeout y qué no concluir de un 401.

## Operación

- [Lista para producción](https://merchants.fital.xyz/docs/produccion.md): Lo que debes cumplir antes de mover dinero real.
- [Seguridad](https://merchants.fital.xyz/docs/seguridad.md): Guardar llaves, reaccionar a filtraciones y trabajar con agentes de IA.
- [IP permitidas](https://merchants.fital.xyz/docs/seguridad/ip-permitidas.md): Registra las IP desde las que opera cada llave.
- [IP de webhooks](https://merchants.fital.xyz/docs/seguridad/ip-webhooks.md): Desde dónde entrega FITAL sus webhooks y cómo se avisan los cambios.
- [Cambios](https://merchants.fital.xyz/docs/cambios.md): Cambios de la API por fecha, con su clasificación.
- [Lista de migración](https://merchants.fital.xyz/docs/migracion.md): Qué revisar en tu integración tras los ajustes del contrato v1.
- [Soporte](https://merchants.fital.xyz/docs/soporte.md): Cómo contactar a FITAL y qué enviar.
- [Herramientas](https://merchants.fital.xyz/docs/herramientas.md): OpenAPI, Postman, llms.txt, MCP público y clientes.
- [Salud y estado](https://merchants.fital.xyz/docs/salud-y-estado.md): Cómo saber si la API responde y qué capacidades están afectadas.

## Operaciones

- [Referencia por operación](https://merchants.fital.xyz/docs/operaciones.md): Cada operación de la API, con sus errores, reintentos, muestras y guías.
- [Abrir una cuenta para recibir](https://merchants.fital.xyz/docs/operaciones/abrir-cuenta-para-recibir.md): POST /v1/receiving-accounts
- [Avanzar un pago ficticio](https://merchants.fital.xyz/docs/operaciones/avanzar-pago-de-prueba.md): POST /sandbox/v1/payments/{id}/advance
- [Cancelar un pago que aún espera fondos](https://merchants.fital.xyz/docs/operaciones/cancelar-pago.md): POST /v1/payments/{id}/cancel
- [Un beneficiario](https://merchants.fital.xyz/docs/operaciones/consultar-beneficiario.md): GET /v1/beneficiaries/{id}
- [Un cobro](https://merchants.fital.xyz/docs/operaciones/consultar-cobro.md): GET /v1/collections/{id}
- [Un depósito](https://merchants.fital.xyz/docs/operaciones/consultar-deposito.md): GET /v1/deposits/{id}
- [Una dirección de depósito](https://merchants.fital.xyz/docs/operaciones/consultar-direccion-de-deposito.md): GET /v1/deposit-addresses/{id}
- [Estado por capacidad](https://merchants.fital.xyz/docs/operaciones/consultar-estado.md): GET /v1/status
- [Un evento](https://merchants.fital.xyz/docs/operaciones/consultar-evento.md): GET /v1/events/{id}
- [IP de salida de webhooks](https://merchants.fital.xyz/docs/operaciones/consultar-ip-de-salida.md): GET /v1/meta/egress-ips
- [Límites de la cuenta](https://merchants.fital.xyz/docs/operaciones/consultar-limites.md): GET /v1/limits
- [Un movimiento](https://merchants.fital.xyz/docs/operaciones/consultar-movimiento.md): GET /v1/movements/{id}
- [Un pago](https://merchants.fital.xyz/docs/operaciones/consultar-pago.md): GET /v1/payments/{id}
- [Salud pública del servicio](https://merchants.fital.xyz/docs/operaciones/consultar-salud.md): GET /v1/health
- [Alta de beneficiario, pendiente de aprobar en el panel](https://merchants.fital.xyz/docs/operaciones/crear-beneficiario.md): POST /v1/beneficiaries
- [Crear un cobro](https://merchants.fital.xyz/docs/operaciones/crear-cobro.md): POST /v1/collections
- [Cotización indicativa con vencimiento](https://merchants.fital.xyz/docs/operaciones/crear-cotizacion.md): POST /v1/quotes
- [Crear una dirección de depósito](https://merchants.fital.xyz/docs/operaciones/crear-direccion-de-deposito.md): POST /v1/deposit-addresses
- [Crear un pago](https://merchants.fital.xyz/docs/operaciones/crear-pago.md): POST /v1/payments
- [Recibo de un movimiento terminal](https://merchants.fital.xyz/docs/operaciones/descargar-recibo.md): GET /v1/movements/{id}/receipt
- [Baja de beneficiario](https://merchants.fital.xyz/docs/operaciones/eliminar-beneficiario.md): DELETE /v1/beneficiaries/{id}
- [Emitir un evento de prueba](https://merchants.fital.xyz/docs/operaciones/emitir-evento-de-prueba.md): POST /sandbox/v1/webhooks/trigger
- [Estimar un cobro](https://merchants.fital.xyz/docs/operaciones/estimar-cobro.md): POST /v1/collections/estimate
- [Bancos de un país del riel `latam`](https://merchants.fital.xyz/docs/operaciones/listar-bancos-latam.md): GET /v1/latam/countries/{country}/entities
- [Beneficiarios](https://merchants.fital.xyz/docs/operaciones/listar-beneficiarios.md): GET /v1/beneficiaries
- [Cobros, con su último estado conocido](https://merchants.fital.xyz/docs/operaciones/listar-cobros.md): GET /v1/collections
- [Cuentas para recibir](https://merchants.fital.xyz/docs/operaciones/listar-cuentas-para-recibir.md): GET /v1/receiving-accounts
- [Depósitos recibidos y quién pagó](https://merchants.fital.xyz/docs/operaciones/listar-depositos.md): GET /v1/deposits
- [Destinos de webhooks](https://merchants.fital.xyz/docs/operaciones/listar-destinos-de-webhook.md): GET /v1/webhook-endpoints
- [Direcciones de depósito](https://merchants.fital.xyz/docs/operaciones/listar-direcciones-de-deposito.md): GET /v1/deposit-addresses
- [Eventos de la empresa](https://merchants.fital.xyz/docs/operaciones/listar-eventos.md): GET /v1/events
- [Métodos de cobro](https://merchants.fital.xyz/docs/operaciones/listar-metodos-de-cobro.md): GET /v1/collection-methods
- [Movimientos de la cuenta](https://merchants.fital.xyz/docs/operaciones/listar-movimientos.md): GET /v1/movements
- [Pagos, con su último estado conocido](https://merchants.fital.xyz/docs/operaciones/listar-pagos.md): GET /v1/payments
- [Países del riel `latam`](https://merchants.fital.xyz/docs/operaciones/listar-paises-latam.md): GET /v1/latam/countries
- [Saldos disponibles](https://merchants.fital.xyz/docs/operaciones/listar-saldos.md): GET /v1/balances
- [Wallets de la empresa](https://merchants.fital.xyz/docs/operaciones/listar-wallets.md): GET /v1/wallets

## Contrato

- [Referencia en Markdown](https://merchants.fital.xyz/docs/referencia.md): todas las operaciones.
- [OpenAPI](https://merchants.fital.xyz/openapi.json): contrato en JSON.
- [OpenAPI de la cuenta de prueba](https://merchants.fital.xyz/docs/openapi.sandbox.json): el contrato con las rutas que sólo existen ahí.
- [Cambios](https://merchants.fital.xyz/docs/cambios.md): cambios por fecha.
- [IP de webhooks](https://merchants.fital.xyz/docs/seguridad/ip-webhooks.md): IP de salida y sus avisos.
- [Integridad](https://merchants.fital.xyz/docs/integridad.json): hashes de este release.