openData StudioEnglish
Cartões CAIXA 图标

Cartões CAIXA 数据 API：信用卡账单、信用额度与自动扣款

Caixa Econômica Federal · 银行

在 Google Play 中打开

Cartões CAIXA 是巴西联邦储蓄银行 Caixa Econômica Federal 面向巴西 CAIXA 信用卡持卡人推出的专用应用。用户可查看当期及已结账账单、下载 PDF 账单、按商户类别了解消费支出，并管理附属卡。应用还支持申请应急额度和长期信用额度、创建虚拟卡与查看安全码，以及设置关联 CAIXA 活期账户的自动扣款。它专注于信用卡管理，而非该行更广泛的网上银行服务，与 Nubank、Banco do Brasil 和 Bradesco 等发卡机构的应用共同服务巴西信用卡用户。

CAIXA 信用卡账期以 identifierCodeBill 关联 billCutOffDate，并通过 totalSpend 和 groupsMCC 描述各商户类别的消费支出。当期及已结账账单记录保留 identifierCode、identifierClient 和 cardNumber；已结账账期还包含 bestDatePurchase。这些字段可用于家庭账本对账，以及账单总额与分类消费的比对。

信用额度方案将 limiteAtual、valorAumentoLimite 和 novoLimite 与 numeroCartao、bandeiraCartao、varianteCartao 对应，支持在授权范围内跟踪提额方案。虚拟卡记录可通过 branch、account、creditcardClientIdentifier 和 documentType 筛选。自动扣款记录将 identificadorFatura 关联到 valorSolicitado、valorDebitado 和 situacao，同时包含嵌套的 contaDebito 账户详情，以及 dataSolicitacao 和 dataRetorno 日期。预算工具、发卡机构对账系统及经授权的工资入账匹配流程可利用这些关联；openData Studio 将其转化为可调用的开放数据。

应用截图

  • Cartões CAIXA 应用截图 1
  • Cartões CAIXA 应用截图 2
  • Cartões CAIXA 应用截图 3
  • Cartões CAIXA 应用截图 4
  • Cartões CAIXA 应用截图 5
  • Cartões CAIXA 应用截图 6
  • Cartões CAIXA 应用截图 7

API 端点一览

以下端点与请求/响应示例均依据应用界面推导重构，为示意说明，并非实际抓包。

  • 持卡人令牌交换

    POST /v1/cardholder-sessions/exchange opendata

    将持卡人授权码或刷新令牌交换为 access_token 和 refresh_token，并提供令牌有效期及授权范围等元数据，供后续已认证的信用卡请求使用。

    认证方式： 授权码或刷新令牌交换本身无需认证。后续请求使用 Authorization: Bearer <access_token>。

    • grant_type
    • client_id
    • code
    • redirect_uri
    • scope
    • access_token
    • refresh_token
    • token_type
    • expires_in
    • refresh_expires_in
    POST /v1/cardholder-sessions/exchange HTTP/1.1
Content-Type: application/x-www-form-urlencoded

grant_type=authorization_code&client_id=<client-id>&code=<auth-code>&redirect_uri=<redirect-uri>&scope=offline_access
    {
  "access_token": "<jwt>",
  "refresh_token": "<refresh>",
  "token_type": "Bearer",
  "expires_in": 300,
  "refresh_expires_in": 1800,
  "scope": "offline_access"
}

  • 当期信用卡账单（完整访问）

    GET /v1/statements/{id}/current/{incluirAdicionais} openfinance

    按信用卡标识符加载当前账期的账单，可选择包含附属卡明细，结果以 JSON 数组返回。

    认证方式： 使用持卡人令牌交换获得的 Bearer access_token，且须有已认证的持卡人会话。

    • id
    • incluirAdicionais
    • identifierCode
    • identifierClient
    • cardNumber
    GET /v1/statements/STMT-EXAMPLE-10/current/true HTTP/1.1
Authorization: Bearer <access_token>
Accept: application/json
    [
  {
    "identifierCode": "STMT-EXAMPLE-10",
    "identifierClient": "holder-example-001",
    "cardNumber": "****4419"
  }
]

  • 已结账信用卡账单（完整访问）

    GET /v1/statements/{id}/closed/{incluirAdicionais} openfinance

    按信用卡标识符加载上一已结账账期的账单，可选择包含附属卡明细及最佳消费日期，结果以 JSON 数组返回。

    认证方式： 使用持卡人令牌交换获得的 Bearer access_token，且须有已认证的持卡人会话。

    • id
    • incluirAdicionais
    • identifierCode
    • identifierClient
    • cardNumber
    • bestDatePurchase
    GET /v1/statements/STMT-EXAMPLE-09/closed/true HTTP/1.1
Authorization: Bearer <access_token>
Accept: application/json
    [
  {
    "identifierCode": "STMT-EXAMPLE-09",
    "identifierClient": "holder-example-001",
    "cardNumber": "****4419",
    "bestDatePurchase": "2026-09-12"
  }
]

  • 信用卡账单 PDF

    POST /v1/statements/pdf-export openfinance

    使用 cardNumber、identifierCode、identifierClient 和 bestDatePurchase 标识账单并请求其 PDF 文件。

    认证方式： 使用持卡人令牌交换获得的 Bearer access_token，且须有已认证的持卡人会话。

    • cardNumber
    • identifierCode
    • identifierClient
    • bestDatePurchase
    POST /v1/statements/pdf-export HTTP/1.1
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "cardNumber": "****4419",
  "identifierCode": "STMT-EXAMPLE-10",
  "identifierClient": "holder-example-001",
  "bestDatePurchase": "2026-10-12"
}
    {
  "cardNumber": "****4419",
  "identifierCode": "STMT-EXAMPLE-10",
  "identifierClient": "holder-example-001",
  "bestDatePurchase": "2026-10-12"
}

  • MCC 商户类别消费画像

    POST /v1/spending/category-breakdown openfinance

    按商户类别汇总账单支出：accountNumber、cardNumber、identifierCodeClient、identifierCodeBill、billCutOffDate 和 groupCodeSelected 确定所选范围；totalSpend、groupsMCC 和 identifierCode 描述返回结果。

    认证方式： 使用持卡人令牌交换获得的 Bearer access_token，且须有已认证的持卡人会话。

    • accountNumber
    • cardNumber
    • identifierCodeClient
    • identifierCodeBill
    • billCutOffDate
    • groupCodeSelected
    • totalSpend
    • groupsMCC
    • identifierCode
    POST /v1/spending/category-breakdown HTTP/1.1
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "accountNumber": "00123456-7",
  "cardNumber": "****4419",
  "identifierCodeClient": "holder-example-001",
  "identifierCodeBill": "STMT-EXAMPLE-10",
  "billCutOffDate": "2026-10-12",
  "groupCodeSelected": ["5411", "5812"]
}
    {
  "totalSpend": "1842.55",
  "groupsMCC": [
    {"groupCode": "5411"}
  ],
  "identifierCode": "STMT-EXAMPLE-10"
}

  • 附属卡当期账单

    GET /v1/statements/{id}/additional-cards/current openfinance

    列出与主账单标识符关联的附属卡当期账单。

    认证方式： 使用持卡人令牌交换获得的 Bearer access_token，且须有已认证的持卡人会话。

    • id
    • identifierCode
    • cardNumber
    GET /v1/statements/STMT-EXAMPLE-10/additional-cards/current HTTP/1.1
Authorization: Bearer <access_token>
Accept: application/json
    [
  {
    "identifierCode": "STMT-ADDITIONAL-EXAMPLE",
    "cardNumber": "****8821"
  }
]

  • 应急额度可用性

    POST /v1/credit-options/emergency/check openfinance

    通过 agencia、conta 和 cpf 查询持卡人是否可使用应急额度。

    认证方式： 使用持卡人令牌交换获得的 Bearer access_token，且须有已认证的持卡人会话。该操作还需具备相应的信用卡管理权限。

    • agencia
    • conta
    • cpf
    POST /v1/credit-options/emergency/check HTTP/1.1
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "agencia": "0123",
  "conta": "00012345-6",
  "cpf": "<cpf>"
}
    {
  "agencia": "0123",
  "conta": "00012345-6",
  "cpf": "<cpf>"
}

  • 确认应急额度

    PUT /v1/credit-options/emergency/{hasEmergencyLimit} openfinance

    通过 hasEmergencyLimit 确认或拒绝应急额度标志，并在 mensagem 中返回确认信息。

    认证方式： 使用持卡人令牌交换获得的 Bearer access_token，且须有已认证的持卡人会话。该操作还需具备相应的信用卡管理权限。

    • hasEmergencyLimit
    • mensagem
    PUT /v1/credit-options/emergency/true HTTP/1.1
Authorization: Bearer <access_token>
Accept: application/json
    {
  "mensagem": "Limite emergencial confirmado"
}

  • 信用额度提升方案

    POST /v1/credit-options/permanent/quote openfinance

    返回预先批准的长期提额方案，包括 limiteAtual、valorAumentoLimite 和 novoLimite，以及 cpfCnpj、nomeCliente、chpras、numeroCartao、bandeiraCartao 和 varianteCartao。

    认证方式： 使用持卡人令牌交换获得的 Bearer access_token，且须有已认证的持卡人会话。

    • cpfCnpj
    • nomeCliente
    • chpras
    • numeroCartao
    • bandeiraCartao
    • varianteCartao
    • limiteAtual
    • valorAumentoLimite
    • novoLimite
    POST /v1/credit-options/permanent/quote HTTP/1.1
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "cpfCnpj": "<cpf>",
  "numeroCartao": "****4419"
}
    {
  "cpfCnpj": "<cpf>",
  "nomeCliente": "EXAMPLE CARDHOLDER",
  "chpras": "LIMIT-EXAMPLE",
  "numeroCartao": "****4419",
  "bandeiraCartao": "VISA",
  "varianteCartao": "GOLD",
  "limiteAtual": 5000,
  "valorAumentoLimite": 1500,
  "novoLimite": 6500
}

  • 虚拟卡列表

    POST /v1/virtual-cards/search openfinance

    通过 branch、account、creditcardClientIdentifier 和 documentType 列出持卡人的虚拟卡。

    认证方式： 使用持卡人令牌交换获得的 Bearer access_token，且须有已认证的持卡人会话。该操作还需具备相应的信用卡管理权限。

    • branch
    • account
    • creditcardClientIdentifier
    • documentType
    POST /v1/virtual-cards/search HTTP/1.1
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "branch": "0123",
  "account": "00012345-6",
  "creditcardClientIdentifier": "holder-example-001",
  "documentType": "CPF"
}
    {
  "branch": "0123",
  "account": "00012345-6",
  "creditcardClientIdentifier": "holder-example-001",
  "documentType": "CPF"
}

  • 创建虚拟卡

    POST /v1/virtual-cards/issue openfinance

    为通过 branch、account、creditcardClientIdentifier 和 documentType 标识的持卡人创建虚拟卡。经授权的请求包含设备位置信息。

    认证方式： 使用持卡人令牌交换获得的 Bearer access_token，且须有已认证的持卡人会话。该操作还需具备相应的信用卡管理权限。请求随附设备位置信息。

    • branch
    • account
    • creditcardClientIdentifier
    • documentType
    POST /v1/virtual-cards/issue HTTP/1.1
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "branch": "0123",
  "account": "00012345-6",
  "creditcardClientIdentifier": "holder-example-001",
  "documentType": "CPF"
}
    {
  "branch": "0123",
  "account": "00012345-6",
  "creditcardClientIdentifier": "holder-example-001",
  "documentType": "CPF"
}

  • 虚拟卡 CVV 安全码

    GET /v1/virtual-cards/{id}/security-code/{id2} openfinance

    通过 id 和 id2 两个标识符获取虚拟卡 CVV。经授权的请求包含设备位置信息；模拟结果仅展示标识字段。

    认证方式： 使用持卡人令牌交换获得的 Bearer access_token，且须有已认证的持卡人会话。该操作还需具备相应的信用卡管理权限。请求随附设备位置信息。

    • id
    • id2
    GET /v1/virtual-cards/VC-EXAMPLE/security-code/PAN-EXAMPLE HTTP/1.1
Authorization: Bearer <access_token>
Accept: application/json
    {
  "id": "VC-EXAMPLE",
  "id2": "PAN-EXAMPLE"
}

  • 账户自动扣款计划

    POST /v1/statement-payments/direct-debit/search openfinance

    读取信用卡账单的自动扣款计划，包括 identificadorFatura、valorSolicitado、valorDebitado、situacao、申请与返回日期，以及嵌套的 contaDebito 账户详情。

    认证方式： 使用持卡人令牌交换获得的 Bearer access_token，且须有已认证的持卡人会话。该操作还需具备相应的信用卡管理权限。

    • agencia
    • conta
    • contaDebito
    • produto
    • numero
    • digitoVerificador
    • cpfCnpj
    • dataRetorno
    • dataSolicitacao
    • identificadorFatura
    • remessa
    • situacao
    • tipoSolicitacao
    • valorDebitado
    • valorSolicitado
    POST /v1/statement-payments/direct-debit/search HTTP/1.1
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "agencia": "0123",
  "conta": "00012345-6",
  "cpfCnpj": "<cpf>",
  "identificadorFatura": "STMT-EXAMPLE-10"
}
    {
  "agencia": "0123",
  "conta": "00012345-6",
  "contaDebito": {
    "produto": "001",
    "numero": "00012345",
    "digitoVerificador": "6",
    "agencia": "0123"
  },
  "cpfCnpj": "<cpf>",
  "dataRetorno": "2026-10-20",
  "dataSolicitacao": "2026-10-05",
  "identificadorFatura": "STMT-EXAMPLE-10",
  "remessa": "REMITTANCE-EXAMPLE",
  "situacao": "AGENDADO",
  "tipoSolicitacao": "DEBITO_AUTOMATICO",
  "valorDebitado": "0.00",
  "valorSolicitado": "1842.55"
}

  • 登记账户自动扣款

    POST /v1/statement-payments/direct-debit/enrolments openfinance

    通过 agencia、conta、cpfCnpj、identificadorFatura、valorSolicitado、tipoSolicitacao 和 contaDebito 为信用卡账单登记自动扣款，并返回 situacao 和 dataSolicitacao。

    认证方式： 使用持卡人令牌交换获得的 Bearer access_token，且须有已认证的持卡人会话。该操作还需具备相应的信用卡管理权限。

    • agencia
    • conta
    • cpfCnpj
    • identificadorFatura
    • valorSolicitado
    • tipoSolicitacao
    • contaDebito
    • produto
    • numero
    • digitoVerificador
    • situacao
    • dataSolicitacao
    POST /v1/statement-payments/direct-debit/enrolments HTTP/1.1
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "agencia": "0123",
  "conta": "00012345-6",
  "cpfCnpj": "<cpf>",
  "identificadorFatura": "STMT-EXAMPLE-10",
  "valorSolicitado": "1842.55",
  "tipoSolicitacao": "DEBITO_AUTOMATICO",
  "contaDebito": {
    "produto": "001",
    "numero": "00012345",
    "digitoVerificador": "6",
    "agencia": "0123"
  }
}
    {
  "identificadorFatura": "STMT-EXAMPLE-10",
  "situacao": "AGENDADO",
  "valorSolicitado": "1842.55",
  "dataSolicitacao": "2026-10-05"
}

数据类别

  • 信用卡账单
  • 消费支出画像
  • 信用额度
  • 虚拟卡
  • 自动扣款
  • 身份信息

数据使用场景与案例

  • 信用卡结账周期对账

    家庭记账工具读取 identifierCodeBill、billCutOffDate、totalSpend 和 groupsMCC，无需打开 PDF，即可将 CAIXA Visa 卡某个账期的记录与 POS 消费凭据核对。

  • 提额方案监测

    发卡机构运营团队按 chpras、numeroCartao 和 bandeiraCartao 跟踪 limiteAtual、valorAumentoLimite 与 novoLimite，并按 agencia、conta 和 cpf 跟踪应急额度标志。

  • 虚拟卡结账凭据管理

    电商后端按 branch、account、creditcardClientIdentifier 和 documentType 列出虚拟卡，再在持卡人授权单次扣款时，通过使用两个标识符的 consultarCVV 调用获取 CVV。

  • 自动扣款与工资入账匹配

    工资处理机器人读取 identificadorFatura、valorSolicitado、valorDebitado 和 situacao，并与 ContaDebito 中的 numero、digitoVerificador 核对，使工资入账能够覆盖计划中的信用卡账单扣款。

常见问题

Cartões CAIXA 数据 API 展示哪些信用卡数据？

涵盖当期及已结账账单、附属卡账单引用信息、PDF 账单标识符、商户类别支出、应急额度查询、长期提额方案、虚拟卡流程和自动扣款计划。示例使用演示路径与模拟值，而非发卡机构的线上服务地址。

示例如何表示持卡人身份认证？

通过授权码或刷新令牌交换，获取 access_token、refresh_token 及令牌有效期、授权范围等元数据。后续信用卡请求需要 Bearer access_token、已认证的持卡人会话，以及相应操作指定的权限。客户端标识符、授权码和重定向值均为占位符；示例不提供对个人财务信息的公开访问。

哪些字段支持信用卡账单对账？

identifierCodeBill 和 billCutOffDate 标识账期，totalSpend 和 groupsMCC 描述分类支出。identifierCode、identifierClient 和 cardNumber 将账单引用信息串联起来，也适用于附属卡账期。

如何将自动扣款与账单匹配？

identificadorFatura 将计划扣款关联至相应账单。valorSolicitado、valorDebitado 和 situacao 分别表示申请金额、已扣金额和计划状态；contaDebito 包含关联账户详情，dataSolicitacao 和 dataRetorno 记录申请日期与返回日期。

与 Cartões CAIXA 相似的应用

  • Bradesco Cartões — Bradesco Cartões 是巴西布拉德斯科银行的专用信用卡应用，可查看实时消费与额度、通过 Pix 或 PDF 账单缴付电子账单、锁定或解锁卡片及感应支付，并生成用于网购的虚拟卡。
  • Nubank — Nubank 的巴西应用把免费 NuConta 数字账户与免年费国际信用卡放在一起，提供全天免费不限次数的 Pix，并在应用内管理消费、转账和支付。
  • BB: Banco, Conta, Pix, Cartão — 巴西银行（Banco do Brasil）的 BB 应用提供完整数字账户，涵盖 Pix、信用卡、贷款和融资，由这家政府控股银行运营。
  • Banco Itaú: Conta, Cartão e + — 巴西伊塔乌银行（Itaú）的零售应用可开户、申请信用卡、发送 Pix，并在同一登录下使用返现、投资和贷款。
  • Inter: Conta, Cartão e Pix — Inter 的超级应用提供巴西数字账户，支持免费不限次数的 Pix、TED 和 DOC，并配有带积分计划的国际信用卡及用于网购和感应支付的虚拟卡。
  • C6 Bank: Cartão, Conta e Mais! — C6 Bank 应用是巴西数字银行，除雷亚尔数字账户和国际账户外，还可发行信用卡。
  • Santander Brasil — Santander Brasil 应用是西班牙桑坦德集团巴西子公司的银行应用，提供数字账户、信用卡和贷款。
  • Cartão Carrefour: Crédito e + — Banco CSF 的 Cartão Carrefour 应用面向家乐福商店信用卡持卡人，可查询可用与已用额度、实时跟踪消费、生成条码缴付账单，并申请附属卡。

更多银行类应用

相关主题

  • Cartões CAIXA
  • Caixa Econômica Federal
  • CAIXA 信用卡账单
  • CAIXA 虚拟卡
  • 应急信用额度
  • 信用卡自动扣款
  • 巴西信用卡 API
  • CAIXA 账单数据
  • MCC 消费画像

需要集成这个 App 的数据 API？

我们可为任意指定 App 交付定制集成——源码交付 USD 500 起，或托管 API 按调用计费。告诉我们您需要的数据即可。

  • 每个项目均签 NDA 与 SOW
  • 3–7 天交付
  • 验收通过后才付款
  • 仅在授权范围内作业

获取报价