BrasilCard Cliente icon

BrasilCard Cliente data API: fatura, limite and Pix

BrasilCard · Payments 4.8 ★

BrasilCard Cliente is the cardholder app from BrasilCard (BRASIL CARD INSTITUIÇÃO DE PAGAMENTOS LTDA), the Monte Belo, Minas Gerais payment institution behind a store-originated plastic that now also carries the Visa flag and a digital account. After CPF sign-in — with optional fingerprint or face unlock on the device — the home screen shows the open fatura, live purchases, available limit and a barcode the holder can pay from internet banking; the same session unlocks the card, changes the due date, requests a second copy, runs saques and celular recargas, and opens a Feira de Negociação for overdue balances. The digital-account onboarding adds Pix and TED, boleto generation and payment, and card-not-present shopping, while an in-app Ágil partnership quotes personal loans in up to 36 instalments with funds promised within 24 business hours of approval. Published for Brazil only ([email protected], Av. Jorge Vieira 257, Monte Belo-MG), it holds a 4.8 rating across about 334 thousand Google Play reviews and 5 million-plus installs, sitting with other Brazilian private-label and Visa consumer-card apps rather than full-service banks.

AvailableLimit against totalLimit on the Visa plastic sits next to the open fatura's invoiceAmount and linhaDigitavel, with live merchantName swipes and a conta-digital accountBalance in BRL. Collectors match dueDate to internet-banking slips, household dashboards watch headroom before a purchase, and lending stacks read Ágil principalAmount next to the same session's Pix endToEndId. openData Studio turns that card, fatura and Pix surface into callable open data.

Screenshots

  • BrasilCard Cliente screenshot 1
  • BrasilCard Cliente screenshot 2
  • BrasilCard Cliente screenshot 3
  • BrasilCard Cliente screenshot 4
  • BrasilCard Cliente screenshot 5
  • BrasilCard Cliente screenshot 6

API surface

The endpoints and request/response examples below are reconstructed from the app's interface — illustrative, not a live capture.

  • CPF sign-in

    POST /v2/sessions/open opendata

    Exchanges the cardholder CPF and password for the Bearer session used on every later fatura, limit and Pix call.

    Auth: None. CPF plus password mint accessToken; later calls send Authorization: Bearer. Device biometrics only unlock the locally stored session.

    • 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
    }
  • Cardholder profile

    GET /v2/holder/profile osint

    Returns the signed-in holder — name, CPF, email, phone and MG address — for the profile and contact screens.

    Auth: Bearer token from /v2/sessions/open.

    • 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"
    }
  • Card limit snapshot

    GET /v2/holder/card/summary openfinance

    Reads the Visa plastic on the home screen: last4Digits, totalLimit, usedLimit, availableLimit and dueDay.

    Auth: Bearer token from /v2/sessions/open.

    • 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"
    }
  • Open fatura

    GET /v2/holder/statement/open openbanking

    Returns the open monthly fatura — invoiceAmount, minimumPayment, dueDate and closingDate — that the home tile renders in real time.

    Auth: Bearer token from /v2/sessions/open.

    • 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 payment barcode

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

    Issues the FEBRABAN linhaDigitavel / barcode the holder pastes into internet banking to pay the open fatura.

    Auth: Bearer token from /v2/sessions/open.

    • 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"
    }
  • Live card purchases

    GET /v2/holder/activity/feed openbanking

    Pages real-time authorizations — merchantName, amount, installmentCount, authorizedAt — that the purchases tile streams after each swipe.

    Auth: Bearer token from /v2/sessions/open.

    • 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"
    }
  • Pay open fatura

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

    Settles the open fatura from the digital account via Pix (or boleto) and returns paymentId, status and endToEndId.

    Auth: Bearer token from /v2/sessions/open.

    • 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"
    }
  • Digital account snapshot

    GET /v2/holder/wallet/balance openfinance

    Reads the conta digital opened in-app — accountBalance, branch, accountNumber and the CPF pixKey used for Pix and TED.

    Auth: Bearer token from /v2/sessions/open.

    • 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"
    }
  • Send Pix

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

    Sends a Pix from the digital account to destinationKey and returns endToEndId, destinationName and settlement status.

    Auth: Bearer token from /v2/sessions/open.

    • 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"
    }
  • Pay boleto

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

    Pays a third-party boleto from the digital account after the camera reads linhaDigitavel, returning beneficiaryName and status.

    Auth: Bearer token from /v2/sessions/open.

    • 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"
    }
  • Unlock plastic

    POST /v2/holder/card/activate opendata

    Activates a delivered plastic (Desbloquear seu cartão) and can pair with a due-day change on the same card settings screen.

    Auth: Bearer token from /v2/sessions/open.

    • 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 loan offers

    GET /v2/holder/credit/quotes openfinance

    Lists Ágil personal-loan quotes (principalAmount, installmentCount, monthlyRate, apr) shown on the in-app loan tile, up to 36 instalments.

    Auth: Bearer token from /v2/sessions/open.

    • 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
        }
      ]
    }

Data categories

  • identity
  • cards
  • limits
  • invoices
  • transactions
  • pix
  • boletos
  • loans

Where teams use this data

  • Fatura collection reconciliation

    A collector or family-budget bot pulls invoiceAmount, dueDate and linhaDigitavel each cycle, matches paymentsReceived against internet-banking slips, and flags OPEN faturas still unpaid after dueDay.

  • Limit and spend monitoring

    A household dashboard charts availableLimit versus usedLimit and streams merchantName / amount / installmentCount from the live purchase feed so a second cardholder sees headroom before a swipe.

  • Pix and boleto cash-flow

    A bookkeeper reads accountBalance and pixKey, then records outbound Pix endToEndId plus boleto beneficiaryName so the digital account and the Visa plastic share one ledger.

  • Ágil offer origination

    A lending stack consumes principalAmount, installmentCount, monthlyRate and apr from the in-app Ágil quotes and compares them with the card's availableLimit before presenting a refinance.

Frequently asked questions

What card data does BrasilCard Cliente expose?

The illustrative API surface covers the Visa plastic (last4Digits, totalLimit, usedLimit, availableLimit, dueDay), the open fatura (invoiceAmount, minimumPayment, dueDate, linhaDigitavel), live purchases (merchantName, amount, installmentCount), the digital account (accountBalance, pixKey), Pix and boleto payments, card unlock, and Ágil loan quotes (principalAmount, installmentCount, apr).

How does the app authenticate cardholders?

Sign-in is CPF plus password and returns a Bearer accessToken for later calls. Fingerprint or face unlock on the device only opens the locally stored session; it does not replace the server login.

Can I pay the fatura from the digital account, not only via barcode?

Yes. The home flow still issues a FEBRABAN linhaDigitavel for internet banking, and the conta digital can settle the same invoiceId by Pix (method=PIX, endToEndId) or pay unrelated boletos from accountBalance.

Is this a public BrasilCard developer API?

No. The endpoints shown are illustrative first-party-style routes modeled on what the cardholder app does after login on its fatura, Pix, unlock and Ágil screens — not a documented partner API.

Apps similar to BrasilCard Cliente

  • Cartão Carrefour: Crédito e + — Banco CSF's cardholder app for the Cartão Carrefour store credit card tracks available and used limit, live purchases and the best shopping day, generates a barcode to pay the fatura, requests extra cards and offers a personal loan.
  • Credz — Credz (Credz S.A. Instituição de Pagamento / DMCARD SA) is a Brazilian store-card issuer whose app looks up limit, PIN and faturas, activates a virtual card and opens Club Credz merchant discounts and loyalty points.
  • Cartão Magalu — Itaú's Cartão Magalu app manages the Magazine Luiza and Luiza store credit cards with Magalu cashback, fatura pay and renegotiation, and temporary or recurring virtual cards for online shopping.
  • Nubank — Nubank's Android app is the São Paulo neobank's hub for a no-annual-fee international credit card, a free NuConta, 24/7 Pix, in-app loans and investments from R$1.
  • Digio — Digio is Bradesco's digital bank whose app combines an international credit card with contactless and virtual-card controls, a free digital account, Pix and investments that yield up to 105% of the CDI.
  • PicPay — PicPay is a Brazilian digital bank whose app combines a checking account, Pix, several PicPay credit cards, personal and payroll credit, a Cofrinho pot and in-app investments.
  • C6 Bank — C6 Bank's app opens a digital account in reais, dollars or euros, issues credit cards subject to analysis, and includes an international debit card plus brokerage for Brazilian and overseas assets.
  • Bradesco Cartões — Bradesco Cartões is Banco Bradesco's app for Bradesco and Bradescard credit cards, covering live limits and purchases, digital fatura and Pix or boleto payment, and instant block or contactless toggle.

Topics

  • brasilcard cliente api
  • brasilcard fatura
  • brasilcard pix
  • linha digitavel fatura
  • availableLimit brasilcard
  • agil emprestimo brasilcard
  • conta digital brasilcard
  • boleto brasilcard

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

Get a quote