{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/toku/json-schema/toku-customer-collection-account-create-payload-schema.json",
  "title": "CustomerCollectionAccountCreatePayload",
  "description": "Datos de la cuenta bancaria con la que se le cobrará a un Customer.",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/toku-customer-collection-accounts-api-openapi.yml#/components/schemas/CustomerCollectionAccountCreatePayload",
  "properties": {
    "account_number": {
      "description": "Número de la cuenta. Se normaliza quitando todo carácter que no sea alfanumérico.",
      "title": "Account Number",
      "type": "string"
    },
    "account_type": {
      "allOf": [
        {
          "$ref": "#/$defs/models__CustomerCollectionAccount__AccountType"
        }
      ],
      "description": "Tipo de la cuenta: `checking_account` es una cuenta corriente y `sight_account` una cuenta vista."
    },
    "currency_code": {
      "allOf": [
        {
          "$ref": "#/$defs/CurrencyIso"
        }
      ],
      "description": "Moneda en que se cobrará desde la cuenta. Si se omite, se usa la moneda por defecto del país de la organización."
    },
    "customer": {
      "description": "Customer al que se le cobrará desde esta cuenta.",
      "title": "Customer",
      "type": "string"
    },
    "government_id": {
      "description": "Identificador tributario del titular de la cuenta. Si se omite, se usa el del Customer.",
      "title": "Government Id",
      "type": "string"
    },
    "institution_id": {
      "allOf": [
        {
          "$ref": "#/$defs/Institution"
        }
      ],
      "description": "Institución financiera donde está la cuenta."
    },
    "subscription": {
      "description": "Subscription a la que aplica la cuenta. Si se omite, la cuenta queda registrada para todas las Subscriptions del Customer.",
      "title": "Subscription",
      "type": "string"
    }
  },
  "required": [
    "customer",
    "institution_id",
    "account_number",
    "account_type"
  ],
  "type": "object",
  "$defs": {
    "CurrencyIso": {
      "description": "Moneda, en código [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html). Cubre las monedas de los países donde Toku opera —`CLP` (peso chileno), `MXN` (peso mexicano) y `BRL` (real)— más `USD` y `CLF`, la Unidad de Fomento chilena. La moneda determina cuántos decimales admiten los montos: `CLP` no admite decimales, `MXN`, `BRL` y `USD` admiten dos, y `CLF` cuatro.",
      "enum": [
        "CLP",
        "CLF",
        "MXN",
        "BRL",
        "USD"
      ],
      "title": "CurrencyIso",
      "type": "string"
    },
    "Institution": {
      "description": "Institución financiera, identificada por un código propio de Toku con el país como prefijo (`cl_`, `mx_`). Cubre bancos, cajas, corredoras y billeteras digitales de Chile y México. `mock` existe solo para pruebas y no corresponde a ninguna institución real.\n\nEs un catálogo que crece al integrar instituciones nuevas, así que conviene leerlo como una lista abierta.",
      "enum": [
        "mock",
        "cl_banco_bbva",
        "cl_banco_bci",
        "cl_banco_bci_direct",
        "cl_banco_bci_360",
        "cl_banco_bice",
        "cl_banco_consorcio",
        "cl_banco_coopeuch",
        "cl_banco_corpbanca",
        "cl_banco_de_chile",
        "cl_banco_deutsche",
        "cl_banco_estado",
        "cl_banco_falabella",
        "cl_banco_hsbc",
        "cl_banco_internacional",
        "cl_banco_itau",
        "cl_banco_ripley",
        "cl_banco_santander",
        "cl_banco_scotiabank",
        "cl_banco_security",
        "cl_banco_superdigital",
        "cl_copec_pay",
        "cl_demo_bank",
        "cl_mercado_pago",
        "cl_prepago_los_heroes",
        "cl_tapp_caja_los_andes",
        "cl_fintual",
        "cl_tenpo",
        "cl_banco_btg_pactual",
        "cl_banco_paris",
        "cl_banco_penta",
        "cl_rabobank",
        "cl_hsbc_bank",
        "cl_banco_do_brasil",
        "cl_china_construction_bank",
        "cl_the_bank_of_tokyo",
        "cl_banco_de_la_nacion_argentina",
        "cl_jp_morgan_chase_bank",
        "mx_abc_capital",
        "mx_american_express_bank",
        "mx_ban_coppel",
        "mx_banca_afirme",
        "mx_banca_mifel",
        "mx_banco_actinver",
        "mx_banco_autofin",
        "mx_banco_azteca",
        "mx_banco_bancrea",
        "mx_banco_base",
        "mx_banco_compartamos",
        "mx_banco_covalto",
        "mx_banco_credit_suisse",
        "mx_banco_forjadores",
        "mx_banco_inbursa",
        "mx_banco_inmobiliario_mexicano",
        "mx_banco_invex",
        "mx_banco_jp_morgan",
        "mx_banco_keb_hana",
        "mx_banco_monex",
        "mx_banco_multiva",
        "mx_banco_paga_todo",
        "mx_banco_regional_de_monterrey",
        "mx_banco_s3_caceis_mexico",
        "mx_banco_sabadell",
        "mx_banco_santander",
        "mx_banco_shinhan_de_mexico",
        "mx_banco_ve_por_mas",
        "mx_banco_de_inversion_afirme",
        "mx_banco_del_bajio",
        "mx_bankaool",
        "mx_bank_of_america",
        "mx_bank_of_china",
        "mx_banorte",
        "mx_bansi",
        "mx_barclays_bank",
        "mx_banco_bbva",
        "mx_banco_bbva_bancomer",
        "mx_bnp_paribas",
        "mx_ci_banco",
        "mx_citibanamex",
        "mx_consubanco",
        "mx_deutsche_bank_mexico",
        "mx_fundacion_donde_banco",
        "mx_banco_hsbc",
        "mx_industrial_and_commercial_bank_of_china",
        "mx_intercam_banco",
        "mx_mizuho_bank",
        "mx_mufg_bank",
        "mx_banco_scotiabank",
        "mx_akala",
        "mx_arcus",
        "mx_asp_integra_opc",
        "mx_babien",
        "mx_banco_mext",
        "mx_banobras",
        "mx_caja_pop_mexica",
        "mx_caja_telefonist",
        "mx_cb_intercam",
        "mx_ci_bolsa",
        "mx_cls",
        "mx_codi_valida",
        "mx_credicapital",
        "mx_cristobal_colon",
        "mx_finamex",
        "mx_fincomun",
        "mx_fomped",
        "mx_fondo_fira",
        "mx_gbm",
        "mx_hipotecaria_fed",
        "mx_indeval",
        "mx_invercap",
        "mx_kuspit",
        "mx_libertad",
        "mx_masari",
        "mx_monex_cb",
        "mx_multivida_casa_de_bolsa",
        "mx_nafin",
        "mx_operadora_de_pagos_moviles",
        "mx_profuturo",
        "mx_stp",
        "mx_tactiv_casa_de_bolsa",
        "mx_unagra",
        "mx_valmex",
        "mx_value",
        "mx_vector_casa_de_bolsa",
        "mx_volkswagen_bank",
        "mx_reforma",
        "mx_tesored",
        "mx_nvio",
        "mx_alternativos",
        "mx_banco_de_mexico",
        "mx_banjercito",
        "mx_mercado_pago",
        "mx_cuenca",
        "mx_fondeadora"
      ],
      "title": "Institution",
      "type": "string"
    },
    "models__CustomerCollectionAccount__AccountType": {
      "description": "An enumeration.",
      "enum": [
        "checking_account",
        "sight_account"
      ],
      "title": "AccountType",
      "type": "string"
    }
  }
}