1. Transacciones
Fidi X Developer Preview
  • Fidi X
    • Introducción
    • Conceptos Fundamentales
    • Catálogo de APIs
      • Diccionario de Datos - Enumeraciones
      • Autenticación
        • Obtener Token de Acceso
      • Cuentas
        • Crear Cuenta
        • Obtener Cuenta por ID
        • Listar Cuentas por Ledger
        • Actualizar Cuenta
        • Eliminar Cuenta
        • Suspender Cuenta
        • Activar Cuenta
        • Obtener Balance de Cuenta
        • Obtener Cuentas linkeadas
        • Linkear Cuenta Bancaria
        • Deslinkear Cuenta Bancaria
      • Personas
        • Crear Persona
        • Listar Personas
        • Obtener Persona por ID
        • Actualizar datos de persona
        • Eliminar persona (soft delete)
        • Obtener jerarquía de persona
        • Bloquear persona y descendientes
        • Desbloquear persona y descendientes
      • Transacciones y Operaciones
        • Transacciones
          • Crear Retiros masivos
            POST
          • Obtener Transferencia Masiva
            GET
          • Crear Transacción
            POST
        • Operations
          • Listar Operaciones
      • Webhooks
        • Crear Suscripción Webhook
        • Listar Suscripciones
        • Obtener Suscripción
        • Actualizar Suscripción
        • Eliminar Suscripción
  • Casos de Uso
    • Cuentas Virtuales
      • Guía de implementación
      • Create Notification
  • Raíz
  1. Transacciones

Obtener Transferencia Masiva

Desarrollando
GET
/fidix/v1/withdrawals/{id}
Próximamente:
Consulta el detalle y el estado actual de un lote de retiros (withdrawals) previamente creado con POST /v1/withdrawals, identificado por su withdrawal_request_id.
Retorna los datos del lote y el detalle completo de cada retiro individual: datos de la cuenta bancaria destino, estado actual, motivo de falla (si corresponde) y el identificador de la transacción generada una vez que el retiro fue debitado en el ledger.
Uso típico
Como el procesamiento de los retiros es asíncrono, este endpoint se usa para hacer seguimiento del lote después de crearlo: estado general, retiros debitados en el ledger, retiros fallidos con su motivo y retiros reversados por rechazo bancario.
Validaciones
id debe ser un UUID válido; de lo contrario retorna 400.
El endpoint no recibe body ni query params.

Este servicio puede recibir modificaciones

Solicitud

Autorización
JWT Bearer
Agregar el parámetro
Authorization
a Encabezados
Ejemplo:
Authorization: ********************
or
Parámetros de ruta

Parámetros de Header

Respuestas

🟢200
application/json
Bodyapplication/json

🟠400
🟠401
🟠404
🔴500
Solicitud Ejemplo de Solicitud
Shell
JavaScript
Java
Swift
curl --location 'https://sandbox.fidi.money/fidix/v1/withdrawals/7c9e6679-7425-40de-944b-e07fc1f90ae7' \
--header 'traceparent: 00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01' \
--header 'x-api-key: {{apikey}}' \
--header 'Authorization: Bearer <token>'
Respuesta Ejemplo de Respuesta
200 - Ejemplo 1
{
    "data": {
        "withdrawal_request_id": "db3f8941-a40d-492b-bb9e-fd09e0119f70",
        "withdrawal_reference_id": "WD-REF-2026-001",
        "ledger_id": "4c72ccf9-9bf3-4e2d-911e-90834e1c7c26",
        "account_number": "001111213543",
        "bank_sponsor": "INTERNACIONAL",
        "status": "partially_completed",
        "withdrawals": [
            {
                "id": "8fcf5083-b806-4b8c-8f3f-3a0fdbd3d6f9",
                "account_id": "12fbb9da-673a-452c-9104-ae0d8216c154",
                "reference_id": "WD-ITEM-001",
                "amount": "15.00",
                "currency": "CLP",
                "description": "Pago de Recaudacion",
                "dest_bank_code": "009",
                "dest_account_number": "1234567890",
                "dest_account_type": "checking_account",
                "dest_customer_identification": "27453678-9",
                "dest_customer_name": "Enel",
                "dest_customer_email": "pagos@ejemplo.cl",
                "status": "ledger_completed",
                "corex_transaction_id": "5a1c9e2f-7b3d-4c8a-9f6e-2d4b8a1c7e30",
                "created_at": "2026-07-14T20:56:26Z",
                "updated_at": "2026-07-14T21:02:10Z"
            },
            {
                "id": "4b1e2c7a-9d3f-4a6b-8e5c-2f7a1d9c3b40",
                "account_id": "61d37283-e3c0-41fc-9266-4e2ea08fc70f",
                "reference_id": "WD-ITEM-002",
                "amount": "25.00",
                "currency": "CLP",
                "dest_bank_code": "037",
                "dest_account_number": "9876543210",
                "dest_account_type": "sight_account",
                "dest_customer_identification": "17487278-9",
                "dest_customer_name": "Movistar",
                "status": "failed",
                "error_code": "B301",
                "error_detail": "Insufficient funds",
                "created_at": "2026-07-14T20:56:26Z",
                "updated_at": "2026-07-14T21:02:10Z"
            }
        ],
        "processed_at": "2026-07-14",
        "created_at": "2026-07-14T20:56:26Z",
        "updated_at": "2026-07-14T21:02:10Z"
    }
}
Modificado en 2026-11-03 21:13:55
Anterior
Crear Retiros masivos
Siguiente
Crear Transacción
Built with