Aparência
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 PAULOquando 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 empix.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(semvalue,metadata={"type": "static", "key_pix": "..."},txid= número da conta);pix_idé o id desse registro.accounts.qrcodefoi 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 }| Campo | Tipo | Obrigatório | Regras |
|---|---|---|---|
amount | number | Sim | mí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.