Skip to content

Banking — QR Code estático e dinâmico ​

Códigos Pix para a conta receber: o estático (sem valor, reutilizável) e, desde 14/10/2026, o dinâmico (com valor, uso único), sem precisar criar uma cobrança. Cobranças Pix (com cliente, vencimento etc.) continuam em Cobranças Pix e boleto. As antigas rotas /banking/pix/charges respondem 404. Autenticação e headers: Banking — visão geral.

Autenticação na Fidúcia: o QR estático e o copia e cola dinâmico das cobranças chamam a API de Contas com o login da própria conta (POST /login). Ver Fidúcia — autenticação por endpoint.


GET /banking/pix/static-qrcode ​

Devolve o copia e cola estático da conta: um código fixo e reutilizável, sem valor (quem paga escolhe quanto), para a chave Pix cadastrada na conta (accounts.key_pix). Essa chave é uma chave aleatória cadastrada automaticamente na primeira chamada a GET /access/account em que key_pix estiver vazia (na Fidúcia, só se a senha transacional já estiver configurada em credentials.fiducia_transactional_password).

json
{ "code": 200, "success": true, "data": { "payload": "00020126...", "pix_id": 123 } }
  • O recebedor que aparece para o pagador é o nome da conta (até 25 caracteres, sem acentos, em maiúsculas), e a cidade vem do endereço da conta (SAO PAULO quando não houver).
  • Fidúcia: o código é gerado pela própria Fidúcia (POST /pix/qrcode/estatico/gerar); o retorno completo da Fidúcia fica em pix.json.
  • Demais bancos: o código é montado a partir dos dados atuais da conta.
  • Mesmo fluxo do Pix dinâmico: cada chamada gera um código novo e o cadastra como um novo registro na tabela pix (sem value, metadata = {"type": "static", "key_pix": "..."}, txid = número da conta); pix_id é o id desse registro. accounts.qrcode foi removida.
  • Conta sem chave Pix: 422 A conta não tem chave Pix cadastrada para gerar o código estático.

POST /banking/pix/qrcode/dynamic ​

Gera um Pix dinâmico (com valor, uso único) para a conta receber, sem criar cobrança — é o que a tela "Receber Pix" do portal usa. Emite no banco da conta (Fidúcia: QR Code dinâmico imediato; Teste: BR Code local com a chave da conta) e grava em pixes com status pendente (0). Aceita o header Idempotency-Key (ver Idempotência).

Body:

json
{ "amount": 42.50 }
CampoTipoObrigatórioRegras
amountnumberSimmín. 0.01 e mín. min_pix_in da conta

Response 201:

json
{
    "code": 201,
    "success": true,
    "message": "Pix gerado com sucesso.",
    "data": {
        "id": 15,
        "txid": "9F2C...",
        "value": 42.5,
        "qrcode": "00020101021226...6304ABCD",
        "status": 0,
        "created_at": "2026-10-14T20:10:00.000000Z"
    }
}

422 se amount faltar ou estiver abaixo do mínimo.