Fidi X Developer Preview
  1. Autenticación
Fidi X Developer Preview
  • Raíz
    • Autenticación
      • Obtener Token de Acceso
        POST
    • Cuentas
      • Crear Cuenta
      • Obtener Cuenta por ID
    • Balances
      • Obtener Balance de Cuenta
    • Personas
      • Crear Persona
      • Listar Personas
      • Obtener Persona por ID
    • Transacciones
      • Crear Transacción
  • Schemas
    • ErrorResponse
    • AuthResponse
    • CreateAccountRequest
    • AccountResponse
    • AccountDetailResponse
    • BalanceResponse
    • CreatePersonRequest
    • PersonResponse
    • PersonDataResponse
    • PersonListResponse
    • TransactionOperation
    • CreateTransactionRequest
    • TransactionResponse
  1. Autenticación

Obtener Token de Acceso

POST
/fidix/v1/auth
Autentica un cliente usando el flujo OAuth 2.0 Client Credentials y retorna un token JWT de acceso.
Credenciales de Ejemplo:
client_id: 7c4ae251-fdb2-40f8-94da-e7b8bf1b43b1
client_secret: 4d3c8b2f-7a4b-4e6a-9b6f-8b2c9a1d7f5e
Scopes disponibles:
accounts:create - Crear cuentas
accounts:read - Leer cuentas
persons:create - Crear personas
persons:read - Leer personas
transactions:create - Crear transacciones
balances:read - Leer balances
El token obtenido debe guardarse en la variable ${access_token} para usarlo en los siguientes requests.

Solicitud

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://api-preview.fidi.money/fidix/v1/auth' \
--data-urlencode 'grant_type=client_credentials' \
--data-urlencode 'client_id=7c4ae251-fdb2-40f8-94da-e7b8bf1b43b1' \
--data-urlencode 'client_secret=4d3c8b2f-7a4b-4e6a-9b6f-8b2c9a1d7f5e'
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:create persons:create persons:read transactions:create balances:read"
}
Modificado en 2026-01-10 20:33:00
Siguiente
Crear Cuenta
Built with