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. La respuesta viene envuelta en data. El ID está en data.id; el reference_id generado en data.reference_id (formato TXN-YYYY-MMDD-NNN). Guarda data.id en ${transaction_id}. La transacción puede disparar webhooks si están configurados.

Bodyapplication/json

🟠400

🟠401

🟠403

🟠404

🟠409

🟠422

🔴500

🔴502

Ejemplo de Solicitud

Shell

JavaScript

Java

Swift

cURL

Transferencia simple (P2P)Ingreso de efectivo (CASH_IN)Transacción con múltiples cuentas

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

Ejemplo de Respuesta

201 - Transacción creada (formato nuevo)

{
    "data": {
        "id": "7c3d4e5f-6a89-0123-4567-890abcdef0123",
        "reference_id": "TXN-2026-0204-001",
        "ledger_id": "c2b5d3b8-6f5e-4b34-9c9b-2a5e2c1f7a10",
        "asset_code": "CLP",
        "type": "P2P",
        "amount": 1500,
        "currency": "CLP",
        "status": "posted",
        "metadata": {
            "external_id": "ext-789"
        },
        "created_at": "2026-02-04T12:00:00Z",
        "updated_at": "2026-02-04T12:00:00Z",
        "posted_at": "2026-02-04T12:00:00Z"
    }
}

Modificado en 2026-07-28 13:02:50

Transacciones y Operaciones

Listar Operaciones