Cartão Atacadão 数据 API：账单、Pix、收益与返现

Banco CSF S/A · 银行 4.8 ★

Cartão Atacadão: Crédito e + 是 Banco CSF S/A 为巴西 Atacadão 持卡人推出的应用，集信用卡消费、可用额度、本期与历史账单、账单支付、分期选项及个人信贷优惠于一体。用户还可管理 Pix 收款标识与转账限额，查看 Conta Digital 数字账户的余额和收益，通过 Open Finance 关联银行账户，创建虚拟卡并跟踪返现奖励。它面向需要兼顾 Atacadão 购物开支与日常账户管理的消费者，在 Google Play 获得 4.77 分，共有 227,373 条评价。

Atacadão 账单周期将 invoiceAmount 和 minimumPayment 与 dueDate、closeDate 及 availableLimit 关联起来。消费明细补充 transactionId、cardFinalDigits、installmentPosition 与 authCode，为家庭记账工具提供核对仓储卖场小票与信用卡账单所需的标识和分期细节。

数字账户记录将 balance、unavailableBalance 与按日期汇总的 yield 收益配对，Pix 记录则区分 pixKeyType、limitsRuleFor 和 currentLimit。Open Finance 授权通过 consentId 关联 organizationName 与 expirationDate；返现记录进一步提供 currentBalance、daysToExpire 及 totalAccumulated。这些字段可支撑账户余额看板、转账限额监控、已关联银行清单和奖励到期提醒。openData Studio 将这些信用卡、账户及奖励数据转化为可调用的开放数据；下方 API 示例仅用于说明。

应用截图

API 端点一览

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

CSF 单点登录（Atacadão 品牌）
POST /v1/access/sessions opendata
使用 Atacadão 持卡人的 CPF 和密码（可附加 smsToken），换取品牌 atc 的 CSF 单点登录会话，返回 accessToken、refreshToken、sessionState 与 tokenType。
认证方式：无需预先认证。CPF、密码和设备标识用于签发品牌 atc 的 accessToken；后续调用在 Authorization 请求头中使用 Bearer，并附带设备证明请求头。
- username
- password
- deviceId
- smsToken
- accessToken
- expiresIn
- refreshToken
- refreshExpiresIn
- tokenType
- notBeforePolicy
- sessionState
- scope
- acquisition
```
POST /v1/access/sessions HTTP/1.1
Content-Type: application/json

{
  "username": "<cpf>",
  "password": "<password>",
  "deviceId": "<device-id>",
  "smsToken": "<sms-token>"
}
```
```
{
  "accessToken": "<access-token>",
  "expiresIn": "3600",
  "refreshToken": "<refresh-token>",
  "refreshExpiresIn": "2592000",
  "tokenType": "Bearer",
  "notBeforePolicy": "0",
  "sessionState": "<session-id>",
  "scope": "openid profile",
  "acquisition": false
}
```

识别持卡人

GET /v1/member/products osint

将已登录的 CSF Atacadão 客户解析为 uniqueUserId，并返回首页模块使用的信用卡、数字账户及返现产品标识。

认证方式：使用登录调用取得的 accessToken 进行 Bearer 认证；每个请求均附带设备证明请求头。

uniqueUserId
debtType
accountStatus
cardStatus
situation
accountNumber
cardNumber
cardTypeLabel
flag
hasDebt
isBlockedProduct
rewardWalletStatus

GET /v1/member/products HTTP/1.1
Authorization: Bearer <accessToken>
Accept: application/json

{
  "uniqueUserId": "demo-member-001",
  "card": {
    "cards": [
      {
        "debtType": "REVOLVING",
        "accountStatus": "ACTIVE",
        "cardStatus": "NORMAL",
        "situation": "LIBERADO",
        "accountNumber": "demo-account-001",
        "cardNumber": "************4421",
        "cardTypeLabel": "Cartão Atacadão Visa",
        "flag": "VISA",
        "hasDebt": false,
        "isBlockedProduct": false
      }
    ]
  },
  "account": {
    "accountStatus": "ACTIVE",
    "accountType": "DIGITAL",
    "origin": "CSF"
  },
  "cashback": {
    "rewardWalletStatus": "ACTIVE"
  }
}

信用卡首页概览
GET /v1/cardbook/overview openfinance
加载 Atacadão 信用卡首页概览，包括 invoiceValue、availableLimitValue、expirationDate 及支付／分期操作标识。
认证方式：使用登录调用取得的 accessToken 进行 Bearer 认证；每个请求均附带设备证明请求头。
- status
- expirationDate
- allowedActions
- hasAvailableLimit
- invoiceValue
- availableLimitValue
- enablePaymentButton
- enableAdvancePaymentButton
- hasPendingParcele
```
GET /v1/cardbook/overview HTTP/1.1
Authorization: Bearer <accessToken>
Accept: application/json
```
```
{
  "status": "NORMAL",
  "expirationDate": "2026-11-10",
  "allowedActions": [
    "PAY",
    "PARCEL"
  ],
  "hasAvailableLimit": true,
  "invoiceValue": 1842.55,
  "availableLimitValue": 3210.4,
  "enablePaymentButton": true,
  "enableAdvancePaymentButton": true,
  "hasPendingParcele": false
}
```
列出我的卡片
GET /v1/cardbook/cards openfinance
返回 Meus Cartões（我的卡片）页面展示的 CSF Atacadão 信用卡账户和实体卡列表，包括 invoiceSendType 与 expirationDay。
认证方式：使用登录调用取得的 accessToken 进行 Bearer 认证；每个请求均附带设备证明请求头。
- cardAccountNumber
- accountStatus
- invoiceSendType
- expirationDay
- cards
```
GET /v1/cardbook/cards HTTP/1.1
Authorization: Bearer <accessToken>
Accept: application/json
```
```
{
  "cardAccountNumber": "demo-account-001",
  "accountStatus": "ACTIVE",
  "invoiceSendType": "EMAIL",
  "expirationDay": 10,
  "cards": [
    {
      "flag": "VISA",
      "cardTypeLabel": "Titular"
    }
  ]
}
```

本期与历史账单

GET /v1/billing/cycles openfinance

读取 Atacadão 本期与历史账单，包括 invoiceAmount、minimumPayment、dueDate、barcode 及剩余可用额度。

认证方式：使用登录调用取得的 accessToken 进行 Bearer 认证；每个请求均附带设备证明请求头。

invoiceId
invoiceType
idInvoiceType
dueDate
closeDate
invoiceAmount
minimumPayment
totalLimit
availableLimit
bestDayToBuy
barcode
isEligibleToAnticipate
enablePaymentButton

GET /v1/billing/cycles HTTP/1.1
Authorization: Bearer <accessToken>
Accept: application/json

{
  "invoiceId": "fat-202610",
  "invoiceType": "OPEN",
  "idInvoiceType": 1,
  "dueDate": "2026-11-10",
  "closeDate": "2026-10-28",
  "invoiceAmount": {
    "amount": 1842.55,
    "currency": "BRL"
  },
  "minimumPayment": {
    "amount": 276.38,
    "currency": "BRL"
  },
  "totalLimit": 8000.0,
  "availableLimit": 3210.4,
  "bestDayToBuy": 12,
  "barcode": "<illustrative-boleto-barcode>",
  "isEligibleToAnticipate": true,
  "enablePaymentButton": true
}

账单交易明细

GET /v1/billing/entries openfinance

列出账单页面中的交易明细，包括商户描述、installmentPosition 与 authCode。

认证方式：使用登录调用取得的 accessToken 进行 Bearer 认证；每个请求均附带设备证明请求头。

accountNumber
date
hasFutureReleases
releaseMonth
transactionId
idFatura
cardFinalDigits
cardName
description
amount
installment
installmentPosition
installmentQuantity
authCode
transactionDate

GET /v1/billing/entries HTTP/1.1
Authorization: Bearer <accessToken>
Accept: application/json

{
  "accountNumber": "demo-account-001",
  "date": "2026-10-15",
  "hasFutureReleases": true,
  "releaseMonth": [
    {
      "transactionId": "txn-9f21",
      "idFatura": "fat-202610",
      "cardFinalDigits": "4421",
      "cardName": "DEMO CARDHOLDER",
      "cardType": "TITULAR",
      "description": "ATACADAO CAMPINAS",
      "amount": 189.9,
      "installment": "02/03",
      "installmentPosition": 2,
      "installmentQuantity": 3,
      "authCode": "<authorization-code>",
      "transactionDate": "2026-10-12"
    }
  ]
}

账单 Pix 付款二维码

GET /v1/billing/accounts/{accountNumber}/pix-code openbanking

生成用于支付 Atacadão 本期账单的 Pix 复制粘贴付款码和二维码图像，并返回尚待支付的 invoiceValue。

认证方式：使用登录调用取得的 accessToken 进行 Bearer 认证；每个请求均附带设备证明请求头。

imageBase64
copyPaste
invoiceValue
minimumPayment
expirationDate
closingDate
writableLine
invoicePaid
quantityGenerated

GET /v1/billing/accounts/demo-account-001/pix-code HTTP/1.1
Authorization: Bearer <accessToken>
Accept: application/json

{
  "imageBase64": "<base64-qr-image>",
  "copyPaste": "<illustrative-pix-copy-code>",
  "invoice": {
    "invoiceValue": 1842.55,
    "minimumPayment": 276.38,
    "expirationDate": "2026-11-10",
    "closingDate": "2026-10-28",
    "writableLine": "<illustrative-boleto-line>",
    "invoicePaid": false
  },
  "pix": {
    "quantityGenerated": 1,
    "invoicePaid": false
  }
}

数字账户收益与余额
GET /v1/savings/returns openbanking
读取 Conta Digital 收益信息，包括可用余额、unavailableBalance、嵌套的 yield.totals（date／inYear）及 referenteDate。
认证方式：使用登录调用取得的 accessToken 进行 Bearer 认证；每个请求均附带设备证明请求头。
- balance
- unavailableBalance
- referenteDate
- yield
- totals
- messageSuggestion
- date
- inYear
```
GET /v1/savings/returns HTTP/1.1
Authorization: Bearer <accessToken>
Accept: application/json
```
```
{
  "balance": 1520.33,
  "unavailableBalance": 40.0,
  "referenteDate": "2026-10-20",
  "yield": {
    "totals": {
      "date": 12.47,
      "inYear": 186.2
    },
    "messageSuggestion": "Seu rendimento de ontem"
  }
}
```

列出 Pix DICT 收款标识

GET /v1/transfers/pix/identifiers openbanking

列出 CSF 数字账户已注册的 DICT 收款标识，包括 pixKeyType 与结算账户信息（agency、accountNumber）。

认证方式：使用登录调用取得的 accessToken 进行 Bearer 认证；每个请求均附带设备证明请求头。

keys
pixKey
pixKeyType
dateGenerateKey
dateDomainKey
institution
accountNumber
agency
name

GET /v1/transfers/pix/identifiers HTTP/1.1
Authorization: Bearer <accessToken>
Accept: application/json

{
  "keys": [
    {
      "pixKey": "<phone-pix-key>",
      "pixKeyType": "PHONE",
      "dateGenerateKey": "2025-03-12T11:04:00Z",
      "dateDomainKey": "2025-03-12T11:05:10Z"
    }
  ],
  "account": {
    "institution": "BANCO CSF S.A.",
    "accountNumber": "demo-account-001",
    "agency": "0001",
    "name": "DEMO CARDHOLDER"
  }
}

Pix 转账限额

GET /v1/transfers/pix/allowances openbanking

返回安全设置页面使用的日间／夜间 Pix currentLimit，以及正在处理的 inProcessingLimit。

认证方式：使用登录调用取得的 accessToken 进行 Bearer 认证；每个请求均附带设备证明请求头。

limits
limitsRuleFor
limitsRulePeriod
currentLimit
inProcessingLimit

GET /v1/transfers/pix/allowances HTTP/1.1
Authorization: Bearer <accessToken>
Accept: application/json

{
  "limits": [
    {
      "limitsRuleFor": "DAYTIME",
      "limitsRulePeriod": "DAILY",
      "currentLimit": 5000.0,
      "inProcessingLimit": 8000.0
    },
    {
      "limitsRuleFor": "NIGHTTIME",
      "limitsRulePeriod": "DAILY",
      "currentLimit": 1000.0,
      "inProcessingLimit": 1000.0
    }
  ]
}

Open Finance 数据接收授权
GET /v1/connections/permissions openfinance
列出接收外部数据的 Open Finance 授权，包括 organizationName、consentId 与 expirationDate。
认证方式：使用登录调用取得的 accessToken 进行 Bearer 认证；每个请求均附带设备证明请求头。
- status
- expirationDate
- updatedDate
- consentId
- organizationName
- organizationIcon
```
GET /v1/connections/permissions HTTP/1.1
Authorization: Bearer <accessToken>
Accept: application/json
```
```
{
  "status": "AUTHORISED",
  "expirationDate": "2027-04-20T00:00:00Z",
  "updatedDate": "2026-10-18T14:22:00Z",
  "consentId": "demo-consent-001",
  "organizationName": "Example Bank",
  "organizationIcon": "/assets/demo-bank.png"
}
```

返现奖励概览

GET /v1/loyalty/wallets/{accountId}/balance opendata

读取 Atacadão／Carrefour 奖励钱包，包括 currentBalance、daysToExpire、totalAccumulated 与 accumulationLimit。

认证方式：使用登录调用取得的 accessToken 进行 Bearer 认证；每个请求均附带设备证明请求头。

accumulationInformations
balanceInformations
engagementInformations
redemptionInformations
accumulationLimit
isInAccumulationPeriod
totalAccumulated
currentBalance
daysToExpire
expireDate
rewardFuturePoints
rewardWalletStatus

GET /v1/loyalty/wallets/demo-wallet-001/balance HTTP/1.1
Authorization: Bearer <accessToken>
Accept: application/json

{
  "accumulationInformations": {
    "accumulationLimit": 500.0,
    "isInAccumulationPeriod": true,
    "totalAccumulated": 87.4
  },
  "balanceInformations": {
    "currentBalance": 42.1,
    "daysToExpire": 18,
    "expireDate": "2026-11-07",
    "rewardFuturePoints": 12.0,
    "rewardWalletStatus": "ACTIVE",
    "activatedForTransactionExpiration": true
  },
  "engagementInformations": {},
  "redemptionInformations": {}
}

创建虚拟卡

POST /v1/cardbook/virtual-cards openfinance

生成供线上或钱包使用的 CSF Atacadão 虚拟卡，包括卡号（PAN）、卡片验证码（CVV）、holderName 与 expirationMinutes。

认证方式：使用登录调用取得的 accessToken 进行 Bearer 认证；每个请求均附带设备证明请求头。

id
cardNumber
holderName
securityCode
type
expirationDate
expirationMinutes
flag
dailyTotals

POST /v1/cardbook/virtual-cards HTTP/1.1
Authorization: Bearer <accessToken>
Content-Type: application/json

{
  "type": "SINGLE_USE"
}

{
  "id": "demo-virtual-card-001",
  "cardNumber": "<virtual-card-number>",
  "holderName": "DEMO CARDHOLDER",
  "securityCode": "<security-code>",
  "type": "SINGLE_USE",
  "expirationDate": "2026-10-20T23:59:00Z",
  "expirationMinutes": 1440,
  "flag": "VISA",
  "dailyTotals": []
}

支付账户余额
GET /v1/funds/position openbanking
读取 Conta Digital 支付账户的资金状况，包括 availableAmount、blockedAmount 与 agencyNumber。
认证方式：使用登录调用取得的 accessToken 进行 Bearer 认证；每个请求均附带设备证明请求头。
- accountNumber
- agencyNumber
- availableAmount
- blockedAmount
- balance
```
GET /v1/funds/position HTTP/1.1
Authorization: Bearer <accessToken>
Accept: application/json
```
```
{
  "accountNumber": "demo-account-001",
  "agencyNumber": "0001",
  "availableAmount": 1520.33,
  "blockedAmount": 40.0,
  "balance": 1480.33
}
```

个人信贷试算

GET /v1/borrowing/accounts/{accountNumber}/quotes openfinance

试算 Atacadão 信用卡账户的个人信贷方案，包括 valueRequested、valueParcel、cetYearly、iofTotalValue 与 quantityOfInstallment。

认证方式：使用登录调用取得的 accessToken 进行 Bearer 认证；每个请求均附带设备证明请求头。

maximumInstallmentQuantity
installmentMinimumQuantity
retakeValue
preApproved
gracePeriods
plans
planCode
valueRequested
percentageRequestedValue
totalValue
percentTotalValue
valueParcel
quantityOfInstallment
cetYearly
fees
iofTotalValue
dateFirstParcel
valueInsurance

GET /v1/borrowing/accounts/demo-account-001/quotes HTTP/1.1
Authorization: Bearer <accessToken>
Accept: application/json

{
  "maximumInstallmentQuantity": 24,
  "installmentMinimumQuantity": 6,
  "retakeValue": 4500.0,
  "preApproved": 4500.0,
  "gracePeriods": [],
  "plans": [
    {
      "planCode": "CP24",
      "valueRequested": 3000.0,
      "percentageRequestedValue": "66.67",
      "totalValue": 3720.48,
      "percentTotalValue": "124.02",
      "valueParcel": 155.02,
      "quantityOfInstallment": 24,
      "cetYearly": 89.4,
      "fees": 412.1,
      "iofTotalValue": 48.22,
      "dateFirstParcel": "2026-11-10",
      "valueInsurance": 96.0
    }
  ]
}

数据类别

持卡人身份
信用卡额度与账单
Pix DICT 收款标识与限额
数字账户收益与资金流水
Open Finance 授权
返现奖励
虚拟卡
个人信贷优惠

数据使用场景与案例

仓储卖场信用卡账单核对
财务机器人读取 invoiceAmount、minimumPayment 与账单明细中的 authCode，帮助 Atacadão 家庭记账工具将账单的 closeDate 与仓储卖场 POS 购物小票对应起来。
Pix DICT 标识与限额监控
资金管理看板跟踪 pixKeyType 注册信息，以及日间和夜间的 currentLimit，让通过 Atacadão 应用转出 CSF 数字账户资金的操作保持在巴西央行 Pix 规则范围内。
Open Finance 接收授权清单
财富聚合工具按 organizationName、consentId 和 expirationDate 列出 Atacadão 持卡人关联的银行，呈现 Banco CSF 作为数据接收机构获得的授权。
奖励钱包到期提醒
会员运营依据 daysToExpire 和 currentBalance 触发提醒，帮助用户在 expireDate 之前将 Atacadão／Carrefour 返现用于仓储卖场消费。

常见问题

哪些字段有助于核对 Atacadão 账单？

账单记录包含 invoiceId、invoiceAmount、minimumPayment、dueDate、closeDate、totalLimit 和 availableLimit。消费明细另提供 transactionId、description、cardFinalDigits、installmentPosition 与 authCode，帮助将购物小票对应到具体账单周期。

涵盖哪些 Pix 与 Open Finance 数据？

Pix 记录包含 pixKey、pixKeyType、注册日期与关联账户。转账限额区分 limitsRuleFor、limitsRulePeriod、currentLimit 和 inProcessingLimit。Open Finance 授权则标明 consentId、organizationName、status 与 expirationDate。

Conta Digital 收益记录与返现记录有何区别？

Conta Digital 收益记录描述 balance、unavailableBalance、referenteDate 与 yield 收益汇总。返现记录描述 currentBalance、daysToExpire、expireDate、totalAccumulated 和 accumulationLimit，可分别用于资金余额视图与奖励到期视图。

个人信贷试算提供哪些字段？

示例信贷方案包含 preApproved、planCode、valueRequested、valueParcel、quantityOfInstallment、cetYearly、iofTotalValue 与 valueInsurance。这些字段在试算中区分申请金额、分期、年度成本、税费和保险金额。本页所有 API 路径与示例值仅用于说明所涵盖的数据，并非 Banco CSF 生产环境的连接信息，也不是实时客户记录。

与 Cartão Atacadão: Crédito e + 相似的应用

Cartão Carrefour: Crédito e + — Banco CSF S/A 面向 Carrefour 持卡人的应用，可查看可用与已用额度、实时消费、生成缴 fatura 的条码、申请个人贷款、接入 Open Finance，并在 Carrefour、Atacadão 和 Sam's Club 使用专属条件。
Cartão Sam's Club: Crédito e + — Banco CSF S/A 的 Sam's Club 信用卡配套应用，可查询额度、用 Pix 缴账单、申请个人贷款、通过 Open Finance 关联账户，并在会员店、Carrefour 与 Atacadão 使用优惠（俱乐部权益需会员资格）。
Cartão Magalu — Itaú Unibanco 的 Cartão Magalu 应用管理 Magalu 与 Luiza 商场信用卡，提供 Magalu 返现、账单查询与重组分期、临时或周期虚拟卡、提额申请和个人贷款。
Cartão Mais! — Cred-System 的 Cartão Mais 应用可查看卡片额度与交易记录、管理消费，并列出该卡的促销与合作优惠。
Credz — Credz（DMCARD SA）是巴西商场联名卡应用，可查询额度、密码和账单，开通虚拟卡，并进入 Club Credz 商户折扣与积分。
BrasilCard Cliente — BrasilCard Cliente 是 BrasilCard 的持卡人应用，可查看账单与实时消费、生成缴 fatura 的条码、解锁卡片并改到期日，以及申请补卡或协商欠款。
Nubank — Nubank（Nu Pagamentos）的巴西 Android 应用把免费 NuConta、免年费国际信用卡、全天候免费不限额 Pix、贷款、从 1 雷亚尔起投、寿险和返现放在同一登录下。
Cartões CAIXA — Cartões CAIXA 是巴西联邦储蓄银行 Caixa 的信用卡应用，可查看额度与最近 40 期 fatura、下载 PDF 账单、开关消费与取现、管理虚拟卡额度、兑换 CAIXA Points、账单分期，并生成可复制的缴款行。

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

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

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

获取报价

Cartão Atacadão 数据 API：账单、Pix、收益与返现

应用截图

API 端点一览

CSF 单点登录（Atacadão 品牌）

识别持卡人

信用卡首页概览

列出我的卡片

本期与历史账单

账单交易明细

账单 Pix 付款二维码

数字账户收益与余额

列出 Pix DICT 收款标识

Pix 转账限额

Open Finance 数据接收授权

返现奖励概览

创建虚拟卡

支付账户余额

个人信贷试算

数据类别

数据使用场景与案例

仓储卖场信用卡账单核对

Pix DICT 标识与限额监控

Open Finance 接收授权清单

奖励钱包到期提醒

常见问题

与 Cartão Atacadão: Crédito e + 相似的应用

更多银行类应用

5paisa: Demat, Stocks & IPO

Ajaib: Stock, Crypto, US Stock

Albert: Budgeting and Banking

AndroMoney

相关主题

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

Cartão Atacadão 数据 API：账单、Pix、收益与返现

应用截图

API 端点一览

CSF 单点登录（Atacadão 品牌）

识别持卡人

信用卡首页概览

列出我的卡片

本期与历史账单

账单交易明细

账单 Pix 付款二维码

数字账户收益与余额

列出 Pix DICT 收款标识

Pix 转账限额

Open Finance 数据接收授权

返现奖励概览

创建虚拟卡

支付账户余额

个人信贷试算

数据类别

数据使用场景与案例

仓储卖场信用卡账单核对

Pix DICT 标识与限额监控

Open Finance 接收授权清单

奖励钱包到期提醒

常见问题

相关应用

与 Cartão Atacadão: Crédito e + 相似的应用

更多银行类应用

5paisa: Demat, Stocks & IPO

Ajaib: Stock, Crypto, US Stock

Albert: Budgeting and Banking

AndroMoney

相关主题

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