Inicio Rápido

Prerequisitos

• Una cuenta activa en Finalitix
• Tu API key (genérala en https://integra.finalitix.com)

Base URL

Todas las solicitudes apuntan a:

https://integracionapi.finalitix.com

Flujo básico

1. Crear un paquete — agrupa las transferencias que quieres enviar
2. Agregar transacciones — una por cada beneficiario
3. Obtener URL — genera el enlace de pago para autorizar el lote

---

Tu primera solicitud

1. Obtén tu API key

Inicia sesión en https://integra.finalitix.com y genera una API key.

2. Crea un paquete

curl -X POST https://integracionapi.finalitix.com/service/v1/batch/ \
  -H "x-api-key: TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "nombre": "Nómina Enero",
    "cantidad_operaciones": 10
  }'

3. Respuesta exitosa

{
  "success": true,
  "message": "Paquete creado correctamente",
  "result": {
    "name": "Nómina Enero",
    "paquete_id": "550e8400-e29b-41d4-a716-446655440000"
  }
}

Guarda el paquete_id — lo necesitarás para agregar transacciones y obtener la URL de pago.

---

Códigos de respuesta

Código	Significado
200	OK — solicitud exitosa
201	Creado — recurso creado
400	Solicitud incorrecta — parámetros inválidos
401	No autorizado — API key inválida o faltante
404	No encontrado
500	Error interno del servidor

Respuesta de error

Cuando success es false, la respuesta incluye un mensaje descriptivo:

{
  "success": false,
  "message": "El paquete_id proporcionado no existe."
}

Siguiente paso

Agrega transacciones al paquete en Transacciones.