BrasilCard Cliente 数据 API：fatura、额度与 Pix

BrasilCard · 支付 4.8 ★

BrasilCard Cliente 是 BrasilCard（BRASIL CARD INSTITUIÇÃO DE PAGAMENTOS LTDA）的持卡人应用。这家总部位于米纳斯吉拉斯州 Monte Belo 的支付机构，从商场联名卡起家，现已加上 Visa 标识并提供数字账户。用户凭 CPF 登录——设备上可选指纹或人脸解锁——首页展示当期 fatura、实时消费、可用额度，以及可拿到网上银行去缴的条码；同一会话还能解锁卡片、改到期日、申请补卡、办理取现和手机充值，并进入逾期余额的 Feira de Negociação。数字账户引导则加上 Pix 与 TED、boleto 开具与缴纳，以及无卡消费；应用内与 Ágil 合作的个人贷款最长 36 期，审批后承诺 24 个工作小时内放款。应用仅在巴西上架（[email protected]，Av. Jorge Vieira 257, Monte Belo-MG），Google Play 评分 4.8、约 33.4 万条评价、安装量超过 500 万，定位更接近巴西私营品牌卡与 Visa 消费卡应用，而非全能银行。

Visa 卡面上的 availableLimit 对照 totalLimit，紧挨着当期 fatura 的 invoiceAmount 与 linhaDigitavel，再加上实时 merchantName 刷卡和数字账户里的 BRL accountBalance。催收方把 dueDate 对上网银回单，家庭看板在消费前看剩余额度，信贷栈则读取同一会话里 Ágil 的 principalAmount 与 Pix 的 endToEndId。openData Studio 把这张卡、fatura 与 Pix 数据面变成可调用的开放数据。

应用截图

API 端点一览

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

CPF 登录
POST /v2/sessions/open opendata
用持卡人 CPF 与密码换取 Bearer 会话，之后每一次 fatura、额度与 Pix 调用都靠它。
认证方式：无需令牌。凭 CPF 加密码换取 accessToken；之后的调用携带 Authorization: Bearer。设备生物识别只用于解锁本地保存的会话。
- cpf
- password
- deviceId
- appVersion
- accessToken
- refreshToken
- tokenType
- expiresIn
- customerId
- mustChangePassword
```
POST /v2/sessions/open HTTP/1.1
Content-Type: application/json

{
  "cpf": "12345678901",
  "password": "<password>",
  "deviceId": "a1b2c3d4-e5f6",
  "appVersion": "8.1.2"
}
```
```
{
  "accessToken": "<access-token>",
  "refreshToken": "<refresh-token>",
  "tokenType": "Bearer",
  "expiresIn": 3600,
  "customerId": "CST-44190821",
  "mustChangePassword": false
}
```

持卡人资料

GET /v2/holder/profile osint

返回已登录持卡人的姓名、CPF、邮箱、手机号与米纳斯地址，用于资料页和联系方式页。

认证方式：携带 /v2/sessions/open 返回的 Bearer 令牌。

customerId
fullName
cpf
email
phone
birthDate
addressCity
addressState

GET /v2/holder/profile HTTP/1.1
Authorization: Bearer <access-token>

{
  "customerId": "CST-44190821",
  "fullName": "Maria Aparecida Silva",
  "cpf": "12345678901",
  "email": "[email protected]",
  "phone": "35998201253",
  "birthDate": "1988-03-14",
  "addressCity": "Monte Belo",
  "addressState": "MG"
}

卡片额度快照

GET /v2/holder/card/summary openfinance

读取首页上的 Visa 卡片：last4Digits、totalLimit、usedLimit、availableLimit 与 dueDay。

认证方式：携带 /v2/sessions/open 返回的 Bearer 令牌。

cardId
last4Digits
brand
productName
cardStatus
totalLimit
usedLimit
availableLimit
currency
dueDay
isContactlessEnabled
expiryDate

GET /v2/holder/card/summary HTTP/1.1
Authorization: Bearer <access-token>

{
  "cardId": "CRD-882144",
  "last4Digits": "4419",
  "brand": "VISA",
  "productName": "BrasilCard Visa",
  "cardStatus": "ACTIVE",
  "totalLimit": 3500.00,
  "usedLimit": 1284.70,
  "availableLimit": 2215.30,
  "currency": "BRL",
  "dueDay": 10,
  "isContactlessEnabled": true,
  "expiryDate": "2028-11"
}

当期 fatura

GET /v2/holder/statement/open openbanking

返回首页实时展示的当期月度 fatura：invoiceAmount、minimumPayment、dueDate 与 closingDate。

认证方式：携带 /v2/sessions/open 返回的 Bearer 令牌。

invoiceId
referenceMonth
invoiceAmount
minimumPayment
dueDate
closingDate
status
currency
previousBalance
paymentsReceived

GET /v2/holder/statement/open HTTP/1.1
Authorization: Bearer <access-token>

{
  "invoiceId": "INV-2026-10",
  "referenceMonth": "2026-10",
  "invoiceAmount": 842.35,
  "minimumPayment": 126.35,
  "dueDate": "2026-10-10",
  "closingDate": "2026-09-30",
  "status": "OPEN",
  "currency": "BRL",
  "previousBalance": 410.00,
  "paymentsReceived": 410.00
}

Fatura 缴款条码

GET /v2/holder/statement/open/slip openbanking

签发持卡人粘贴到网上银行缴纳当期 fatura 的 FEBRABAN linhaDigitavel / 条码。

认证方式：携带 /v2/sessions/open 返回的 Bearer 令牌。

invoiceId
barcode
linhaDigitavel
amount
dueDate
beneficiaryName
currency

GET /v2/holder/statement/open/slip HTTP/1.1
Authorization: Bearer <access-token>

{
  "invoiceId": "INV-2026-10",
  "barcode": "23793381286000084235128000008423500008423518",
  "linhaDigitavel": "23793.38128 60000.842351 28000.008423 5 00008423518000",
  "amount": 842.35,
  "dueDate": "2026-10-10",
  "beneficiaryName": "BRASIL CARD INSTITUICAO DE PAGAMENTOS LTDA",
  "currency": "BRL"
}

实时刷卡消费

GET /v2/holder/activity/feed openbanking

分页返回实时授权：merchantName、amount、installmentCount、authorizedAt，对应每次刷卡后消费磁贴上的流水。

认证方式：携带 /v2/sessions/open 返回的 Bearer 令牌。

purchases
purchaseId
merchantName
mcc
amount
installmentCount
installmentNumber
currency
authorizedAt
status
channel
nextCursor

GET /v2/holder/activity/feed?limit=20&cursor=0 HTTP/1.1
Authorization: Bearer <access-token>

{
  "purchases": [
    {
      "purchaseId": "PUR-991002",
      "merchantName": "SUPERMERCADO CENTRAL",
      "mcc": "5411",
      "amount": 186.40,
      "installmentCount": 1,
      "installmentNumber": 1,
      "currency": "BRL",
      "authorizedAt": "2026-10-18T14:22:01-03:00",
      "status": "CAPTURED",
      "channel": "POS"
    }
  ],
  "nextCursor": "20"
}

缴纳当期 fatura

POST /v2/holder/statement/open/settle openfinance

从数字账户用 Pix（或 boleto）结清当期 fatura，返回 paymentId、status 与 endToEndId。

认证方式：携带 /v2/sessions/open 返回的 Bearer 令牌。

invoiceId
amount
method
accountId
paymentId
status
endToEndId
paidAt

POST /v2/holder/statement/open/settle HTTP/1.1
Authorization: Bearer <access-token>
Content-Type: application/json

{
  "invoiceId": "INV-2026-10",
  "amount": 842.35,
  "method": "PIX",
  "accountId": "ACC-1002"
}

{
  "paymentId": "PAY-INV-7001",
  "invoiceId": "INV-2026-10",
  "amount": 842.35,
  "method": "PIX",
  "status": "SETTLED",
  "endToEndId": "E12345678202610181221BC7001",
  "paidAt": "2026-10-18T12:21:44-03:00"
}

数字账户快照
GET /v2/holder/wallet/balance openfinance
读取应用内开通的数字账户：accountBalance、branch、accountNumber，以及用于 Pix 与 TED 的 CPF pixKey。
认证方式：携带 /v2/sessions/open 返回的 Bearer 令牌。
- accountId
- branch
- accountNumber
- accountBalance
- blockedBalance
- currency
- pixKey
- pixKeyType
- status
```
GET /v2/holder/wallet/balance HTTP/1.1
Authorization: Bearer <access-token>
```
```
{
  "accountId": "ACC-1002",
  "branch": "0001",
  "accountNumber": "123456-7",
  "accountBalance": 612.80,
  "blockedBalance": 0.0,
  "currency": "BRL",
  "pixKey": "12345678901",
  "pixKeyType": "CPF",
  "status": "ACTIVE"
}
```

发起 Pix

POST /v2/holder/wallet/instant-transfers openfinance

从数字账户向 destinationKey 发起 Pix，返回 endToEndId、destinationName 与结算状态。

认证方式：携带 /v2/sessions/open 返回的 Bearer 令牌。

accountId
destinationKey
destinationKeyType
amount
description
transferId
endToEndId
currency
status
destinationName
destinationBankIspb
settledAt

POST /v2/holder/wallet/instant-transfers HTTP/1.1
Authorization: Bearer <access-token>
Content-Type: application/json

{
  "accountId": "ACC-1002",
  "destinationKey": "35998201253",
  "destinationKeyType": "PHONE",
  "amount": 75.00,
  "description": "Repasse"
}

{
  "transferId": "PIX-33091",
  "endToEndId": "E12345678202610181502BC33091",
  "amount": 75.00,
  "currency": "BRL",
  "status": "SETTLED",
  "destinationName": "JOAO PEDRO LIMA",
  "destinationBankIspb": "00000000",
  "settledAt": "2026-10-18T15:02:11-03:00"
}

缴纳 boleto

POST /v2/holder/wallet/slip-payments openfinance

摄像头读出 linhaDigitavel 后，从数字账户缴纳第三方 boleto，返回 beneficiaryName 与 status。

认证方式：携带 /v2/sessions/open 返回的 Bearer 令牌。

accountId
linhaDigitavel
amount
boletoPaymentId
beneficiaryName
dueDate
status
paidAt

POST /v2/holder/wallet/slip-payments HTTP/1.1
Authorization: Bearer <access-token>
Content-Type: application/json

{
  "accountId": "ACC-1002",
  "linhaDigitavel": "23793.38128 60000.150001 28000.008423 8 00000150000000",
  "amount": 150.00
}

{
  "boletoPaymentId": "BOL-44012",
  "linhaDigitavel": "23793.38128 60000.150001 28000.008423 8 00000150000000",
  "amount": 150.00,
  "beneficiaryName": "CIA DE SANEAMENTO",
  "dueDate": "2026-10-20",
  "status": "SETTLED",
  "paidAt": "2026-10-18T16:40:02-03:00"
}

解锁卡片

POST /v2/holder/card/activate opendata

激活已送达的实体卡（Desbloquear seu cartão），并可在同一卡片设置页改到期日。

认证方式：携带 /v2/sessions/open 返回的 Bearer 令牌。

cardId
cvv
cardStatus
unlockedAt
dueDay

POST /v2/holder/card/activate HTTP/1.1
Authorization: Bearer <access-token>
Content-Type: application/json

{
  "cardId": "CRD-882144",
  "cvv": "<cvv>"
}

{
  "cardId": "CRD-882144",
  "cardStatus": "ACTIVE",
  "unlockedAt": "2026-10-12T09:15:00-03:00",
  "dueDay": 10
}

Ágil 贷款报价

GET /v2/holder/credit/quotes openfinance

列出应用内贷款磁贴上的 Ágil 个人贷款报价（principalAmount、installmentCount、monthlyRate、apr），最长 36 期。

认证方式：携带 /v2/sessions/open 返回的 Bearer 令牌。

partner
offers
offerId
principalAmount
installmentCount
installmentAmount
totalAmount
monthlyRate
apr
currency
minSettlementDays
maxSettlementDays

GET /v2/holder/credit/quotes HTTP/1.1
Authorization: Bearer <access-token>

{
  "partner": "AGIL",
  "offers": [
    {
      "offerId": "L-AGIL-1000-5",
      "principalAmount": 1000.00,
      "installmentCount": 5,
      "installmentAmount": 442.94,
      "totalAmount": 2214.70,
      "monthlyRate": 0.1599,
      "apr": 4.9299,
      "currency": "BRL",
      "minSettlementDays": 61,
      "maxSettlementDays": 1095
    }
  ]
}

数据类别

身份
卡片
额度
账单
交易
Pix
boleto
贷款

数据使用场景与案例

Fatura 催收对账
催收或家庭预算机器人按账期拉取 invoiceAmount、dueDate 与 linhaDigitavel，把 paymentsReceived 与网银回单对齐，并在 dueDay 之后仍为 OPEN 的 fatura 上打标。
额度与消费监控
家庭看板对照 availableLimit 与 usedLimit，并订阅实时消费流里的 merchantName / amount / installmentCount，让第二持卡人在刷卡前看到剩余额度。
Pix 与 boleto 资金流
记账方读取 accountBalance 与 pixKey，再记下出站 Pix 的 endToEndId 以及 boleto 的 beneficiaryName，让数字账户与 Visa 卡共用一本账。
Ágil 报价获客
信贷栈消费应用内 Ágil 报价的 principalAmount、installmentCount、monthlyRate 与 apr，并在展示再融资前与卡片 availableLimit 比较。

常见问题

BrasilCard Cliente 暴露哪些卡片数据？

重建后的接口面覆盖 Visa 卡（last4Digits、totalLimit、usedLimit、availableLimit、dueDay）、当期 fatura（invoiceAmount、minimumPayment、dueDate、linhaDigitavel）、实时消费（merchantName、amount、installmentCount）、数字账户（accountBalance、pixKey）、Pix 与 boleto 支付、卡片解锁，以及 Ágil 贷款报价（principalAmount、installmentCount、apr）。

应用如何验证持卡人？

登录凭 CPF 加密码，返回后续调用使用的 Bearer accessToken。设备上的指纹或人脸解锁只打开本地保存的会话，并不能代替服务端登录。

能用数字账户缴 fatura，而不只靠条码吗？

可以。首页流程仍会签发供网银使用的 FEBRABAN linhaDigitavel；数字账户也能用 Pix（method=PIX，endToEndId）结清同一 invoiceId，或用 accountBalance 缴纳其他 boleto。

这是公开的 BrasilCard 开发者 API 吗？

不是。这些是持卡人应用登录后使用的第一方端点，依据其 fatura、Pix、解锁与 Ágil 界面重建，并非对外文档化的合作方 API。

与 BrasilCard Cliente 相似的应用

Cartão Carrefour: Crédito e + — Banco CSF 的 Cartão Carrefour 持卡人应用可查看可用与已用额度、实时消费和最佳购物日，生成缴 fatura 的条码，申请附属卡，并提供个人贷款。
Credz — Credz（Credz S.A. Instituição de Pagamento / DMCARD SA）是巴西商场联名卡发卡机构，应用可查询额度、密码和 fatura，开通虚拟卡，并进入 Club Credz 商户折扣与积分。
Cartão Magalu — Itaú 的 Cartão Magalu 应用管理 Magazine Luiza 与 Luiza 商场信用卡，提供 Magalu 返现、fatura 缴纳与重组，以及用于网购的临时或周期虚拟卡。
Nubank — Nubank 的 Android 应用是这家圣保罗数字银行的入口，提供免年费国际信用卡、免费 NuConta、全天候 Pix、应用内贷款以及从 1 雷亚尔起投的理财。
Digio — Digio 是 Bradesco 旗下数字银行，应用把国际信用卡（闪付与虚拟卡）、免费数字账户、Pix 以及最高按 CDI 105% 计息的理财放在一起。
PicPay — PicPay 是巴西数字银行，应用里有活期账户、Pix、多档 PicPay 信用卡、个人与工资贷、Cofrinho 存钱罐以及应用内理财。
C6 Bank — C6 Bank 应用可开立雷亚尔、美元或欧元数字账户，按审批发放信用卡，并提供国际借记卡以及巴西与海外资产的经纪功能。
Bradesco Cartões — Bradesco Cartões 是 Banco Bradesco 管理 Bradesco 与 Bradescard 信用卡的应用，可查看实时额度与消费、电子 fatura 及 Pix/boleto 缴费，并即时锁卡或开关闪付。

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

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

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

获取报价

BrasilCard Cliente 数据 API：fatura、额度与 Pix

应用截图

API 端点一览

CPF 登录

持卡人资料

卡片额度快照

当期 fatura

Fatura 缴款条码

实时刷卡消费

缴纳当期 fatura

数字账户快照

发起 Pix

缴纳 boleto

解锁卡片

Ágil 贷款报价

数据类别

数据使用场景与案例

Fatura 催收对账

额度与消费监控

Pix 与 boleto 资金流

Ágil 报价获客

常见问题

与 BrasilCard Cliente 相似的应用

更多支付类应用

BharatPe for Business

BukuWarung Apps for MSMEs

CashBook - Balance & Expense

Dhan Barse

相关主题

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

BrasilCard Cliente 数据 API：fatura、额度与 Pix

应用截图

API 端点一览

CPF 登录

持卡人资料

卡片额度快照

当期 fatura

Fatura 缴款条码

实时刷卡消费

缴纳当期 fatura

数字账户快照

发起 Pix

缴纳 boleto

解锁卡片

Ágil 贷款报价

数据类别

数据使用场景与案例

Fatura 催收对账

额度与消费监控

Pix 与 boleto 资金流

Ágil 报价获客

常见问题

相关应用

与 BrasilCard Cliente 相似的应用

更多支付类应用

BharatPe for Business

BukuWarung Apps for MSMEs

CashBook - Balance & Expense

Dhan Barse

相关主题

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