API v1 documentationPTEN
API v2

API v2

Integrate Pix, balance, statement, charges and notices into your system with one token and a few calls.

Base serverhttps://bank.granseuk.com/api/v2
ACCOUNTS API

Accounts API

Check the balance and statement, send Pix by key, follow each payment through to confirmation, get the receipt, transfer between accounts of the bank.

Open documentation →QR CODE API

QR Code API

Create Pix charges with a dynamic QR code (txid), show the pixCopiaECola to the payer, confirm the payment and receive the money in the account.

Open documentation →HELP CENTER

Help Center

Authentication, permissions, idempotency, errors, migrating from another provider and AI integration.

Open documentation →

Active at this bank

  • Send Pix to a key
  • Receive Pix by charge (dynamic QR with txid)
  • Receive Pix straight into the account keys
  • Balance, statement and PDF receipt
  • Transfer between accounts of the bank

Overview

Base URL: https://bank.granseuk.com/api/v2

Active at this bank:

  • Send Pix to a key
  • Receive Pix by charge (dynamic QR with txid)
  • Receive Pix straight into the account keys
  • Balance, statement and PDF receipt
  • Transfer between accounts of the bank

API v2 brings together what you need to integrate Pix, balance, statement, charges and notices into your system, shaped like the most widely used Pix APIs: one token, short paths and predictable responses. If you already integrate with another Pix provider, you usually just change the base URL and credentials. The money rules are the same as the v1 API: balance, fees, limits, idempotency, client certificate (mTLS) and any function your bank turned off.

  • Amounts in BRL, as a number (25.5) in payments, balance and statement; as a string ("49.90") in charges, like the BACEN standard.
  • Dates in ISO 8601 (UTC).
  • Payment states: PROCESSING, LIQUIDATED, CANCELED, REFUNDED, WAITING_APPROVAL.
  • Charge states: ATIVA, CONCLUIDA, REMOVIDA_PELO_USUARIO_RECEBEDOR, REMOVIDA_PELO_PSP.
  • The v1 API (at /docs) is unchanged and works alongside.

Start in 3 steps

  • In the bank panel, open API, tap New key, choose Production and use the "Full integration (receive and send Pix)" shortcut (it ticks balance, statement, lookups, charge by Pix, send Pix and transfer). On creation the panel shows the Client ID, the Client Secret (the key, shown once: store it) and the base URL.
  • Exchange the credentials for a token: POST /oauth/token (clientId = first 14 characters of the key, clientSecret = the key).
  • Call the routes with Authorization: Bearer <accessToken>. On every payment, send x-idempotency-key.