Simular Transferencia Externa Entrante

POST

/fidix/v1/webhooks/simulate/transfer

Simula una transferencia externa entrante al sistema. Este endpoint es útil para testing y demostración.

Cuando se procesa una transferencia externa:

Se crea un registro de transacción externa

Se actualiza el balance de la cuenta destino

Se genera un evento transfer.received

Se envían webhooks a todas las suscripciones activas que escuchan transfer.received

Flujo completo:

Crea una suscripción de webhook para transfer.received

Simula una transferencia usando este endpoint

Verifica que tu endpoint receptor recibió el webhook

Consulta el balance de la cuenta para confirmar que se actualizó

Uso de Variables: Guarda el transaction_id en ${external_transaction_id}.

Solicitud

Autorización

JWT Bearer

Agregar el parámetro

Authorization

a Encabezados

Ejemplo:

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

Parámetros del Body application/jsonRequerido

Ejemplos

Respuestas

🟢201

application/json

Transferencia simulada y procesada exitosamente

Body

🟠400

🟠401

🟠403

Ejemplo de Solicitud

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api-preview.fidi.money/fidix/v1/webhooks/simulate/transfer' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "from_account": {
        "name": "Banco Externo S.A.",
        "bank_code": "BANCO001"
    },
    "to_account_id": "4f5a2d7a-4c1e-4f2a-9e9a-1234567890ab",
    "amount": "10000.00",
    "currency": "CLP",
    "reference": "REF-TRANSFER-001",
    "description": "Transferencia de prueba"
}'

Ejemplo de Respuesta

201 - success

{
    "transaction_id": "9b0c1d2e-3f4a-5b6c-7d8e-9f0a1b2c3d4e5",
    "status": "completed",
    "to_account_id": "4f5a2d7a-4c1e-4f2a-9e9a-1234567890ab",
    "amount": "10000.00",
    "currency": "CLP",
    "reference": "REF-TRANSFER-001",
    "processed_at": "2026-01-14T10:15:00Z"
}

Modificado en 2026-01-14 21:16:18

Listar Eventos de Webhook Enviados

ErrorResponse