账户对账单

对账单将一个账户在某个期间内的所有流水 — 出款、入款、加密货币充值与提现、内部转账、银行卡消费、余额兑换、银行业务操作和服务费 — 合并为一份可审计的文档。同一个端点提供三种格式：

格式	用途	请求方式
`json`（默认）	在你的网页/应用中渲染对账单	`format=json`
`pdf`	带 CBPay 品牌的正式文档	`format=pdf`
`xlsx`	按分区分工作表、带筛选和数值单元格的 Excel	`format=xlsx`

请求对账单

# JSON for your front end
curl "https://api.qbank.cl/platform/v1/reports/statement?from=2026-01-01&to=2026-07-07" \
  -H "Authorization: Bearer <token>"

# Downloadable PDF (CBPay branding)
curl -OJ "https://api.qbank.cl/platform/v1/reports/statement?from=2026-01-01&to=2026-07-07&format=pdf" \
  -H "Authorization: Bearer <token>"

# Downloadable Excel
curl -OJ "https://api.qbank.cl/platform/v1/reports/statement?from=2026-01-01&to=2026-07-07&format=xlsx" \
  -H "Authorization: Bearer <token>"

from / to：YYYY-MM-DD 格式的日期，均含当日，按贵组织时区。最大范围：400 天。
lang=en|es|zh：PDF/Excel 的语言（默认 en）。同时带 Content-Language。
文件以 Content-Disposition: attachment 送达。文件名随 locale（statement_… / cartola_… / 对账单_…）。

包含哪些内容

{
  "account": { "account_id": "…", "display_name": "Example Company SpA", "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, "transfers": 4, "movements": 771 },
    "fees_by_service": { "payout": "15.300000", "funding": "897.550000" },
    "total_fees": "912.850000"
  },
  "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": "…", "payout_id": "…", "country": "BO", "beneficiary": "Juan Quispe", "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", "bank_reference": "00761123456" } ],
  "payins": [ { "…": "…" } ],
  "card_transactions": [ { "created_at": "…", "transaction_id": "…", "card_id": "…", "kind": "purchase", "merchant": "AMAZON.COM", "amount_usd": "25.00", "spend_asset": "USDT", "spend_amount": "25.000000", "status": "settled" } ],
  "swaps": [ { "created_at": "…", "swap_id": "…", "from_asset": "USDT", "to_asset": "BTC", "from_amount": "10.000000", "to_amount": "0.00015433", "rate": "0.00001543", "status": "completed" } ],
  "banking_operations": [ { "created_at": "…", "operation_id": "…", "direction": "out", "type": "wire", "currency": "USD", "amount": "150.00", "counterparty": "Acme Inc", "status": "completed" } ],
  "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": [ { "type": "adjustment", "amount": "12.500000", "balance_after": "12.500000", "created_at": "…" } ]
    }
  ],
  "crypto_deposits": [ { "chain": "tron", "asset": "USDT", "tx_id": "…", "usdt_gross": "100.000000", "fee": "1.000000", "usdt_credited": "99.000000", "balance_after": "99.000000" } ],
  "crypto_withdrawals": [ { "…": "…" } ],
  "transfers": [ { "direction": "sent", "counterparty": "Ana Perez", "asset": "USDT", "amount": "25.000000" } ],
  "service_charges": [ { "type": "banking_fee", "service": "banking_customer", "fee_model": "fixed", "amount": "-0.500000", "balance_after": "98.500000" } ],
  "movements": [ { "type": "funding", "amount": "99.000000", "balance_after": "99.000000", "created_at": "…" } ]
}

分区：

summary — 期初余额、流入、流出、期末余额、按服务分类的手续费，以及 USDT 余额（运营货币）的 balanced 标志。
assets — 每个有活动或余额的非 USDT 币种各有一个已对账的分区（USDC、BTC、GOLD，以及若使用 Banking，则包括你银行账户的 BANK_USD/BANK_EUR 镜像）：期初/期末余额、流入、流出、各自的 balanced 标志及其流水，按各币种的精度呈现。如果你只使用 USDT，此分区为空。
breakdown — 按产品、按国家（出款和入款，含本地金额和 USDT）、按法币币种和按月份。
按产品的明细 — 出款（收款人、汇率和扣款）、入款（按模式）、加密货币（含 tx_id 及其 asset）、转账（含对手方和 asset）、银行卡消费（card_transactions，含商户和消费余额）、余额兑换（swaps）、银行业务操作（banking_operations）和服务费（含退款）。
movements — 原始 USDT 账本：每笔流水均带 balance_after。这是审计师用来核对全部数据的分区（其他币种的流水位于各自的 assets 分区内）。

透明的手续费。 在出款、入款和加密货币提现中，当手续费由百分比和固定部分组成时，对账单会将其拆分为 fee_percent 和 fee_fixed（两者之和精确等于 fee）。独立收费（合规、钱包、银行业务、身份核验、银行卡）始终为固定金额，并带有 fee_model: "fixed" — PDF/Excel 中标记为 Fixed Com。早于该字段的历史操作只显示合并后的 fee。

如何对账（给你的会计）

对账单满足一个精确的会计恒等式，没有任何舍入：

opening_balance + total_in − total_out = closing_balance

balanced: true 确认该恒等式与账本相符 — 无论是 USDT 汇总还是每个 assets 分区内部（每个币种单独对账；不同币种的金额绝不相加）。
每一行 movements 都携带结果余额（balance_after）：你可以从期初到期末逐行跟踪余额变化。
一个期间的期末余额与下一个期间的期初余额一致。
手续费绝不隐藏在金额中：每笔操作分别显示总额、手续费和净额，fees_by_service 汇总所有手续费。
在 Excel 文件中，Movements 工作表使用真正的数值单元格：无需任何清洗即可求和/做透视表。
Excel 的 Payouts 工作表带有 Bank ref 列（位于参考/摘要列之后），内容为收款银行在确认付款后分配的交易 id。对账单 PDF 有意省略该列（表格密度考虑）——单笔付款回执中会显示。

面向管理员（组织管理员）

CBPay 团队可以生成其任一账户的对账单：

curl "https://api.qbank.cl/platform/v1/accounts/{accountID}/reports/statement?from=2026-01-01&to=2026-07-07&format=pdf" \
  -H "X-API-Key: <pk_org_admin>"

管理员视图还包含该期间的额外运营信息（详见管理文档）。

错误

HTTP	`error`	原因
400	`invalid_range`	日期缺失/无效、`to` 早于 `from`，或范围超过 400 天
400	`invalid_format`	`format` 不是 `json`、`pdf`、`xlsx` 之一
404	`not_found`	账户不存在（仅组织管理员）

常见问题

对账单多久生成一次？

按需生成 —— 每次请求都根据你传入的 from/to 区间（两者必填， YYYY-MM-DD，组织时区）从账本实时构建。

balanced: true 是什么意思？

每种资产独立核对：期初 + 入账 − 出账 = 期末，覆盖 USDT、USDC、BTC、 GOLD 和 banking 镜像。任一资产不平时该标志为 false —— 请报告给你的 CBPay 团队。

为什么我会看到 BANK_USD / BANK_EUR 余额？

它们在对账单中镜像你的 banking 资金，使账户能够完整重建。权威余额始终以银行为准（GET /v1/banking/accounts/{id}/balance）；这些镜像余额永远不可支出。

有哪些可用格式？

JSON（集成）、PDF 和 XLSX —— 后两者均带有你组织的品牌标识。使用 Accept 请求头或端点的格式参数。

fee_model: fixed 是什么？

独立服务收费（验证、筛查、钱包服务）为纯固定费用，在对账单中标注为 “Fixed Com” —— 区别于百分比+固定的交易型手续费。

可以验证单笔流水吗？

可以 —— 每笔操作都有带公开验证码的凭证；任何人无需认证即可验证。

开始使用

核心概念

集成流程

产品

集成

资源

请求对账单

包含哪些内容

如何对账（给你的会计）

面向管理员（组织管理员）

错误

常见问题

​请求对账单

​包含哪些内容

​如何对账（给你的会计）

​面向管理员（组织管理员）

​错误

​常见问题

请求对账单

包含哪些内容

如何对账（给你的会计）

面向管理员（组织管理员）

错误

常见问题