> ## 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. # Informe de verificación de un KYC tuyo (PDF/JSON) > Informe de compliance COMPLETO de una verificación que corriste sobre tu cliente (solo cuentas empresa): perfil verificado, ciclo de vida, documentos + OCR, liveness (una entrada por sesión - el check de onboarding más cualquier recaptura de evidencia posterior, cada una con su propio session_id y purpose; en un KYB, cada parte relacionada puede tener más de una sesión también) y la sección AML COMPLETA con detalle de coincidencias - eres el responsable de los datos de tus terceros. Si la submission resulta ser tu propio onboarding, la sección AML baja a la versión agregada. Usa format=pdf (default) o format=json, y lang=en|es|zh. Gratis - es lectura de una verificación ya cobrada. Si la submission aún no tiene screening AML enlazado, se dispara uno on-demand (idempotente, sin fee); si no está disponible, el informe sale igual con el hueco declarado en el campo partial. ## OpenAPI ````yaml /openapi.es.yaml get /v1/kyc/submissions/{submissionID}/verification-report openapi: 3.1.0 info: title: CBPay API version: '2.62' 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) — convertibles a demanda con swaps. Los payouts y las comisiones de servicios pueden pagarse desde cualquiera de los cuatro saldos (`PUT /v1/settlement` u override por payout con `settlement_asset`), y los payins pueden auto-convertirse al asset que elijas (`default_payin_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": "", "message": ""}`. 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 (QR, transferencias, cuentas dedicadas, cobros pull, tarjetas, links de checkout) que se acreditan automáticamente — en USDT por defecto, o convertidas al settlement asset que elijas. - name: Checkout description: >- Links de checkout universal (`POST /v1/payins` con `method: "checkout"`) y los endpoints públicos de la página de pago — fiat multi-país, crypto con wallet efímera por link y pago directo CBPay, liquidado en el asset que elijas. - name: Tarjetas guardadas description: >- Tarjetas guardadas con el consentimiento explícito del pagador durante un pago 3-D Secure (COF). Listarlas, revocarlas y cobrarlas bajo demanda (MIT) sin pedir la tarjeta de nuevo. - name: Suscripciones description: >- Cobros recurrentes sobre una tarjeta guardada gestionados por el scheduler de la plataforma — diarios, semanales, mensuales o anuales, con pausa/reanudación/cancelación y dunning automático. - name: Transferencias description: >- Transferencias internas gratuitas entre cuentas CBPay (persona o empresa, cualquier combinación). - name: Contacts description: >- Libreta de beneficiarios por cuenta (destinos CBPay, bancarios y crypto) con match por teléfono y auto-guardado en cada envío. - name: Swaps description: >- Conversión instantánea entre los saldos USDT, USDC, BTC y GOLD de la cuenta a la tasa cotizada de la cuenta. - 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: Pruebas de firma description: >- Firma criptográfica de mensajes con wallets (EIP-191 ETH/EVM, TIP-191 TRON) — crear, listar, consultar y revocar pruebas de firma con verificación pública. - name: Vínculos de wallets description: >- Vincula wallets externas (custody=client) a tu cuenta firmando un desafío nonce — crear desafíos, verificar firmas, listar y revocar vínculos. - 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 description: >- Verificación de identidad: KYC para personas, KYB para empresas — tu propio onboarding y verificaciones de terceros para cuentas empresa. - 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: >- Screening AML standalone de personas y empresas contra listas de sanciones, PEP y medios adversos, con re-screening, monitoreo continuo e informe PDF descargable. - name: Qscore description: >- Buró de crédito API-first. Emite informes crediticios completos con score 1-999 (bandas A-E, o SC cuando no hay datos), consulta el último score de un sujeto y gestiona disputas ARCO. Chile primero, con diseño agnóstico al país. Cada informe emitido lleva un código de verificación pública. - 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 que elijas (USDT, USDC, BTC o GOLD), 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. - name: Eventos en tiempo real description: >- Stream Server-Sent Events con todo lo que pasa en la cuenta (o en toda la organización para administradores), replay con `Last-Event-ID`, snapshot inicial opcional e historial consultable de 90 días. paths: /v1/kyc/submissions/{submissionID}/verification-report: get: tags: - KYC / KYB summary: Informe de verificación de un KYC tuyo (PDF/JSON) description: >- Informe de compliance COMPLETO de una verificación que corriste sobre tu cliente (solo cuentas empresa): perfil verificado, ciclo de vida, documentos + OCR, liveness (una entrada por sesión - el check de onboarding más cualquier recaptura de evidencia posterior, cada una con su propio session_id y purpose; en un KYB, cada parte relacionada puede tener más de una sesión también) y la sección AML COMPLETA con detalle de coincidencias - eres el responsable de los datos de tus terceros. Si la submission resulta ser tu propio onboarding, la sección AML baja a la versión agregada. Usa format=pdf (default) o format=json, y lang=en|es|zh. Gratis - es lectura de una verificación ya cobrada. Si la submission aún no tiene screening AML enlazado, se dispara uno on-demand (idempotente, sin fee); si no está disponible, el informe sale igual con el hueco declarado en el campo partial. operationId: getKycVerificationReport parameters: - name: submissionID in: path required: true schema: type: string format: uuid description: Id de la submission. - name: format in: query schema: type: string enum: - pdf - json description: Formato del informe - pdf (default) o json. - name: lang in: query schema: type: string enum: - en - es - zh description: Idioma del informe (en default, es, zh). responses: '200': description: >- El informe de verificación (application/pdf, o application/json con format=json). content: application/pdf: schema: type: string format: binary example: '%PDF-1.7 (binary report content)' application/json: example: report_id: IDR-3C4D5E6F7A8B kind: kyc scope: third_party generated_at: '2026-07-28T15:04:05Z' generated_by: CBPay language: en aml_detail: true submission_id: 3c4d5e6f-7a8b-4c9d-8e0f-1a2b3c4d5e6f external_customer_id: customer-1042 status: approved risk_band: medium aml_decision: approved submitted_at: '2026-07-19T14:00:00Z' updated_at: '2026-07-19T14:52:00Z' decided_at: '2026-07-19T14:52:00Z' documents_received: - identity - proofOfAddress subject: type: person name: Maria Fernanda Rojas person: first_name: Maria middle_name: Fernanda last_name: Rojas date_of_birth: '1988-11-02' country_of_birth: PE nationality: PE tax_residence_country: PE id_type: national_id id_number: '45678912' id_issuing_country: PE id_expires_at: '2029-05-20' occupation: Regional sales manager email: maria.rojas@example.com phone: +51 9 8765 4321 address: line1: Av. Arequipa 1200 city: Lima state: Lima postal_code: '15046' country: PE economic_profile: source_of_funds: salary primary_purpose: personal_payments monthly_payments_usd: '5000' monthly_transaction_count: '20' employment_status: employed employer_name: Andes Retail SAC expected_chains: - tron attestations: - key: att_money_services value: false - key: att_prohibited_countries value: false bank_account: bank_name: BCP account_holder: Maria Fernanda Rojas account_masked: '****9911' country: PE currency: PEN third_party_account: false documents: - category: identity filename: dni.pdf status: validated outcome: MATCH score: '0.99' summary: >- Name, document number and date of birth match the verified profile. validated_at: '2026-07-19T14:40:00Z' - category: proofOfAddress filename: recibo-luz.pdf status: validated outcome: REVIEW score: '0.72' error: Address line partially legible. validated_at: '2026-07-19T14:41:00Z' liveness: - role: subject session_id: lv_e763e3465bf34f1dab826a263c1eaaaa purpose: gate status: completed outcome: PASS passed_gate: true liveness_score: '0.98' antispoof_score: '0.96' face_similarity: '0.94' gestures_expected: 3 gestures_passed: 3 updated_at: '2026-07-19T14:35:00Z' media: has_selfie: true has_video: false expires_in_sec: 900 selfie_sha256: >- 6f8a3b1c2d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f60718293a4b5c6d7e - role: subject session_id: lv_4cdd3a82903940cebd8cc95a77cdacb3 purpose: media_recapture status: completed outcome: FAIL passed_gate: false liveness_score: '0.98' antispoof_score: '0.59' face_similarity: '0.55' gestures_expected: 3 gestures_passed: 2 reasons: - Smile was not detected. updated_at: '2026-07-19T14:38:00Z' media: has_selfie: true has_video: true frame_gestures: - center - turn_right - smile video_mime_type: video/mp4 expires_in_sec: 900 selfie_sha256: >- a1b2c3d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f60718293a4b5c6d7e8f9 frame_sha256: - >- c3d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f60718293a4b5c6d7e8f9a1b2 - >- d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f60718293a4b5c6d7e8f9a1b2c3 aml: screening_id: 6b7c8d9e-0f1a-4b2c-9d3e-4f5a6b7c8d9e risk_level: medium status: under_review monitor: true screened_at: '2026-07-19T14:50:00Z' sanctions: clear pep: under_review adverse_media: under_review screening_result: has_hits rationale: >- One PEP profile and one adverse media article matched the declared identity. indicators: - key: ind_sanctions hit: false - key: ind_pep hit: true - key: ind_adverse_media hit: true - key: ind_warning hit: false - key: ind_fitness_probity hit: false subject_rows: - key: full_name value: Maria Fernanda Rojas - key: date_of_birth value: '1988-11-02' - key: nationality value: PE matches_total: 1 matches: - name: Maria F. Rojas score: 0.88 match_types: - name_fuzzy - year_of_birth risk_kinds: - pep - adverse_media aliases: - M. Rojas - Maria Rojas Vega identity: - key: date_of_birth value: '1988' - key: nationality value: PE - key: national_id value: 4567**** peps: - name: Advisor, regional government country: PE since: '2018' until: '2021' info: Non-elected advisory role. adverse_media: - title: Local outlet reports contract review published_at: '2020-09-14' source: Diario Local snippet: Regional contract under administrative review. associates: - name: Luis Rojas relation: relative cases: - case_id: CASE-4821 status: closed decision: no_action opened_at: '2026-07-19T14:51:00Z' closed_at: '2026-07-19T15:20:00Z' content_sha256: >- 1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2c verification_code: K3c4d5e6f7a8b4c9d8e0f1a2b3c4d5e6f7a8b9c0d1e2f3a4b5 verification_url: >- https://api.example.com/verify/reports/K3c4d5e6f7a8b4c9d8e0f1a2b3c4d5e6f7a8b9c0d1e2f3a4b5 '400': description: Formato o idioma inválido (invalid_format, invalid_language). content: application/json: example: error: invalid_format message: format must be pdf or json '401': $ref: '#/components/responses/Unauthorized' '403': description: >- Solo cuentas empresa pueden descargar informes de sus terceros (company_account_required). content: application/json: example: error: company_account_required message: this action requires a company account '404': $ref: '#/components/responses/NotFound' components: 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 NotFound: description: Recurso no encontrado (`not_found`). content: application/json: schema: $ref: '#/components/schemas/Error' example: error: not_found message: resource not found schemas: 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. securitySchemes: bearerAuth: type: http scheme: bearer description: | JWT de sesión (de register/login) o llave de API (`pk_...`). `X-API-Key: ` se acepta como header alternativo. ````