> ## 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. # 账户对账单(JSON、PDF 或 Excel) > 将期间内的全部流水——payouts、payins、加密充值与提现、内部转账及服务费——合并为一份可审计的对账单,并做精确对账:opening_balance + total_in − total_out = closing_balance,与账本核验(`balanced`)。摘要与流水覆盖 USDT 运营余额;其他有活动的虚拟余额(USDC、BTC、GOLD)在 `assets` 中独立对账。请求 `format=pdf` 或 `format=xlsx` 可下载 CBPay 品牌文件(Content-Disposition: attachment)。 ## OpenAPI ````yaml /openapi.zh.yaml get /v1/reports/statement openapi: 3.1.0 info: title: CBPay API version: '1.89' description: > CBPay 是一个多币种支付平台:覆盖拉美的法币付款(payout)与收款(payin)、内部转账、链上充值与提现,以及 KYC 筛查。每个账户持有四个相互独立的虚拟余额——USDT(运营货币)、USDC、BTC 和 GOLD(纯金克数)——它们绝不混合也不会自动兑换。 payout 和服务费可从四个余额中的任意一个支付: 用 `PUT /v1/settlement` 设置默认值,或在单笔 payout 中用 `settlement_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: 入账到 USDT 余额的法币充值。 - name: 转账 - name: 联系人 - name: 兑换(Swaps) description: CBPay 账户之间的免费内部转账(个人或企业,任意组合)。 - name: 加密货币 description: 链上充值与提现(TRON、Ethereum 和 Bitcoin)。 - name: 隔离钱包 description: 拥有自身余额的链上钱包(企业不限数量;个人每个网络+资产组合 1 个)——创建、导入、发送、导出私钥与自动转发。余额存在于链上,从不进入账本。 - name: QR Crypto POS description: >- 面向拥有实体 POS 终端的处理商（企业账户）的定额加密货币二维码收款：已验证商户、每笔收款专属地址 + 二维码、支付早期检测、按商户对账，以及经加密货币提现通道的退款。 - name: KYC / KYB - name: AML 筛查 description: 身份验证:个人 KYC、企业 KYB,含 AML 筛查、重新筛查与持续监控。 - name: 钱包筛查 description: 区块链地址的 AML 风险评估(制裁、非法资金暴露),按次收费;另附提现与充值的免费自动防护。 - name: 分析 - name: Webhooks description: 接收签名事件通知的订阅。 - name: 状态 description: 服务可用性。 - name: 银行服务 description: 真实银行账户:通过国际银行通道接收、持有与发送资金。 - name: 卡片 description: 以 Just-In-Time 方式从账户 USDT 余额消费的虚拟卡与实体卡,支持按卡设置消费限额。 - 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 会话。 paths: /v1/reports/statement: get: tags: - 余额 summary: 账户对账单(JSON、PDF 或 Excel) description: >- 将期间内的全部流水——payouts、payins、加密充值与提现、内部转账及服务费——合并为一份可审计的对账单,并做精确对账:opening_balance + total_in − total_out = closing_balance,与账本核验(`balanced`)。摘要与流水覆盖 USDT 运营余额;其他有活动的虚拟余额(USDC、BTC、GOLD)在 `assets` 中独立对账。请求 `format=pdf` 或 `format=xlsx` 可下载 CBPay 品牌文件(Content-Disposition: attachment)。 operationId: getAccountStatement parameters: - name: from in: query required: true schema: type: string format: date description: 开始日期(YYYY-MM-DD,UTC,含当日)。 - name: to in: query required: true schema: type: string format: date description: 结束日期(YYYY-MM-DD,UTC,含当日)。最大范围:400 天。 - name: format in: query schema: type: string enum: - json - pdf - xlsx default: json description: json 为网页视图;pdf/xlsx 下载品牌化文件。 - name: lang in: query schema: type: string enum: - es - en default: es description: PDF/Excel 输出的语言。 responses: '200': description: 对账单(JSON)或文件字节(pdf/xlsx)。 content: application/json: schema: type: object additionalProperties: true example: account: account_id: 9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d display_name: Example Company SpA email: ops@example.com type: company period: from: '2026-01-01' to: '2026-07-07' timezone: UTC generated_at: '2026-07-07T15:00:00Z' summary: opening_balance: '0.000000' total_in: '985633.540000' total_out: '38099.870000' net_change: '947533.670000' closing_balance: '947533.670000' balanced: true counts: payouts: 51 payins: 12 crypto_deposits: 18 crypto_withdrawals: 3 transfers: 4 service_charges: 2 movements: 771 fees_by_service: payout: '15.300000' funding: '897.550000' total_fees: '912.850000' assets: - asset: GOLD opening_balance: '0.000000' total_in: '12.500000' total_out: '2.000000' net_change: '10.500000' closing_balance: '10.500000' balanced: true movements: - created_at: '2026-07-09T10:00:00Z' type: adjustment reference: adjustment gold-load-1 amount: '12.500000' balance_after: '12.500000' breakdown: by_product: - product: payouts count: 51 usdt_in: '0.000000' usdt_out: '38099.870000' fees: '15.300000' by_country: - flow: payouts country: BO currency: BOB count: 14 local_amount: '28748.58' usdt_amount: '2902.210000' by_currency: - currency: BOB payout_local: '28748.58' payin_local: '700.00' by_month: - month: 2026-01 usdt_in: '985633.540000' usdt_out: '35100.000000' payouts: - created_at: '2026-03-19T22:57:00Z' payout_id: 0d4f2a10-1b2c-3d4e-5f60-718293a4b5c6 idempotency_key: bo-90 country: BO currency: BOB method: bank_transfer beneficiary: Juan Quispe detail: '1234567890' local_amount: '90.00' fx_rate: '6.91' usdt_amount: '13.024600' fee: '0.300000' fee_percent: '0.200000' fee_fixed: '0.100000' total_debit: '13.324600' status: completed payins: [] crypto_deposits: [] crypto_withdrawals: [] transfers: [] card_transactions: - created_at: '2026-03-20T10:12:00Z' transaction_id: 5f6a7b8c-9d0e-1f2a-3b4c-5d6e7f8a9b0c card_id: c0de0791-0000-0000-0000-000000000003 kind: purchase merchant: AMAZON.COM amount_usd: '25.00' spend_asset: USDT spend_amount: '25.000000' status: settled swaps: - created_at: '2026-03-21T09:00:00Z' swap_id: 1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d from_asset: USDT to_asset: BTC from_amount: '10.000000' to_amount: '0.00015433' rate: '0.00001543' status: completed banking_operations: - created_at: '2026-03-22T14:30:00Z' operation_id: 2b3c4d5e-6f7a-8b9c-0d1e-2f3a4b5c6d7e direction: out type: wire currency: USD amount: '150.00' counterparty: Acme Inc status: completed service_charges: - created_at: '2026-03-23T08:00:00Z' type: banking_fee service: banking_customer fee_model: fixed reference: cust-001 amount: '-0.500000' balance_after: '139.100000' movements: - created_at: '2026-03-19T22:57:00Z' type: payout_debit reference: payout 0d4f2a10-1b2c-3d4e-5f60-718293a4b5c6 amount: '-13.324600' balance_after: '139.600000' '400': description: invalid_range / invalid_format。 content: application/json: schema: $ref: '#/components/schemas/Error' example: error: invalid_range message: from and to are required (YYYY-MM-DD) '401': $ref: '#/components/responses/Unauthorized' components: schemas: Error: type: object properties: error: type: string description: 机器可读的错误代码(snake_case)。 example: insufficient_funds message: type: string description: 人类可读的说明。 responses: Unauthorized: description: 凭证缺失或无效(`unauthorized`)。 content: application/json: schema: $ref: '#/components/schemas/Error' example: error: unauthorized message: invalid or missing credentials securitySchemes: bearerAuth: type: http scheme: bearer description: | 会话 JWT(来自注册/登录)或 API key(`pk_...`)。 也接受 `X-API-Key: ` 作为替代请求头。 ````