> ## 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. # 您发起的 KYB 验证报告（PDF/JSON） > 您对客户发起的验证的完整合规报告（仅限企业账户）：已验证档案、生命周期、文件 + OCR、活体检测（每次会话一条记录 - 入驻门槛检查加上后续任何证据补录，各自带有独立的 session_id 和 purpose；在 KYB 中，每个关联方也可能有多次会话），以及包含匹配明细的完整 AML 筛查部分 - 您是您第三方数据的控制者。如果该 submission 是您自己的入驻验证，AML 部分将降级为聚合版本。使用 format=pdf（默认）或 format=json，以及 lang=en|es|zh。免费 - 读取已计费的验证。若该 submission 尚无关联的 AML 筛查，将按需幂等触发一次（不收费）；不可用时报告照常输出，并在 partial 字段声明缺口。 ## OpenAPI ````yaml /openapi.zh.yaml get /v1/kyb/submissions/{submissionID}/verification-report openapi: 3.1.0 info: title: CBPay API version: '2.62' description: > CBPay 是一个多币种支付平台:覆盖拉美的法币付款(payout)与收款(payin)、内部转账、链上充值与提现,以及 KYC 筛查。每个账户持有四个相互独立的虚拟余额——USDT(运营货币)、USDC、BTC 和 GOLD(纯金克数)——可通过兑换(swap)按需转换。 payout 和服务费可从四个余额中的任意一个支付(用 `PUT /v1/settlement` 设置默认值,或在单笔 payout 中用 `settlement_asset` 覆盖);payin 可自动兑换为你选择的资产(`default_payin_asset`)。 所有金额均为十进制字符串,遵循各货币的精度(USDT/USDC/GOLD 为 6 位小数,BTC 为 8 位)。错误始终返回 `{"error": "", "message": ""}`。 servers: - url: https://api.qbank.cl/platform description: Live（生产环境，真实资金） - url: https://cryptobank.qbank.cl/platform description: Test（沙盒，模拟资金 — pk_test_ 密钥） security: - bearerAuth: [] tags: - name: 凭证 description: >- 每笔操作的品牌化 PDF 凭证,附带公开的签名 QR 真伪校验、每个响应/webhook 中的 receipt_url,以及最终状态时的自动邮件发送。 - name: 身份认证 description: 注册与登录账户成员。会话有效期 24 小时。 - name: 账户 description: 调用账户的档案、成员与 API key。 - name: 余额 description: 余额、流水历史与外汇汇率。 - name: 付款(Payouts) description: 从你选择的结算余额扣款的法币派发(默认 USDT)。 - name: 收款(Payins) description: 法币充值(二维码、转账、专属账户、pull 收款、卡片、checkout 链接)自动入账——默认入账 USDT,也可自动兑换为你选择的结算资产。 - name: 收银台(Checkout) description: >- 通用收银台链接(`POST /v1/payins`,`method: "checkout"`)与公开支付页端点——多国法币、每个链接专属临时钱包的加密货币支付,以及 CBPay 直接支付,按你选择的资产结算。 - name: 已保存卡片(Stored cards) description: 在 3-D Secure 支付中经付款人明确同意保存的卡片(COF)。可列出、吊销并按需扣款(MIT),无需再次索要卡片信息。 - name: 订阅(Subscriptions) description: 由平台调度器管理的已保存卡片周期性扣款——按日、周、月或年,支持暂停/恢复/取消与自动催收。 - name: 转账 description: CBPay 账户之间的免费内部转账(个人或企业,任意组合)。 - name: 联系人 description: 按账户维护的收款人通讯录(CBPay、银行与加密货币目的地),支持手机号匹配与每次发送时自动保存。 - name: 兑换(Swaps) description: 按账户报价即时兑换账户的 USDT、USDC、BTC 与 GOLD 余额。 - name: 加密货币 description: 链上充值与提现(TRON、Ethereum 和 Bitcoin)。 - name: 隔离钱包 description: 拥有自身余额的链上钱包(企业不限数量;个人每个网络+资产组合 1 个)——创建、导入、发送、导出私钥与自动转发。余额存在于链上,从不进入账本。 - name: 签名证明 description: 使用钱包进行加密消息签名(EIP-191 ETH/EVM、TIP-191 TRON)——创建、列出、查询和吊销具有公开验证功能的签名证明。 - name: 钱包链接 description: 通过签名 nonce 挑战将外部钱包(custody=client)链接到你的账户——创建挑战、验证签名、列出和吊销链接。 - name: QR Crypto POS description: >- 面向拥有实体 POS 终端的处理商（企业账户）的定额加密货币二维码收款：已验证商户、每笔收款专属地址 + 二维码、支付早期检测、按商户对账，以及经加密货币提现通道的退款。 - name: KYC / KYB description: 身份验证:个人 KYC、企业 KYB——你自己的入驻验证,以及企业账户的第三方验证。 - name: AML 筛查 description: 针对个人与企业的独立 AML 筛查(制裁、PEP 与负面媒体名单),含重新筛查、持续监控与可下载的 PDF 报告。 - name: 钱包筛查 description: 区块链地址的 AML 风险评估(制裁、非法资金暴露),按次收费;另附提现与充值的免费自动防护。 - name: Qscore description: >- API 优先的信用局。签发完整的信用报告，评分为 1-999（A-E 等级，无数据时为 SC），查询主体的最新评分，并管理 ARCO 争议。智利先行，设计上与国家无关。每份签发的报告都带有公开验证码。 - name: 分析 - name: Webhooks description: 接收签名事件通知的订阅。 - name: 状态 description: 服务可用性。 - name: 银行服务 description: 真实银行账户:通过国际银行通道接收、持有与发送资金。 - name: 卡片 description: 以 Just-In-Time 方式从你选择的余额(USDT、USDC、BTC 或 GOLD)消费的虚拟卡与实体卡,支持按卡设置消费限额。 - name: 安全(OTP) description: >- 通过 SMS/WhatsApp/email 发送的一次性验证码,保护敏感操作;并提供自助 2FA 偏好设置。仅适用于用户会话——API key 豁免。 - name: 通行密钥 description: >- 通过 WebAuthn 使用设备生物识别(Face ID、Touch ID、Windows Hello、安全密钥)的无密码登录、带备份码的验证器应用(TOTP),以及会话/设备管理。 - name: 社交登录 description: >- 通过令牌交换以 Google、Apple、Microsoft 和 Facebook 实现无密码注册与登录。前端获取提供方凭证;API 验证后签发 CBPay 会话。 - name: 实时事件 description: >- Server-Sent Events 流，实时推送账户内（管理员则为整个组织）发生的所有事件，支持通过 `Last-Event-ID` 重放、可选的初始快照，以及 90 天可查询历史。 paths: /v1/kyb/submissions/{submissionID}/verification-report: get: tags: - KYC / KYB summary: 您发起的 KYB 验证报告（PDF/JSON） description: >- 您对客户发起的验证的完整合规报告（仅限企业账户）：已验证档案、生命周期、文件 + OCR、活体检测（每次会话一条记录 - 入驻门槛检查加上后续任何证据补录，各自带有独立的 session_id 和 purpose；在 KYB 中，每个关联方也可能有多次会话），以及包含匹配明细的完整 AML 筛查部分 - 您是您第三方数据的控制者。如果该 submission 是您自己的入驻验证，AML 部分将降级为聚合版本。使用 format=pdf（默认）或 format=json，以及 lang=en|es|zh。免费 - 读取已计费的验证。若该 submission 尚无关联的 AML 筛查，将按需幂等触发一次（不收费）；不可用时报告照常输出，并在 partial 字段声明缺口。 operationId: getKybVerificationReport parameters: - name: submissionID in: path required: true schema: type: string format: uuid description: Submission id。 - name: format in: query schema: type: string enum: - pdf - json description: 报告格式 - pdf（默认）或 json。 - name: lang in: query schema: type: string enum: - en - es - zh description: 报告语言（en 默认、es、zh）。 responses: '200': description: 验证报告（application/pdf，或 format=json 时为 application/json）。 content: application/pdf: schema: type: string format: binary example: '%PDF-1.7 (binary report content)' application/json: example: report_id: IDR-9B2C41A0D3E5 kind: kyb scope: third_party generated_at: '2026-07-28T15:04:05Z' generated_by: CBPay language: en aml_detail: true submission_id: 9b2c41a0-d3e5-4f6a-8b7c-1d2e3f4a5b6c status: approved risk_band: low aml_decision: approved submitted_at: '2026-07-20T12:30:00Z' updated_at: '2026-07-21T09:15:00Z' decided_at: '2026-07-21T09:15:00Z' documents_received: - certificateOfIncorporation - proofOfAddress - uboIdentity:0 subject: type: company name: JVA SpA company: legal_name: JVA SpA trade_name: JVA registration_number: 77123456-7 business_type: corporation company_status: active incorporation_date: '2019-04-12' incorporation_country: CHL website: https://jva.example countries_of_operation: - CHL - PER address: line1: Av. Apoquindo 1234 city: Santiago state: RM postal_code: '7550000' country: CL registered_address: line1: Av. Apoquindo 1234 city: Santiago country: CL industry: code: K64 label: Financial service activities economic_profile: source_of_funds: business_revenue primary_purpose: payments annual_revenue_usd: '250000' monthly_payments_usd: '40000' monthly_transaction_count: '120' average_transaction_usd: '330' expected_chains: - tron - ethereum customer_funds_description: Collections from merchants in CL and PE. attestations: - key: att_money_services value: false - key: att_third_party_funds value: true detail: Settlement on behalf of merchants. - key: att_high_risk_activities items: - none bank_account: bank_name: Banco de Chile account_holder: JVA SpA account_masked: '****4321' country: CL currency: CLP third_party_account: false fields: operatingName: JVA Payments parties: - source: ubo index: 0 kind: ubo roles: - beneficial_owner - control_person name: Javier Andres Villablanca person: first_name: Javier middle_name: Andres last_name: Villablanca date_of_birth: '1985-03-04' nationality: CL tax_residence_country: CL id_type: national_id id_number: 12345678-9 id_issuing_country: CL id_expires_at: '2030-01-31' occupation: Director address: line1: Av. Siempre Viva 742 city: Santiago state: RM country: CL ownership_percent: '60' has_ownership: true has_control: true is_signer: false documents: - category: uboIdentity:0 filename: cedula.pdf status: validated outcome: MATCH score: '0.97' validated_at: '2026-07-21T09:12:00Z' party_index: 0 liveness: role: ubo:0 session_id: lv_e763e3465bf34f1dab826a263c1eaaaa purpose: gate status: completed outcome: PASS passed_gate: true liveness_score: '0.99' antispoof_score: '0.97' face_similarity: '0.95' gestures_expected: 3 gestures_passed: 3 updated_at: '2026-07-20T09:05:00Z' media: has_selfie: true has_video: false expires_in_sec: 900 selfie_sha256: >- 6f8a3b1c2d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f60718293a4b5c6d7e liveness_sessions: - role: ubo:0 session_id: lv_e763e3465bf34f1dab826a263c1eaaaa purpose: gate status: completed outcome: PASS passed_gate: true liveness_score: '0.99' antispoof_score: '0.97' face_similarity: '0.95' gestures_expected: 3 gestures_passed: 3 updated_at: '2026-07-20T09:05:00Z' media: has_selfie: true has_video: false expires_in_sec: 900 selfie_sha256: >- 6f8a3b1c2d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f60718293a4b5c6d7e - role: ubo:0 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-31T22:29:32Z' 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: 7c1d2e3f-4a5b-4c6d-8e9f-0a1b2c3d4e5f risk_level: medium status: under_review monitor: true screened_at: '2026-07-21T09:13:00Z' sanctions: clear pep: under_review adverse_media: clear screening_result: has_hits indicators: - key: ind_sanctions hit: false - key: ind_pep hit: true - key: ind_adverse_media hit: false matches_total: 1 matches: - name: Javier Villablanca score: 0.91 match_types: - name_exact risk_kinds: - pep aliases: - J. Villablanca identity: - key: date_of_birth value: '1985-03-04' - key: nationality value: CL peps: - name: Municipal council member country: CL since: '2016' until: '2020' info: Former local office holder. associates: - name: Ana Soto relation: business_partner - source: signer index: 0 kind: signer name: Pedro Ruiz business_title: CFO is_signer: true person: first_name: Pedro last_name: Ruiz aml: screening_id: 8d2e3f4a-5b6c-4d7e-9f0a-1b2c3d4e5f6a risk_level: low status: clear monitor: true sanctions: clear pep: clear adverse_media: clear screening_result: no_hits matches_total: 0 documents: - category: certificateOfIncorporation filename: escritura.pdf status: validated outcome: MATCH score: '0.98' summary: >- Company name and registration number match the verified profile. validated_at: '2026-07-21T09:10:00Z' - category: proofOfAddress filename: cartola.pdf status: rejected outcome: NO_MATCH error: Document older than 90 days. validated_at: '2026-07-21T09:11:00Z' liveness: - role: ubo:0 session_id: lv_e763e3465bf34f1dab826a263c1eaaaa purpose: gate status: completed outcome: PASS passed_gate: true liveness_score: '0.99' antispoof_score: '0.97' face_similarity: '0.95' gestures_expected: 3 gestures_passed: 3 updated_at: '2026-07-20T09:05:00Z' media: has_selfie: true has_video: false expires_in_sec: 900 selfie_sha256: >- 6f8a3b1c2d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f60718293a4b5c6d7e - role: ubo:0 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-31T22:29:32Z' 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: 5f0e1d2c-b4a5-4968-8776-5a4b3c2d1e0f risk_level: low status: clear monitor: true screened_at: '2026-07-21T09:14:00Z' sanctions: clear pep: clear adverse_media: clear screening_result: no_hits rationale: No profiles matched the declared identity. indicators: - key: ind_sanctions hit: false - key: ind_pep hit: false - key: ind_adverse_media hit: false subject_rows: - key: legal_name value: JVA SpA - key: registration_number value: 77123456-7 matches_total: 0 partial: - party_aml_unavailable content_sha256: >- 4f2c1de0a9b83b7d6c5e4f3a2b1c0d9e8f7a6b5c4d3e2f1a0b9c8d7e6f5a4b3c verification_code: B9b2c41a0d3e54f6a8b7c1d2e3f4a5b6c0a1b2c3d4e5f6a7b8c9 verification_url: >- https://api.example.com/verify/reports/B9b2c41a0d3e54f6a8b7c1d2e3f4a5b6c0a1b2c3d4e5f6a7b8c9 '400': description: 格式或语言无效（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: 仅企业账户可下载其第三方的报告（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: 凭证缺失或无效(`unauthorized`)。 content: application/json: schema: $ref: '#/components/schemas/Error' example: error: unauthorized message: invalid or missing credentials NotFound: description: 资源未找到(`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: 机器可读的错误代码(snake_case)。 example: insufficient_funds message: type: string description: 人类可读的说明。 securitySchemes: bearerAuth: type: http scheme: bearer description: | 会话 JWT(来自注册/登录)或 API key(`pk_...`)。 也接受 `X-API-Key: ` 作为替代请求头。 ````