Guias

Receber com QR Code estático

O QR estático é ideal para pontos de venda, doações e cobranças recorrentes com o mesmo valor. Um único código pode ser pago várias vezes.

Referência de conta e headers

Toda request sobre uma conta identifica a conta por header: envie account-id (o accountId recebido no onboarding), wallet-id ou tax-identifier — precedência wallet-id > tax-identifier > account-id. Some a isso Authorization e tenantid; em DEV, também hostdevelop: apiapp.dev.ideabank.com.br. Sem nenhum header de conta a API responde 422 (account, wallet or tax-identifier header is required); se a integração não estiver vinculada à conta, 403.

POST/integration/v1/pix/static

Campos

Campo	Tipo	Descrição
accountId*	uuid	Conta beneficiária.
key	string	Chave Pix (opcional se a conta tiver chave default).
amount	number	Valor fixo. Omita para permitir valor livre.
description	string	Descrição exibida ao pagador.
metadata	object	Metadados livres devolvidos em consultas.

curl -X POST https://apiapp.dev.ideabank.com.br/integration/v1/pix/static \
  -H "Authorization: Bearer $TOKEN" \
  -H "tenantid: $TENANT_ID" -H "account-id: $ACCOUNT_ID" -H "hostdevelop: apiapp.dev.ideabank.com.br" -H "Content-Type: application/json" \
  -d '{
    "accountId": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
    "key": "+5511999999999",
    "amount": 79.9,
    "description": "Recebimento de venda no PDV 12"
  }'

Estático vs. dinâmico

Use QR estático para recebimentos genéricos e recorrentes. Para checkout com valor, vencimento e conciliação por pedido, prefira a cobrança dinâmica (COB).