Crear Transacción

POST

/fidix/v1/transactions

Crea una nueva transacción entre cuentas. Las transacciones representan movimientos de fondos y deben seguir las reglas contables básicas.

Reglas de Transacciones:

Balance: La suma de todos los DEBIT debe ser igual a la suma de todos los CREDIT

Mínimo de Operaciones: Se requieren al menos 2 operaciones (una de DEBIT y una de CREDIT)

Saldo Suficiente: Las cuentas deben tener saldo suficiente para realizar la operación

Direcciones:

DEBIT: Aumenta el saldo en cuentas con balance normal DEBIT, disminuye en cuentas con balance normal CREDIT

CREDIT: Aumenta el saldo en cuentas con balance normal CREDIT, disminuye en cuentas con balance normal DEBIT

Idempotencia: Usa el header idempotency-key para evitar duplicar transacciones si la petición se envía múltiples veces.

El ID de la transacción creada se guardará en ${transaction_id}.

Solicitud

Autorización

JWT Bearer

Agregar el parámetro

Authorization

a Encabezados

Ejemplo:

Authorization: ********************

Parámetros de Header

Parámetros del Body application/jsonRequerido

Ejemplos

Respuestas

🟢201

application/json

Transacción creada exitosamente. El ID está en el campo id.

Importante: Guarda el valor de id en la variable ${transaction_id}.

Nota: La transacción puede disparar webhooks si están configurados.

Body

🟠400

🟠401

🟠404

🔴500

Ejemplo de Solicitud

Shell

JavaScript

Java

Swift

cURL

Transferencia simple entre dos cuentasTransacción con múltiples cuentas

curl --location --request POST 'https://api-preview.fidi.money/fidix/v1/transactions' \
--header 'traceparent: 00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01' \
--header 'idempotency-key: idemp-key-12345-67890' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "ledger_id": "c2b5d3b8-6f5e-4b34-9c9b-2a5e2c1f7a10",
    "reference_id": "ref-transfer-001",
    "currency": "CLP",
    "description": "Pago de servicio",
    "operations": [
        {
            "account_id": "4f5a2d7a-4c1e-4f2a-9e9a-1234567890ab",
            "direction": "DEBIT",
            "amount": "1500.00"
        },
        {
            "account_id": "5a1d2c3e-4f67-8901-2345-6789abcde012",
            "direction": "CREDIT",
            "amount": "1500.00"
        }
    ],
    "metadata": {
        "external_id": "ext-789"
    }
}'

Ejemplo de Respuesta

201 - Transacción creada exitosamente

{
    "id": "7c3d4e5f-6a89-0123-4567-890abcdef0123",
    "ledger_id": "c2b5d3b8-6f5e-4b34-9c9b-2a5e2c1f7a10",
    "reference_id": "ref-transfer-001",
    "currency": "CLP",
    "description": "Pago de servicio",
    "status": "completed",
    "operations": [
        {
            "account_id": "4f5a2d7a-4c1e-4f2a-9e9a-1234567890ab",
            "direction": "DEBIT",
            "amount": "1500.00"
        },
        {
            "account_id": "5a1d2c3e-4f67-8901-2345-6789abcde012",
            "direction": "CREDIT",
            "amount": "1500.00"
        }
    ],
    "metadata": {
        "external_id": "ext-789"
    },
    "created_at": "2025-01-10T12:00:00Z",
    "updated_at": "2025-01-10T12:00:00Z"
}

Modificado en 2026-01-10 20:33:00

Obtener Persona por ID

ErrorResponse