1. Autenticación
Fidi X Developer Preview
  • Fidi X
    • Diccionario de Datos - Enumeraciones
    • Autenticación
      • Obtener Token de Acceso
        POST
    • 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
    • Personas
      • Crear Persona
      • Listar Personas
      • Obtener Persona por ID
      • Obtener jerarquía de persona
      • Bloquear persona y descendientes
      • Desbloquear persona y descendientes
      • Actualizar datos de persona
      • Eliminar persona (soft delete)
    • Transacciones
      • Crear Transacción
      • Create Notification
    • Operaciones
      • Listar Operaciones
    • Webhooks
      • Crear Suscripción Webhook
      • Listar Suscripciones
      • Obtener Suscripción
      • Actualizar Suscripción
      • Eliminar Suscripción
  • Schemas
    • CreateSubscriptionRequest
    • Person
    • LinkBankAccountRequest
    • PersonHierarchyResponse
    • UpdateAccountRequest
    • UpdateSubscriptionRequest
    • LinkBankAccountResponse
    • BlockPersonDataResponse
    • HTTPValidationError
    • CreateAccountRequest
    • DeliveryInfo
    • TransactionDataResponse
    • AssetResponse
    • AuthResponse
    • WebhookEventType
    • CreateTransactionRequest
    • ErrorResponse
    • AccountResponse
    • BalanceResponse
    • CreatePersonRequest
    • PersonResponse
    • TransactionOperation
    • CreateWebhookSubscriptionRequest
    • WebhookSubscriptionResponse
    • UpdateWebhookSubscriptionRequest
    • SubscriptionResponse
    • LinkBankAccountDataResponse
    • CreateAssetRequest
    • SubscriptionListResponse
    • AssetListResponse
    • WebhookSubscriptionListResponse
    • AccountDetailResponse
    • TransactionCreateResponse
    • WebhookEventTypesResponse
    • LedgerResponse
    • WebhookEventsListResponse
    • WebhookEventRecord
    • PersonDataResponse
    • SimulateExternalTransferRequest
    • PersonListResponse
    • SimulateExternalTransferResponse
    • TransactionResponse
  1. Autenticación

Obtener Token de Acceso

POST
/fidix/v1/auth/token
Autentica un cliente usando el flujo OAuth 2.0 Client Credentials y retorna un token JWT de acceso.
📌 Importante:
Fidi proveerá las credenciales para poder utilizar en este Developer Preview. Se enviarán un client_id y un client_secret, y se contará con entidades pre-cargados diferentes entidades para facilitar el uso (las que aparecen en esta documentación)

Credenciales y x-api-key
client_id: utilizar las credenciales provistas por Fidi
client_secret: utilizar las credenciales provistas por Fidi
x-api-key (header): será provista por Fidi junto con las credenciales para el Developer Preview
Scopes disponibles (formato resource:permission):
accounts:r - Leer cuentas
accounts:w - Crear/actualizar/eliminar cuentas
accounts:rw - Lectura + escritura
persons:r - Leer personas
persons:w - Crear/actualizar/eliminar personas
persons:rw - Lectura + escritura
transactions:w - Crear transacciones
balances:r - Leer balances
webhooks:r - Leer suscripciones y eventos
webhooks:w - Crear/actualizar/eliminar suscripciones
webhooks:rw - Lectura + escritura
assets:r - Leer assets
assets:w - Crear/actualizar assets
assets:rw - Lectura + escritura
ledgers:w - Actualizar estado de ledgers
El token obtenido debe guardarse en la variable ${access_token} para usarlo en los siguientes requests.

Solicitud

Parámetros de Header

Parámetros del Body application/x-www-form-urlencodedRequerido

Respuestas

🟢200
application/json
Token de acceso generado exitosamente. El token está incluido en el campo access_token y debe ser guardado para su uso en los siguientes requests.
Importante: Guarda el valor de access_token en la variable ${access_token} para usarlo en los headers de autenticación.
Body

🟠400
🟠401
Solicitud Ejemplo de Solicitud
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://sandbox.fidi.money/fidix/v1/auth/token' \
--header 'x-api-key: {{apikey}}' \
--data-urlencode 'grant_type=client_credentials' \
--data-urlencode 'client_id=' \
--data-urlencode 'client_secret='
Respuesta Ejemplo de Respuesta
200 - Autenticación exitosa
{
    "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiI3YzRhZTI1MS1mZGIyLTQwZjgtOTRkYS1lN2I4YmYxYjQzYjEiLCJjbGllbnRfaWQiOiI3YzRhZTI1MS1mZGIyLTQwZjgtOTRkYS1lN2I4YmYxYjQzYjEiLCJzY29wZSI6ImFjY291bnRzOmNyZWF0ZSBwZXJzb25zOmNyZWF0ZSBwZXJzb25zOnJlYWQgdHJhbnNhY3Rpb25zOmNyZWF0ZSBiYWxhbmNlczpyZWFkIiwiZXhwIjoxNzM2NTUwMDAwfQ.example-signature",
    "expires_in": 300,
    "refresh_expires_in": 0,
    "token_type": "Bearer",
    "not-before-policy": 0,
    "scope": "accounts:rw persons:rw transactions:w balances:r"
}
Modificado en 2026-02-20 18:48:55
Anterior
Autenticación
Siguiente
Crear Cuenta
Built with