Documentação da API v1PTEN
API v2

API v2

Integre Pix, saldo, extrato, cobranças e avisos no seu sistema com um token e poucas chamadas.

Servidor basehttps://bank.granseuk.com/api/v2
API CONTAS

API Contas

Consulte o saldo e o extrato, envie Pix por chave, acompanhe cada pagamento até a confirmação, tire o comprovante, transfira entre contas do banco.

Abrir documentação →API QRCODE

API QRCode

Crie cobranças Pix com QR Code dinâmico (txid), mostre o pixCopiaECola ao pagador, confirme o pagamento e receba o dinheiro na conta.

Abrir documentação →CENTRAL DE AJUDA

Central de Ajuda

Autenticação e permissões, idempotência, erros, migração de outra provedora e integração com IA.

Abrir documentação →

Ativo neste banco

  • Enviar Pix para uma chave
  • Receber Pix por cobrança (QR dinâmico com txid)
  • Receber Pix direto nas chaves da conta
  • Saldo, extrato e comprovante em PDF
  • Transferência entre contas do banco

Visão geral

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

Ativo neste banco:

  • Enviar Pix para uma chave
  • Receber Pix por cobrança (QR dinâmico com txid)
  • Receber Pix direto nas chaves da conta
  • Saldo, extrato e comprovante em PDF
  • Transferência entre contas do banco

A API v2 reúne o que você precisa para integrar Pix, saldo, extrato, cobranças e avisos no seu sistema, com o desenho das APIs de Pix mais usadas no mercado: um token, caminhos curtos e respostas previsíveis. Se você já integra com outra provedora de Pix, em geral basta trocar a URL base e as credenciais. As regras de dinheiro são as mesmas da API v1: saldo, tarifas, limites, idempotência, certificado de cliente (mTLS) e as funções que o seu banco desligou.

  • Valores em reais, como número (25.5) nos pagamentos, saldo e extrato; como texto ("49.90") nas cobranças, como no padrão BACEN.
  • Datas em ISO 8601 (UTC).
  • Estados de pagamento: PROCESSING, LIQUIDATED, CANCELED, REFUNDED, WAITING_APPROVAL.
  • Estados de cobrança: ATIVA, CONCLUIDA, REMOVIDA_PELO_USUARIO_RECEBEDOR, REMOVIDA_PELO_PSP.
  • A API v1 (em /docs) continua igual e funciona ao mesmo tempo.

Comece em 3 passos

  • No painel do banco, abra API e crie uma chave de produção. Marque as permissões: balance:read, transactions:read, pix:read, pix:write e pix:send. Guarde a chave: ela aparece uma vez.
  • Troque as credenciais por um token: POST /oauth/token (clientId = 14 primeiros caracteres da chave, clientSecret = a chave).
  • Chame as rotas com Authorization: Bearer <accessToken>. Em todo pagamento, mande x-idempotency-key.