Create Notification

POST

/fidix/v1/transactions/notification

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 genera un evento transfer.received

Se envían notificaciones (formato SNS) a las suscripciones activas que escuchan transfer.received

Solicitud

Autorización

Bearer Token

Proporciona tu token bearer en el encabezado

Authorization

al realizar solicitudes a recursos protegidos.

Ejemplo:

Authorization: Bearer ********************

Parámetros de Header

Parámetros del Body application/jsonRequerido

Ejemplos

Respuestas

🟢201

application/json

Bodyapplication/json

🟠400

🟠401

🟠403

🟠404

🔴500

Ejemplo de Solicitud

Shell

JavaScript

Java

Swift

curl --location 'https://sandbox.fidi.money/fidix/v1/transactions/notification' \
--header 'traceparent: 00-4302c90706e344fbbaafad7b75844103-00f067aa0ba902b7-01' \
--header 'Idempotency-Key: 4302c907-06e3-44fb-baaf-ad7b75844103' \
--header 'X-API-Minor-Version: 1.0.0' \
--header 'x-api-key: {{apikey}}' \
--header 'x-api-key: {{apikey}}' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "virtual_account_alias": "901000000008",
    "amount": "1.00",
    "currency": "CLP",
    "bank_transfer_id": "0030000000000010000000000000000003",
    "executed_at": "2026-02-26T10:30:00Z",
    "status": "A",
    "description": "Transferencia Banco Chile",
    "accounting_date": "2026-02-26",
    "origin": {
        "bank_code": "",
        "account_number": 123456789012,
        "customer_identification": "17547898-9"
    },
    "destination": {
        "bank_code": "",
        "account_number": 123456789,
        "customer_identification": "19547456-9"
    },
    "metadata": {
        "id_cca": "000000000001"
    }
}'

Ejemplo de Respuesta

201 - Éxito

{
    "data": {
        "transaction_id": "9ad9118f-fd9a-4685-9576-577619172cb9",
        "bank_transfer_id": "0030000000000010000000000000000003",
        "idempotency_key": "4302c907-06e3-44fb-baaf-ad7b75844103",
        "account_id": "ba3483c2-373d-4884-a7d4-a588e4f6158b",
        "received_at": "2026-02-26T18:49:52Z",
        "status": "POSTED",
        "created_at": "2026-02-26T18:49:52Z"
    }
}

Modificado en 2026-06-05 16:43:20

Guía de implementación