Brubank 开放金融（OpenFinance）API 集成与授权协议分析

1) 对账单与 CBU 证据抽取

我们把“对账单下载”做成可接入的 statement API：把月度周期、交易引用、金额与币种字段标准化，输出给你的对账与财务系统。

用例：自动化对账、把报表导出到 ERP/财务看板，同时保留“谁在何时触发了数据获取”的合规留痕。

2) 交易流水（OpenData 归一化模型）

我们实现一个归一化摄取层，把原始应用流程映射到 OpenData/OpenFinance 字段：occurred_at、direction、category、provider、currency、reference_id。

用例：消费分析、异常检测、风控告警与运营报表，让你不必把应用规则“散落”在多个系统里。

3) QR 支付与即时入账事件流

通过集成 QR 支付事件，我们可以为商户提供结算与订单归因：把支付确认转换为统一的 payment event 模型，并回写你的订单对象。

生态说明：Brubank 的 QR 支付支持使用 Mercado Pago、Modo、Getnet 等提供方的二维码。你的集成可以保存 acquirer_provider 便于商户分渠道统计。

4) 转账/现金流信号与入账追踪

我们把转账集成成可一致使用的 transfer API：统一标识、方向与时间戳，便于做现金流预测和运营告警。

用例：入账提醒与资金到达看板，帮助用户按时处理房租、水电网费与类似“工资到帐”的周期性需求。

5) 投资持仓与产品类型（CEDEARs / MEP / 基金）

我们按 OpenFinance 风格实现投资相关端点：持仓快照、交易列表与衍生指标（例如抓取时点的估算价值），并区分产品类型。

用例：投资报表、合规留痕、风险面板，以及把投资行为纳入预算与资产负债管理。

6) Patear（BNPL）现金流排程集成

我们把 Patear 活动拆成独立账本：pateado 金额、选择的付费日、以及月度应计金额总览。这样你的预测与用户体验一致。

用例：个人理财 App 与预算系统需要把“当月消费、次月扣款”建模时，避免把 BNPL 误算成普通借记支出。

核心优势（对接团队关心的部分）

我们不把 Brubank 当“黑盒”，而是搭建可稳定运行的接口层，让你的后端能确定地获取财务数据对象。每个能力都会配套字段映射、请求/响应示例与测试计划。

• OpenData 归一化：金额、时间戳、引用号、产品类型字段一致
• 运行安全：重试、幂等键与结构化错误码，保证周期同步不丢数或重复记账
• 审计与合规：结合阿根廷隐私框架做访问留痕与最小化策略
• 交付源码：你得到可运行实现代码与集成文档

API 集成说明（我们怎么把数据接入）

你提供目标场景（例如：对账单导出、QR 支付结算事件、投资持仓报表、或 Patear 现金流预测）。随后我们把应用协议步骤映射为授权集成流程，并在你的系统里划定明确的边界。

常见链路：同意/会话建立 → 数据摄取 → 归一化与校验 → API 输出给你的分析与财务服务。我们也会提供“Brubank 协议/界面变更回归”的测试清单。

可接入的数据类型（OpenData 视角）

下表基于 Brubank 应用中可见的关键金融对象，帮助你规划优先级：先把对账、支付与投资报表打通，再扩展到 BNPL 排程与更细的事件字段。所有集成都以“授权访问”为前提设计。

典型集成方案（3-5 个端到端场景）

每个方案都包含：业务背景、需要对接的数据/接口、以及如何映射到 OpenData/OpenFinance 的下游模型。

技术实现（示例）

下方展示的是集成层的接口与数据结构示例，体现我们交付的技术深度。它们不等同于 Brubank 的公开端点，而是你们系统如何调用我们的授权集成服务并接收归一化结果。

// 1) 授权接入（同意 + 会话绑定）
POST /integration/brubank/oauth/start
  body: {
    "app_user_id": "u_123",
    "scopes": ["statements:read","transactions:read","investments:read"],
    "redirect_uri": "https://yourapp.com/oauth/callback/brubank"
  }
// Response: 你的后端保存 integration_session（短期）
{
  "integration_session_id": "sess_9f...",
  "redirect_url": "https://brubank/"
}

// 2) 对账单下载 + 归一化输出
POST /integration/brubank/statements:download
  body: {
    "integration_session_id": "sess_9f...",
    "account_identifier": {
      "alias": "br_alias_... ",
      "cbuproof_type": "CBU_ALIAS"
    },
    "period": {"year": 2026, "month": 2},
    "output": {"format": "json+pdf"}
  }
// 错误处理（部分成功）
{
  "status": "ok",
  "pdf_url": "s3://.../statement_2026-02.pdf",
  "movements": [
    {"occurred_at":"2026-02-03","amount":"-12345.00","currency":"ARS","reference_id":"...","category":"TRANSFER"}
  ]
}
// partial：retry_after_seconds 指定重试节奏
// status: "partial"

// 3) QR 支付事件摄取（轮询或事件驱动）
POST /integration/brubank/qr-payments:sync
  body: {
    "user_id": "u_123",
    "since": "2026-02-01T00:00:00Z",
    "merchant_linking": {
      "rules": [
        {"match":"order.reference_id","map_from":"transaction.reference_id"}
      ]
    }
  }
// 可选：你的系统暴露 Webhook 接收事件
POST https://yourapp.com/webhooks/brubank/payment-events
  {"event_id":"evt_...","order_id":"o_777","settled_at":"...","amount":"...","currency":"ARS","acquirer_provider":"MercadoPago"}

我们特别强调的实现要点：幂等键（event_id）、严格字段校验，以及可复现的分类映射策略，避免重复统计。

合规与隐私（阿根廷）

Brubank 的数据集成应在授权前提下进行，并遵循数据最小化。对阿根廷而言，一个关键隐私依据是《Ley 25.326》个人数据保护法，它规范个人数据的采集、存储、共享与安全处理。

在金融数据处理方面，监管机构与金融机构会强调用户权利（访问、更正、透明处理）。BCRA 在 2024 年 4 月推出首个 Open Finance API（面向 “Principal Variables”），并在后续 2025 步骤中强化反欺诈控制。因此我们的集成模块会做结构化字段校验、作用域访问约束，并让同步在应用协议变更下仍具备可恢复性。

数据流 / 架构简述

客户端 App → 授权同意/会话建立 → 摄取模块（协议分析 + 授权检索）→ 归一化与校验 → 存储（最小化原始数据 + 结构化模型）→ API 输出（给分析/对账服务）。

市场定位与用户画像

Brubank 定位为阿根廷数字银行：在其关于 2025 表现的 2026 年 1 月沟通中，提到拥有超过 4.2 百万用户，并为超过 9,000 家 SME 提供服务，同时强调云优先的运营模式。它也提及 PIX 集成与通过 API 的 Banking as a Service（BaaS）思路，使得 OpenFinance 风格的数据导出更适合用于对账、支付分析与投资报告。由于产品以移动端应用（Android/iOS）为主，集成规划会从用户在 App 内的关键路径开始，产出在后端可持续演进的端点。

交付项与你将得到什么

我们交付的是“可接入”的集成包，而不只是分析结论。交付内容面向开发团队：从协议知识到生产可用代码。

• API 规范（OpenAPI/Swagger 风格）——覆盖你要求的端点
• 协议与授权流程报告——同意/会话如何建立与更新
• 工作集成源码——按你的后端栈交付 Python/Node/Go 等骨架与实现
• 自动化测试计划与可运行 smoke tests（对账单/交易/QR/投资）
• 合规建议——scope 设计、日志策略、数据保留窗口
• 接口与开发文档——方便 QA 与研发复用

关于我们

我们是一家专注于 App 接口集成与授权 API 集成的技术服务工作室。交付方法结合协议分析、接口重构、OpenData/OpenFinance 映射，并提供可运行源码与集成文档。

团队成员具备移动端与金融科技落地经验，涵盖授权集成模式、支付与对账类数据的测试流程，以及协议变更后的回归支持。

• 合规优先：按当地隐私与金融数据处理期望进行默认设计
• 覆盖 Android 与 iOS：集成就绪代码 + 测试计划
• 一站式交付：分析 → 实现 → 验证 → 文档
• 透明定价：起价 $300，支持“交付后满意再付款”

联系方式

你只需要提供目标 App 名称与集成需求（Brubank 的信息你已给出），例如：对账单导出、QR 支付结算事件、投资持仓报表、或 Patear 现金流预测。然后访问：

打开联系页面 / 获取报价

合作与提案流程

1. 需求确认：明确你要的 scope（对账单、交易流水、QR、投资持仓、Patear）与成功标准
2. 协议分析与接口设计：形成端点映射与集成计划（通常 2–5 个工作日）
3. 开发与内部验证：实现摄取模块与归一化 API 输出（通常 3–8 个工作日）
4. 交付包：API 规范、源码、开发文档与测试用例（通常 1–2 个工作日）
5. 回归支持：若 Brubank 更新协议/界面，可按需修复与扩展（可选）

第一版“竖直切片”常见交付周期为 5–15 个工作日；如果涉及监管类数据流或需额外第三方审批，周期会相应延长。

常见问题

我需要提供什么？

如何保证合规与隐私？

只做一次导出可以吗？