Fidi X
  1. Create Account
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)
          POST
        • 201 - Create Account Success (With Parent)
          POST
        • 400 - Missing Name (F001)
          POST
        • 400 - Invalid Normal Balance (F001)
          POST
        • 400 - Invalid Ledger ID Format (F001)
          POST
        • 400 - Invalid Parent Account ID (F001)
          POST
        • 400 - Parent Account Not Found (F001)
          POST
        • 400 - Asset Ledger Mismatch (F001)
          POST
        • 500 - Internal Server Error (T001)
          POST
      • 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. Create Account

400 - Invalid Parent Account ID (F001)

POST
/fidix/v1/accounts

Solicitud

Autorización
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/json

Ejemplos

Respuestas

🟠400
application/json
Body

Solicitud Ejemplo de Solicitud
Shell
JavaScript
Java
Swift
curl --location --request POST '/fidix/v1/accounts' \
--header 'traceparent: 00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "parent_account_id": "invalid-uuid",
  "name": "Test Account",
  "ledger_id": "c2b5d3b8-6f5e-4b34-9c9b-2a5e2c1f7a10",
  "asset_id": "0e7f5c58-2b7a-4d2a-a2e1-9d9a6b3f1a23",
  "owner_id": "1f8g6d59-3c8b-5e3b-b3f2-0e0b7c4g2b34",
  "normal_balance": "DEBIT"
}'
Respuesta Ejemplo de Respuesta
{
  "error": {
    "code": "F001",
    "message": "invalid parent_account_id UUID",
    "details": {
      "error": "invalid UUID length: 12"
    }
  }
}
Modificado en 2025-12-22 18:20:19
Anterior
400 - Invalid Ledger ID Format (F001)
Siguiente
400 - Parent Account Not Found (F001)
Built with