> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cbpayapp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Catálogos para formularios de compliance

> Devuelve todos los catálogos (listas de pares value/label) que el front debe usar para construir formularios de compliance y verificación consistentes: géneros, estados de empresa, tipos de dirección, formas jurídicas (lista global más cascada por país), fuentes de ingreso/patrimonio, estándares de industria con su default por país, y las listas ISO-3166 completas de países y subdivisiones. Data estática — seguro cachearla por horas. `value` es lo que envías a la API; `label` lo que muestras.



## OpenAPI

````yaml /openapi.es.yaml get /v1/aml/catalogs
openapi: 3.1.0
info:
  title: CBPay API
  version: '1.89'
  description: |
    CBPay es una plataforma de pagos multimoneda: payouts y cobros fiat
    en toda América Latina, transferencias internas, fondeo y retiros
    on-chain, y screening KYC. Cada cuenta mantiene cuatro saldos virtuales
    independientes — USDT (la moneda operativa), USDC, BTC y GOLD (gramos de
    oro fino) — que nunca se mezclan ni se convierten automáticamente.
    Los payouts y las comisiones de servicios pueden pagarse desde cualquiera
    de los cuatro saldos: define un predeterminado con `PUT /v1/settlement` o
    haz override por payout con `settlement_asset`.

    Todos los montos son strings decimales en la precisión de cada moneda (6
    decimales para USDT/USDC/GOLD, 8 para BTC). Los errores siempre devuelven
    `{"error": "<code>", "message": "<detail>"}`.
servers:
  - url: https://api.qbank.cl/platform
    description: Live (producción, dinero real)
  - url: https://cryptobank.qbank.cl/platform
    description: Test (sandbox, dinero simulado — keys pk_test_)
security:
  - bearerAuth: []
tags:
  - name: Comprobantes
    description: >-
      Comprobante PDF brandeado por operacion, con verificacion publica de
      autenticidad (QR firmado), receipt_url en cada respuesta/webhook y envio
      automatico por email en estados finales.
  - name: Autenticación
    description: >-
      Registra e inicia sesión de los miembros de la cuenta. Las sesiones duran
      24 horas.
  - name: Cuenta
    description: Perfil, miembros y llaves de API de la cuenta que llama.
  - name: Saldos
    description: Saldos, historial de movimientos y tasas de cambio.
  - name: Payouts
    description: >-
      Dispersiones fiat que se debitan del saldo de settlement que elijas (USDT
      por defecto).
  - name: Payins
    description: Recargas fiat que se acreditan al saldo en USDT.
  - name: Transferencias
  - name: Contacts
  - name: Swaps
    description: >-
      Transferencias internas gratuitas entre cuentas CBPay (persona o empresa,
      cualquier combinación).
  - name: Crypto
    description: Fondeo y retiros on-chain (TRON, Ethereum y Bitcoin).
  - name: Wallets segregadas
    description: >-
      Wallets on-chain con saldo propio (empresas ilimitadas; personas 1 por
      combinación red+activo) — crear, importar, enviar, exportar la llave
      privada y auto-forward. El saldo vive on-chain, nunca en el ledger.
  - name: QR Crypto POS
    description: >-
      Cobros QR crypto con monto para procesadores con POS físicos (cuentas
      empresa): merchants verificados, dirección exclusiva + QR por cobro,
      detección temprana del pago, conciliación por merchant y devoluciones por
      el riel de retiro crypto.
  - name: KYC / KYB
  - name: Screening de wallets
    description: >-
      Evaluación de riesgo AML de direcciones blockchain (sanciones, exposición
      a fondos ilícitos) con comisión por scan, más protección automática
      gratuita en retiros y depósitos.
  - name: AML screening
    description: >-
      Verificación de identidad: KYC para personas, KYB para empresas, con
      screening AML, re-screening y monitoreo continuo.
  - name: Analytics
  - name: Webhooks
    description: Suscripciones para recibir notificaciones de eventos firmadas.
  - name: Estado
    description: Disponibilidad del servicio.
  - name: Banking
    description: >-
      Cuentas bancarias reales: recibe, mantén y envía dinero por rieles
      bancarios internacionales.
  - name: Cards
    description: >-
      Tarjetas virtuales y físicas que gastan Just-In-Time del saldo USDT de la
      cuenta, con límites de gasto por tarjeta.
  - name: Seguridad (OTP)
    description: >-
      Códigos de verificación de un solo uso por SMS/WhatsApp/email que protegen
      acciones sensibles, más las preferencias de 2FA self-service. Aplican solo
      a sesiones de usuario — las API keys quedan exentas.
  - name: Passkeys
    description: >-
      Inicio de sesión sin contraseña con la biometría del dispositivo (Face ID,
      Touch ID, Windows Hello, llaves de seguridad) vía WebAuthn, apps
      autenticadoras (TOTP) con códigos de respaldo, y gestión de
      sesiones/dispositivos.
  - name: Login social
    description: >-
      Registro e inicio de sesión sin contraseña con Google, Apple, Microsoft y
      Facebook vía token exchange. El front obtiene la credencial del proveedor;
      la API la verifica y emite la sesión CBPay.
paths:
  /v1/aml/catalogs:
    get:
      tags:
        - AML screening
      summary: Catálogos para formularios de compliance
      description: >-
        Devuelve todos los catálogos (listas de pares value/label) que el front
        debe usar para construir formularios de compliance y verificación
        consistentes: géneros, estados de empresa, tipos de dirección, formas
        jurídicas (lista global más cascada por país), fuentes de
        ingreso/patrimonio, estándares de industria con su default por país, y
        las listas ISO-3166 completas de países y subdivisiones. Data estática —
        seguro cachearla por horas. `value` es lo que envías a la API; `label`
        lo que muestras.
      operationId: getAmlCatalogs
      responses:
        '200':
          description: Todos los catálogos más un bloque `meta` que describe las cascadas.
          content:
            application/json:
              schema:
                type: object
                properties:
                  genders:
                    type: array
                    description: Valores exactos requeridos al screenear personas.
                    items:
                      $ref: '#/components/schemas/CatalogItem'
                  company_status:
                    type: array
                    items:
                      $ref: '#/components/schemas/CatalogItem'
                  address_types:
                    type: array
                    items:
                      $ref: '#/components/schemas/CatalogItem'
                  company_types:
                    type: array
                    description: >-
                      Lista plana de formas jurídicas (idioma local oficial)
                      como fallback.
                    items:
                      $ref: '#/components/schemas/CatalogItem'
                  source_of_income:
                    type: array
                    items:
                      $ref: '#/components/schemas/CatalogItem'
                  source_of_wealth:
                    type: array
                    items:
                      $ref: '#/components/schemas/CatalogItem'
                  industries:
                    type: array
                    items:
                      $ref: '#/components/schemas/CatalogItem'
                  industry_code_types:
                    type: array
                    items:
                      $ref: '#/components/schemas/CatalogItem'
                  company_types_by_country:
                    type: object
                    description: >-
                      Formas jurídicas por país ISO (GLEIF ELF); si el país
                      falta, usar `company_types`.
                  industries_by_code_type:
                    type: object
                    description: >-
                      Códigos de industria por estándar (`value` = código,
                      `label` = descripción).
                  industry_code_type_by_country:
                    type: object
                    description: Estándar de industria fijado por país (default ISIC).
                  countries:
                    type: array
                    description: Países ISO-3166-1.
                    items:
                      $ref: '#/components/schemas/CatalogItem'
                  country_subdivisions:
                    type: object
                    description: Subdivisiones ISO-3166-2 por país.
                  meta:
                    type: object
                    description: >-
                      Conteos más una nota que describe cómo se encadenan las
                      cascadas.
              example:
                genders:
                  - value: male
                    label: Male
                  - value: female
                    label: Female
                company_status:
                  - value: active
                    label: Active
                address_types:
                  - value: residential
                    label: Residential
                company_types:
                  - value: Sociedad Anónima
                    label: Sociedad Anónima
                source_of_income:
                  - value: salary
                    label: Salary
                source_of_wealth:
                  - value: business_ownership
                    label: Business ownership
                industries:
                  - value: financial_services
                    label: Financial services
                industry_code_types:
                  - value: ISIC
                    label: ISIC Rev.4
                company_types_by_country:
                  CL:
                    - value: Sociedad por Acciones
                      label: Sociedad por Acciones
                industries_by_code_type:
                  ISIC:
                    - value: '6419'
                      label: Other monetary intermediation
                industry_code_type_by_country:
                  CL: ISIC
                countries:
                  - value: CL
                    label: Chile
                country_subdivisions:
                  CL:
                    - value: CL-RM
                      label: Región Metropolitana de Santiago
                meta:
                  country_count: 249
                  note: value = send to the API; label = display in the UI.
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/AccountRequired'
components:
  schemas:
    CatalogItem:
      type: object
      description: >-
        Una entrada de catálogo — `value` es lo que envías a la API, `label` lo
        que muestras.
      properties:
        value:
          type: string
          example: CL
        label:
          type: string
          example: Chile
    Error:
      type: object
      properties:
        error:
          type: string
          description: Código de error legible por máquina (snake_case).
          example: insufficient_funds
        message:
          type: string
          description: Explicación legible por humanos.
  responses:
    Unauthorized:
      description: Credencial faltante o inválida (`unauthorized`).
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: unauthorized
            message: invalid or missing credentials
    AccountRequired:
      description: Este endpoint requiere una credencial de cuenta (`account_required`).
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: account_required
            message: this endpoint requires an account credential
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: |
        JWT de sesión (de register/login) o llave de API (`pk_...`).
        `X-API-Key: <token>` se acepta como header alternativo.

````