Fidi X
  1. Fidi X - API's Core Wallet
Fidi X
  • Fidi X - API's Core Wallet
    • Diccionario de Datos – Enumeraciones
    • Auth
      • Login
        • Get Access Token
    • Personas
      • Create Person
        • Create Natural Person (Complete)
        • Create Legal Person (Company)
        • Create Natural Person with Parent
      • Get Person
        • Get Person by ID
        • Get Person Hierarchy
      • List Persons
        • List All Persons
        • List Natural Persons Only
        • List Legal Persons Only
        • List Active Persons Only
      • Update Person
        • Update Natural Person
        • Update Legal Person
        • Update Person Status
      • Block & Unblock Person
        • Block Person and Descendants
        • Unblock Person and Descendants
      • Delete Person
        • Delete Person (Soft Delete)
    • Ledgers
      • Disable Ledger
        • 200 - Disable Ledger Success
        • 400 - Invalid Ledger ID (F006)
        • 404 - Ledger Not Found (F003)
        • 500 - Internal Server Error (T001)
      • Activate Ledger
        • 200 - Activate Ledger Success
        • 400 - Invalid Ledger ID (F006)
        • 400 - Invalid Action (F006)
        • 404 - Ledger Not Found (F003)
        • 500 - Internal Server Error (T001)
    • Assets
      • Create Asset
        • 201 - Create Asset Success (Fiat)
        • 201 - Create Asset Success (Crypto)
        • 201 - Create Asset Success (Points)
        • 400 - Missing Ledger ID (F001)
        • 400 - Missing Code (F001)
        • 400 - Missing Asset Type (F001)
        • 400 - Invalid Asset Type (F001)
        • 400 - Invalid Ledger ID Format (F001)
        • 400 - Code Too Long (F001)
        • 404 - Ledger Not Found (F003)
        • 409 - Duplicate Asset Code (F004)
        • 500 - Internal Server Error (T001)
      • Get Assets by Ledger
        • 200 - Get Assets Success (With Results)
        • 200 - Get Assets Success (Empty)
        • 400 - Missing Ledger ID (F005)
        • 400 - Invalid Ledger ID Format (F002)
        • 500 - Internal Server Error (T005)
      • Get Asset by ID
        • 200 - Get Asset Success
        • 400 - Invalid Asset ID Format (F002)
        • 404 - Asset Not Found (T006)
        • 500 - Internal Server Error (T007)
      • Activate Asset
        • 200 - Activate Asset Success
        • 400 - Invalid Asset ID (F002)
        • 400 - Invalid Action (F002)
        • 404 - Asset Not Found (F003)
        • 409 - Ledger Not Found (F003)
        • 500 - Internal Server Error (T001)
      • Disable Asset
        • 200 - Disable Asset Success
        • 400 - Invalid Asset ID (F002)
        • 404 - Asset Not Found (F003)
        • 409 - Ledger Not Found (F003)
        • 500 - Internal Server Error (T001)
    • Cuentas
      • Create Account
        • 201 - Create Account Success (Without Parent)
        • 201 - Create Account Success (With Parent)
        • 400 - Missing Name (F001)
        • 400 - Invalid Normal Balance (F001)
        • 400 - Invalid Ledger ID Format (F001)
        • 400 - Invalid Parent Account ID (F001)
        • 400 - Parent Account Not Found (F001)
        • 400 - Asset Ledger Mismatch (F001)
        • 500 - Internal Server Error (T001)
      • Get Account by ID
        • 200 - Get Account Success
        • 400 - Invalid Account ID Format (F001)
        • 404 - Account Not Found (F003)
        • 500 - Internal Server Error (T001)
      • Get Accounts by Ledger
        • 200 - Get Accounts Success (With Results)
        • 200 - Get Accounts Success (Empty)
        • 400 - Missing Ledger ID (F005)
        • 400 - Invalid Ledger ID Format (F006)
        • 500 - Internal Server Error (T002)
      • Update Account
        • 200 - Update Account Success
        • 400 - Invalid Account ID Format (F001)
        • 400 - Invalid Request Body (F002)
        • 400 - Name Empty (F005)
        • 404 - Account Not Found (F003)
        • 500 - Internal Server Error (T001)
      • Suspend Account
        • 200 - Suspend Account Success
        • 400 - Invalid Account ID (F002)
        • 400 - Invalid Action (F002)
        • 404 - Account Not Found (F003)
        • 409 - Account Closed (F004)
        • 500 - Internal Server Error (T001)
      • Activate Account
        • 200 - Activate Account Success
        • 400 - Invalid Account ID (F002)
        • 404 - Account Not Found (F003)
        • 409 - Account Closed (F004)
        • 500 - Internal Server Error (T001)
      • Close Account
        • 200 - Close Account Success
        • 400 - Invalid Account ID (F002)
        • 404 - Account Not Found (F003)
        • 500 - Internal Server Error (T001)
      • Get Balance by Account ID
        • 200 - Get Balance Success
        • 400 - Invalid Account ID Format (F001)
        • 404 - Account Not Found (F003)
        • 404 - Balance Not Found (F004)
        • 500 - Internal Server Error (T001)
    • Transacciones
      • Create Transaction
        • 201 - Create Transaction Success
        • 400 - Missing traceparent (F001)
        • 400 - Invalid UUID in payload (F002)
        • 201 - Idempotency: Return stored response (idem-001)
        • 409 - Idempotency conflict: same key, different payload (T002)
        • 409 - Duplicate reference_id for ledger (T003)
        • 400 - Invalid payload: debit/credit mismatch (F003)
        • 403 - Ledger not found or disabled (F004)
        • 403 - Account invalid or inactive (F004)
        • 400 - Asset/Currency mismatch (F005)
        • 409 - Authorization rules not satisfied (T001)
        • 500 - Failed to update balance after retries (T004)
        • 500 - Unexpected internal error (T004)
  1. Fidi X - API's Core Wallet

Diccionario de Datos – Enumeraciones

Esta sección reúne los campos enumerados más relevantes utilizados por los servicios del Ledger de FIDI X.
Estos valores son usados transversalmente en los endpoints de Ledgers, Assets, Accounts y Transactions, tanto en requests como responses.

Ledger#

ledger_status#

Estado operativo del ledger.
ValorDescripción
ACTIVELedger habilitado para operaciones
DISABLEDLedger deshabilitado; no permite transacciones

Assets#

asset_type#

Tipo de instrumento de valor asociado a un ledger.
ValorDescripción
fiatMoneda fiat (ej: ARS, USD)
cryptoCriptoactivo (ej: BTC)
pointsPuntos o unidades no monetarias

asset_status#

Estado del asset dentro del ledger.
ValorDescripción
enabledAsset habilitado
disabledAsset deshabilitado para nuevas operaciones

Accounts#

account_status#

Estado de la cuenta contable.
ValorDescripción
activeCuenta habilitada
suspendCuenta deshabilitada
closedCuenta cerrada

normal_balance#

Naturaleza contable de la cuenta.
ValorDescripción
DEBITLa cuenta incrementa con débitos
CREDITLa cuenta incrementa con créditos

Transactions#

transaction_status#

Estado de una transacción contable.
ValorDescripción
IN_PROCESSTransacción en procesamiento
POSTEDTransacción contabilizada exitosamente
REJECTEDTransacción rechazada por reglas de dominio
FAILEDTransacción fallida por error técnico

operation_direction#

Dirección contable de una operación.
ValorDescripción
DEBITDisminuye el saldo de la cuenta
CREDITIncrementa el saldo de la cuenta

Reglas transversales#

Los enums no son case-sensitive.
Los valores enumerados deben corresponder exactamente a los valores permitidos, independientemente de mayúsculas o minúsculas.
Un valor que no pertenezca al conjunto definido genera error de validación (400 Bad Request).
Los enums forman parte del contrato público de la API.
Este diccionario debe ser utilizado como referencia oficial para la integración con los endpoints del Ledger de FIDI X.
Modificado en 2025-12-23 22:03:24
Anterior
Fidi X - API's Core Wallet
Siguiente
Auth
Built with