Decodificar QR Code PIX

Retorna as informações completas contidas em um QR Code PIX estático ou dinâmico, permitindo validar o destinatário antes do pagamento.

Este endpoint permite decodificar e interpretar um QR Code PIX informado no corpo da requisição.

Através do conteúdo EMV (emv), a API extrai e retorna os dados do recebedor, incluindo:

• Nome e documento do beneficiário;

• Banco e código ISPB;

• Tipo do QR Code (STATIC ou DYNAMIC);

• Identificador da chave (key);

• Identificador da transação (txId);

• Valor associado, se houver.

Esse endpoint é a primeira etapa do fluxo de pagamento via QR Code, e seu resultado deve ser usado posteriormente.

O campo type indica se o QR Code é:

• STATIC: pode ser reutilizado;

• DYNAMIC: valor único, válido apenas para uma transação.

Endpoint para Decodificar QR Code Pix

POST /accounts/{accountId}/pix/qrcode/decode

Este endpoint é protegido e requer o uso do cabeçalho Authorization: Bearer <token> e x-tenant-id.

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>
x-tenant-id	Tenant ID

Body

Name	Type	Description
emv	string	QrCode Copy Paste

Response

200

{
  "qrCode": {
    "id": "d82b3a6f-119b-4f72-9d25-8c61b3fda22e",
    "type": "DYNAMIC",
    "txId": "TXB4F7L2G9R6MZQ8P",
    "key": "b27a4c90-63e4-4c8e-bf8d-41e9f56f8a23",
    "ispb": "12345678",
    "document": "***.987.654-**",
    "name": "Juliana Santos Almeida",
    "bankName": "Banco Stric Digital",
    "bankCode": "777",
    "endToEndId": "E202510101130STRIC4D5E6F7G8H9I0J1K2",
    "amount": 85.90
  }
}

400

{
    "code": "BAD_REQUEST",
    "error": "Erro",
    "message": "Erro"
}