Obtener URL

Base URL: https://integracionapi.finalitix.com

---

Generar URL de pago

Genera una URL única por paquete que el ordenante usa para autorizar y procesar las transferencias SPEI.

POST /api/integracion/get-url Copiar

Body (JSON):

Campo	Tipo	Requerido	Descripción
paquete_id	string (UUID)	Sí	ID del paquete

Ejemplo con cURL:

curl -X POST https://integracionapi.finalitix.com/api/integracion/get-url \
  -H "x-api-key: TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "paquete_id": "550e8400-e29b-41d4-a716-446655440000"
  }'

Ejemplo con Node.js (axios):

const axios = require("axios");

const { data } = await axios({
  method: "post",
  url: "https://integracionapi.finalitix.com/api/integracion/get-url",
  headers: {
    "x-api-key": "TU_API_KEY",
    "Content-Type": "application/json",
  },
  data: JSON.stringify({
    paquete_id: "550e8400-e29b-41d4-a716-446655440000",
  }),
});

Respuesta exitosa 200:

{
  "paquete_id": "550e8400-e29b-41d4-a716-446655440000",
  "url": "https://pago.finalitix.com/p/abc123xyz",
  "status": 1
}

Estados del paquete (status):

Valor	Significado
1	Disponible — listo para procesar
2	Procesado — el lote fue ejecutado
3	Expirado — la URL ya no es válida

Respuesta de error 400:

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

---

Crear pago esperado

Registra un pago entrante esperado (abono) antes de que ocurra, permitiendo que Finalitix lo identifique automáticamente.

POST /service/v1/batch/draft-payment Copiar

Body (JSON):

Campo	Tipo	Requerido	Descripción
rfc	string	Sí	RFC del ordenante
monto	number	Sí	Monto esperado (MXN)
ordenante	string	Sí	Nombre del ordenante
concepto	string	Sí	Concepto o referencia del pago

Ejemplo con cURL:

curl -X POST https://integracionapi.finalitix.com/service/v1/batch/draft-payment \
  -H "x-api-key: TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "rfc": "GALO800101ABC",
    "monto": 125000.00,
    "ordenante": "Empresa Ejemplo SA de CV",
    "concepto": "Pago nómina enero 2024"
  }'

Ejemplo con Node.js (axios):

const { data } = await axios({
  method: "post",
  url: "https://integracionapi.finalitix.com/service/v1/batch/draft-payment",
  headers: {
    "x-api-key": "TU_API_KEY",
    "Content-Type": "application/json",
  },
  data: JSON.stringify({
    rfc: "GALO800101ABC",
    monto: 125000.0,
    ordenante: "Empresa Ejemplo SA de CV",
    concepto: "Pago nómina enero 2024",
  }),
});

Respuesta exitosa 200:

{
  "success": true,
  "message": "Pago esperado registrado correctamente"
}