Notificaciones (Webhooks)

Finalitix envía notificaciones automáticas a la URL webhook que configures en tu cuenta. Cada evento es un POST con Content-Type: application/json.

Pago / abono recibido

Se dispara cuando se recibe un abono en tu cuenta de Finalitix.

Payload:

{
  "fecha": "2024-01-15 10:30:00",
  "nombre_ordenante": "Empresa Ejemplo SA de CV",
  "monto": 125000.00,
  "rfc_curp_ordenante": "GALO800101ABC",
  "abono_precargado_id": false,
  "operacion_cliente_id": null,
  "cuenta_ordenante": "012345678901234567"
}

Campos:

Campo	Tipo	Descripción
`fecha`	`string`	Fecha y hora del abono (`yyyy-MM-dd hh:mm:ss`)
`nombre_ordenante`	`string`	Nombre de quien realizó el pago
`monto`	`number`	Monto recibido (MXN)
`rfc_curp_ordenante`	`string`	RFC o CURP del ordenante
`abono_precargado_id`	`boolean`	`true` si el abono coincide con un pago esperado
`operacion_cliente_id`	`integer \| null`	ID de operación en tu sistema (si aplica)
`cuenta_ordenante`	`string`	CLABE del ordenante

Procesamiento de lote

Se dispara cuando Finalitix procesa un paquete de transferencias.

Payload:

{
  "fecha": "2024-01-15 11:00:00",
  "procesado": true,
  "mensaje": "Lote procesado exitosamente",
  "transacciones_procesadas": [
    "op_abc123",
    "op_def456"
  ],
  "transacciones_no_procesadas": [
    {
      "operacion_id": "op_ghi789",
      "mensaje": "CLABE inválida"
    }
  ],
  "monto_total_transacciones_procesadas": 8200.00,
  "monto_total_transacciones_no_procesadas": 1500.00
}

Campos:

Campo	Tipo	Descripción
`fecha`	`string`	Fecha y hora del procesamiento
`procesado`	`boolean`	`true` si el lote se procesó correctamente
`mensaje`	`string`	Descripción del resultado
`transacciones_procesadas`	`array`	IDs de operaciones ejecutadas con éxito
`transacciones_no_procesadas`	`array`	Operaciones fallidas con su motivo
`monto_total_transacciones_procesadas`	`number`	Suma de montos procesados (MXN)
`monto_total_transacciones_no_procesadas`	`number`	Suma de montos no procesados (MXN)

Creación de destinatario

Se dispara cuando se crea un nuevo destinatario en Finalitix.

Payload:

{
  "id_destinatario": 42,
  "nombre_destinatario": "Juan García López",
  "rfc_destinatario": "GALJ800101XYZ",
  "cuenta_clabe": "012345678901234567"
}

Campos:

Campo	Tipo	Descripción
`id_destinatario`	`integer`	ID único del destinatario en Finalitix
`nombre_destinatario`	`string`	Nombre completo del destinatario
`rfc_destinatario`	`string`	RFC del destinatario
`cuenta_clabe`	`string`	CLABE interbancaria del destinatario