Agibank API 接口集成服务

个人财务管理 (PFM) 账户聚合

业务背景: 一款财富管理 App 需要将用户的 Agibank 支票余额、信用卡负债和工资贷债务整合到一个统一的视图中。

涉及的数据/API: 授权登录 API、余额查询接口、信贷状态接口。

开放金融价值: 通过提供用户财务健康状况的全局视图来践行开放金融（Open Finance）理念，自动对 Agibank 交易进行分类，免去手动记账。

B2B 财务记账与对账自动化

业务背景: 使用 Agibank 收款的巴西小微企业需要每天将交易日志推送到其 ERP 系统（如 Conta Azul、Omie）。

涉及的数据/API: 对账单提取 API（按日期与 Pix 收款过滤）。

开放金融价值: 减少人工记账错误。数据管道将专有 App 协议响应转换为标准化的 JSON/CSV 格式，实现 ERP 系统的无缝摄取。

信用评分与债务重组服务

业务背景: 第三方信贷机构希望通过分析 Agibank 客户当前的 Consignado（工资贷）利率和未偿余额，提供更优的再融资方案。

涉及的数据/API: 贷款模拟与活跃信贷 API。

开放金融价值: 利用开放数据（Open Data）原则获取真实的信贷条件，使金融科技公司能够基于实时债务状况提供量身定制的再融资报价。

自动化收入流水验证

业务背景: 房屋租赁平台或新型券商需要用户的收入证明。他们通过集成接口验证用户的工资代发（Portabilidade de Salário）记录。

涉及的数据/API: 交易流水 API（按存款来源过滤）。

开放金融价值: 直接从银行账本中以编程方式验证收入流，从而简化背景调查和信用审批流程。

会话初始化与授权登录

模拟官方 App 的登录流程，使用 CPF 和设备指纹获取 Bearer 令牌。

POST /api/v1/agibank/auth/login
Content-Type: application/json
User-Agent: Agibank/App-Android (br.com.agipag.app)

{
  "cpf": "12345678900",
  "password": "********",
  "device_id": "android-uuid-xyz"
}

// 响应结果
{
  "status": "success",
  "access_token": "eyJhbGciOiJIUzI1Ni...",
  "expires_in": 3600
}

获取工资贷（Consignado）详情

检索活跃的贷款合同。由于 Agibank 主要客群是退休人员和 CLT 员工，这是其核心数据。

GET /api/v1/agibank/credit/active-loans
Authorization: Bearer <ACCESS_TOKEN>

// 响应结果
{
  "loans": [
    {
      "contract_id": "AGI-998877",
      "type": "CONSIGNADO_INSS",
      "total_amount": 5000.00,
      "installments_total": 48,
      "installments_paid": 12,
      "interest_rate": 1.65,
      "next_due_date": "2025-10-05"
    }
  ]
}

数据流与系统架构

我们的集成方案在您的后端系统与 Agibank 服务器之间提供可靠的中间件层：

• 1. 客户端授权： 您的系统安全地将用户凭据（CPF/密码）发送至我们的代理 API 网关。
• 2. 协议模拟： 我们的引擎模拟 Android/iOS 客户端（br.com.agipag.app）的网络请求，处理会话令牌并绕过基础防抓包机制。
• 3. 数据提取与归一化： 解析 Agibank 返回的原始 JSON 响应，清理并将其格式化为标准的 Open Finance 模式。
• 4. 交付与回调（Webhook）： 数据通过 REST 同步响应交付，或通过 Webhook 异步推送（例如：收到新的 Pix 交易时）。

合规与隐私政策

在巴西金融生态系统中运营需要严格遵守当地法规。我们的接口工具被设计为可部署在您自己的安全基础设施中。

关于我们的技术工作室

我们是一家专门从事 App 接口集成与授权协议分析的技术工作室。凭借对巴西金融科技生态（涵盖 Nubank、PicPay、Banco do Brasil 等应用）的深刻理解，我们在官方 API 缺失或限制较多的情况下，通过协议还原解锁开放数据的价值。

我们为国际与本土客户服务，交付稳定可靠的 Python/Node.js 源代码、详尽的接口文档以及长期的维护策略。

• 精通 Android/iOS 协议分析与流量解密。
• 侧重于交付可独立运行的源代码，而非单纯提供 SaaS 账号。
• 熟悉巴西本土金融协议（Pix、CIP、Consignado）。
• 透明报价体系与基于里程碑的交付付款模式。

合作与提案流程

1. 1. 需求确认： 明确您需要从 Agibank 提取的具体数据（如：仅同步对账单，或需要完整的信贷发起流程）。
2. 2. 协议可行性分析： 我们对 'br.com.agipag.app' 的当前版本进行分析，映射所需的端点并解决身份验证障碍。
3. 3. 开发与封装： 编写 API 封装脚本（Node.js/Python），实现重试逻辑和错误处理机制。
4. 4. 交付与测试： 提供源代码、Postman 集合以及部署至您服务器环境的说明文档。
5. 5. 最终验收： 在您的基础设施中测试成功后支付尾款。