Cartão Atacadão Data API: invoices, Pix, yield and cashback
Cartão Atacadão: Crédito e + is Banco CSF S/A's app for Atacadão cardholders in Brazil. It brings together card purchases, available credit, current and previous faturas, bill payments, installment options and personal-credit offers. Customers can also manage Pix keys and transfer limits, check Conta Digital balances and yield, link banks through Open Finance, create virtual cards and track cashback rewards. Built for shoppers managing their Atacadão spending alongside everyday account activity, the app has a 4.77 Google Play rating across 227,373 reviews.
Atacadão fatura cycles connect invoiceAmount and minimumPayment to dueDate, closeDate and availableLimit. Purchase entries add transactionId, cardFinalDigits, installmentPosition and authCode, giving household ledgers the identifiers and installment details needed to reconcile warehouse receipts against card statements.
Digital-account records pair balance and unavailableBalance with dated yield totals, while Pix records distinguish pixKeyType, limitsRuleFor and currentLimit. Open Finance permissions associate consentId with organizationName and expirationDate; cashback records add currentBalance, daysToExpire and totalAccumulated. These fields support account-balance dashboards, transfer-limit monitors, linked-bank inventories and rewards-expiry alerts. openData Studio turns this card, account and rewards data into callable open data; the API examples below are illustrative.
Screenshots
API surface
The endpoints and request/response examples below are reconstructed from the app's interface — illustrative, not a live capture.
CSF SSO login (Atacadão brand)
POST
/v1/access/sessionsopendataExchanges the Atacadão cardholder CPF and password (plus optional smsToken) for the CSF SSO session on brand atc: accessToken, refreshToken, sessionState and tokenType.
Auth: None. CPF, password and device identifiers mint accessToken for brand=atc; later calls send Authorization: Bearer plus a device attestation header.
- 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 }Identify cardholder
GET
/v1/member/productsosintResolves the signed-in CSF Atacadão customer into uniqueUserId plus mapped card, digital-account and cashback product flags used on the home modules.
Auth: Bearer accessToken from the sign-in call; a device attestation header accompanies every request.
- 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" } }Credit-card home summary
GET
/v1/cardbook/overviewopenfinanceLoads the Atacadão card home snapshot: invoiceValue, availableLimitValue, expirationDate and the pay / parcel action flags.
Auth: Bearer accessToken from the sign-in call; a device attestation header accompanies every request.
- 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 }List my cards
GET
/v1/cardbook/cardsopenfinanceReturns the CSF Atacadão card account and plastic list shown on Meus Cartões, including invoiceSendType and expirationDay.
Auth: Bearer accessToken from the sign-in call; a device attestation header accompanies every request.
- 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" } ] }Open and previous invoices
GET
/v1/billing/cyclesopenfinanceReads open and previous Atacadão faturas with invoiceAmount, minimumPayment, dueDate, barcode and limit remaining.
Auth: Bearer accessToken from the sign-in call; a device attestation header accompanies every request.
- 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 }Invoice releases
GET
/v1/billing/entriesopenfinanceLists fatura lançamentos with merchant description, installmentPosition and authCode for the statement screen.
Auth: Bearer accessToken from the sign-in call; a device attestation header accompanies every request.
- 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" } ] }Invoice Pix QR code
GET
/v1/billing/accounts/{accountNumber}/pix-codeopenbankingIssues the Pix copia-e-cola and QR image used to pay the open Atacadão fatura, plus remaining invoiceValue.
Auth: Bearer accessToken from the sign-in call; a device attestation header accompanies every request.
- 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 } }Digital-account yield balances
GET
/v1/savings/returnsopenbankingReads Conta Digital yield: available balance, unavailableBalance, nested yield.totals (date / inYear) and referenteDate.
Auth: Bearer accessToken from the sign-in call; a device attestation header accompanies every request.
- 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" } }List Pix DICT keys
GET
/v1/transfers/pix/identifiersopenbankingLists DICT keys registered on the CSF digital account with pixKeyType and the settlement account (agency, accountNumber).
Auth: Bearer accessToken from the sign-in call; a device attestation header accompanies every request.
- 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 transfer limits
GET
/v1/transfers/pix/allowancesopenbankingReturns daytime/nighttime Pix currentLimit and in-flight inProcessingLimit used on the safety screen.
Auth: Bearer accessToken from the sign-in call; a device attestation header accompanies every request.
- 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 reception accounts
GET
/v1/connections/permissionsopenfinanceLists inbound Open Finance consents (reception) with organizationName, consentId and expirationDate.
Auth: Bearer accessToken from the sign-in call; a device attestation header accompanies every request.
- 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" }Cashback rewards summary
GET
/v1/loyalty/wallets/{accountId}/balanceopendataReads the Atacadão/Carrefour rewards wallet: currentBalance, daysToExpire, totalAccumulated and accumulationLimit.
Auth: Bearer accessToken from the sign-in call; a device attestation header accompanies every request.
- 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": {} }Create virtual card
POST
/v1/cardbook/virtual-cardsopenfinanceMints a CSF Atacadão virtual card (PAN, CVV, holderName, expirationMinutes) for online or wallet use.
Auth: Bearer accessToken from the sign-in call; a device attestation header accompanies every request.
- 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": [] }Payment-account balance
GET
/v1/funds/positionopenbankingReads the Conta Digital payment-account cash position: availableAmount, blockedAmount and agencyNumber.
Auth: Bearer accessToken from the sign-in call; a device attestation header accompanies every request.
- 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 }Simulate personal credit
GET
/v1/borrowing/accounts/{accountNumber}/quotesopenfinancePrices crédito pessoal plans for the Atacadão card account: valueRequested, valueParcel, cetYearly, iofTotalValue and quantityOfInstallment.
Auth: Bearer accessToken from the sign-in call; a device attestation header accompanies every request.
- 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 } ] }
Data categories
- cardholder identity
- credit-card limits and invoices
- Pix DICT keys and limits
- digital-account yield and movements
- Open Finance consents
- cashback rewards
- virtual cards
- personal credit offers
Where teams use this data
Warehouse-card invoice reconciliation
Finance bots pull invoiceAmount, minimumPayment and lançamento authCode rows so an Atacadão household ledger can match fatura closeDate against cash-and-carry POS receipts.
Pix DICT and limit monitoring
Treasury dashboards watch pixKeyType registrations and daytime/nighttime currentLimit so CSF digital-account cash-out from the Atacadão app stays inside Banco Central Pix rules.
Open Finance reception inventory
Wealth aggregators list organizationName + consentId + expirationDate for banks the Atacadão cardholder linked into Banco CSF as a reception institution.
Rewards wallet expiry alerts
Loyalty ops fire on daysToExpire and currentBalance so Atacadão/Carrefour cashback is spent at the warehouse banner before expireDate.
Frequently asked questions
Which fields help reconcile an Atacadão fatura?
Invoice records include invoiceId, invoiceAmount, minimumPayment, dueDate, closeDate, totalLimit and availableLimit. Purchase entries add transactionId, description, cardFinalDigits, installmentPosition and authCode to help match receipts to a statement cycle.
What Pix and Open Finance data is covered?
Pix records include pixKey, pixKeyType, registration dates and the associated account. Transfer limits distinguish limitsRuleFor, limitsRulePeriod, currentLimit and inProcessingLimit. Open Finance permissions identify consentId, organizationName, status and expirationDate.
How do Conta Digital yield and cashback records differ?
Conta Digital yield records describe balance, unavailableBalance, referenteDate and yield totals. Cashback records describe currentBalance, daysToExpire, expireDate, totalAccumulated and accumulationLimit, supporting separate cash-position and rewards-expiry views.
Which personal-credit simulation fields are available?
Illustrative credit plans include preApproved, planCode, valueRequested, valueParcel, quantityOfInstallment, cetYearly, iofTotalValue and valueInsurance. These distinguish the requested amount, installments, annual cost, taxes and insurance within a simulation. All API paths and sample values on this page illustrate the data covered; they are not Banco CSF production connection details or live customer records.
Apps similar to Cartão Atacadão: Crédito e +
- Cartão Carrefour: Crédito e + — Banco CSF S/A's app for Carrefour cardholders covers available and used limit, real-time spending, a barcode to pay the fatura, personal-loan requests, Open Finance, and exclusive conditions at Carrefour, Atacadão and Sam's Club.
- Cartão Sam's Club: Crédito e + — Banco CSF S/A's companion app for the Sam's Club credit card is used to check the limit, pay the bill via Pix, request a personal loan, connect accounts through Open Finance, and use conditions at the clubs, Carrefour and Atacadão (club benefits require membership).
- Cartão Magalu — Itaú Unibanco's Cartão Magalu app manages Magalu and Luiza store credit cards with Magalu cashback, fatura inquiry, renegotiation and installment payment, temporary or recurring virtual cards, limit-increase requests and a personal loan.
- Cartão Mais! — Cred-System's Cartão Mais app shows card limits and transaction history, helps control spending, and lists the card's promotions and partnerships.
- Credz — Credz (DMCARD SA) is a Brazilian store-card app that looks up limit, PIN and invoices, activates a virtual card, and opens Club Credz merchant discounts and loyalty points.
- BrasilCard Cliente — BrasilCard Cliente is BrasilCard's cardholder app for tracking invoices and live purchases, generating a barcode to pay the fatura, unblocking the card and changing the due date, and requesting a duplicate or debt negotiation.
- Nubank — Nubank's Brazilian Android app (Nu Pagamentos) combines a free NuConta, a no-annual-fee international credit card, free unlimited Pix 24/7, loans, investments from R$1, life insurance and cashback.
- Cartões CAIXA — Cartões CAIXA is Caixa Econômica Federal's app for CAIXA credit cards, covering limit and up to 40 latest faturas, PDF invoices, on/off for purchases and withdrawals, virtual-card limits, CAIXA Points, invoice installments and a digitizable payment line.
Topics
- Cartão Atacadão data API
- Banco CSF fatura data
- Atacadão purchase installments
- Pix key and limit data
- Conta Digital yield data
- Open Finance consent data
- Atacadão cashback expiry
Need this app's data API integrated?
We deliver scoped integrations for any named app — from USD 500 with source-code handoff, or hosted access billed per call. Tell us the data you need.
- NDA + SOW on every engagement
- Delivery in 3–7 days
- Payment only after acceptance
- Work scoped to authorized use