> ## 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.

# Cotizar un link de cobro antes de elegir (público)

> Cotizaciones indicativas de un link de cobro universal ANTES de materializar — el catálogo de países con métodos fiat vivos (tarjeta excluida — ver `cards`), las opciones de tarjeta listadas aparte por país+moneda en `cards[]` con el monto adeudado cotizado (un corredor puede aceptar varias monedas de cargo, ej. BOB y USD), el monto adeudado por opción crypto (con el costo de conversión incluido cuando el asset de pago difiere del de settlement) y los montos de pago directo CBPay por saldo habilitado. Cada país lista sus corredores en `options[]` — una fila por método+moneda (un país puede ofrecer el mismo método en varias monedas, ej. QR en BOB y USD) con `collect: true` en los métodos pull que piden los datos del pagador en la página (ver `POST /pay/{token}/collect`). Con `?country=XX` devuelve además el monto local cotizado por opción de ese país. La materialización congela la cotización definitiva. Sin credenciales; rate limit por IP.



## OpenAPI

````yaml /openapi.es.yaml get /pay/{token}/quote
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:
  /pay/{token}/quote:
    get:
      tags:
        - Payins
      summary: Cotizar un link de cobro antes de elegir (público)
      description: >-
        Cotizaciones indicativas de un link de cobro universal ANTES de
        materializar — el catálogo de países con métodos fiat vivos (tarjeta
        excluida — ver `cards`), las opciones de tarjeta listadas aparte por
        país+moneda en `cards[]` con el monto adeudado cotizado (un corredor
        puede aceptar varias monedas de cargo, ej. BOB y USD), el monto adeudado
        por opción crypto (con el costo de conversión incluido cuando el asset
        de pago difiere del de settlement) y los montos de pago directo CBPay
        por saldo habilitado. Cada país lista sus corredores en `options[]` —
        una fila por método+moneda (un país puede ofrecer el mismo método en
        varias monedas, ej. QR en BOB y USD) con `collect: true` en los métodos
        pull que piden los datos del pagador en la página (ver `POST
        /pay/{token}/collect`). Con `?country=XX` devuelve además el monto local
        cotizado por opción de ese país. La materialización congela la
        cotización definitiva. Sin credenciales; rate limit por IP.
      operationId: checkoutQuote
      parameters:
        - name: token
          in: path
          required: true
          schema:
            type: string
          description: Token opaco del checkout embebido en la `checkout_url`.
        - name: country
          in: query
          required: false
          schema:
            type: string
          description: País ISO-3166 alpha-2 opcional para cotizar el monto local.
      responses:
        '200':
          description: Cotizaciones indicativas del link.
          content:
            application/json:
              example:
                status: pending
                settlement_asset: USDT
                asset_amount: '50'
                countries:
                  - country: BO
                    currency: BOB
                    methods:
                      - qr
                    options:
                      - method: qr
                        currency: BOB
                      - method: qr
                        currency: USD
                  - country: VE
                    currency: VES
                    methods: []
                    options:
                      - method: c2p
                        currency: VES
                        collect: true
                      - method: debito_inmediato
                        currency: VES
                        collect: true
                  - country: CL
                    currency: CLP
                    methods:
                      - bank_transfer
                      - fintoc
                    options:
                      - method: bank_transfer
                        currency: CLP
                      - method: fintoc
                        currency: CLP
                cards:
                  - country: BO
                    currency: BOB
                    local_amount: '543.30'
                  - country: BO
                    currency: USD
                    local_amount: '50.75'
                crypto:
                  - method: crypto:tron:usdt
                    chain: tron
                    asset: USDT
                    due: '50.000000'
                  - method: crypto:btc:btc
                    chain: btc
                    asset: BTC
                    due: '0.00046120'
                    quote_ttl_seconds: 900
                cbpay:
                  alias: tayl.code
                  dues:
                    USDT: '50.000000'
                    USDC: '50.100200'
                    BTC: '0.00046120'
                    GOLD: '0.462100'
                country_quote:
                  country: BO
                  currency: BOB
                  methods:
                    - qr
                  local_amount: '543.30'
                  options:
                    - method: qr
                      currency: BOB
                      local_amount: '543.30'
                    - method: qr
                      currency: USD
                      local_amount: '50.75'
        '404':
          description: Token inválido o link de cobro desconocido.
          content:
            application/json:
              example:
                error: not_found
                message: payment link not found
        '422':
          description: El país pedido no tiene métodos de pago disponibles.
          content:
            application/json:
              example:
                error: country_unavailable
                message: no payment methods are available for that country
        '429':
          description: Demasiadas peticiones desde esta IP.
          content:
            application/json:
              example:
                error: too_many_attempts
                message: too many requests; wait a moment and retry
        '503':
          description: Cotización temporalmente no disponible.
          content:
            application/json:
              example:
                error: pricing_unavailable
                message: pricing is temporarily unavailable; retry in a moment
      security: []
components:
  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.

````