Skip to main content
POST
/
v4
/
i
/
baas
/
pix
/
decode-qr
curl -X POST https://api.owem.com.br/v4/i/baas/pix/decode-qr \
  -H "Authorization: Basic $(echo -n 'SUA_API_KEY:SEU_SECRET' | base64)" \
  -H "Content-Type: application/json" \
  -d '{
    "accountId": "123456789012",
    "brCode": "00020126880014br.gov.bcb.pix2566qrcode.ip-digital/v2/qr/cob/f4fb168c-3fbf-46e0-ae57-23ecbe50548d5204000053039865802BR5925CONSULTORIA E INVESTIMENTO6009SAO PAULO62070503***6304BAEF"
  }'

{
  "requestId": "d584f1g9-3h08-779g-1hgd-76i128ge1dh7",
  "success": true,
  "size": 1,
  "data": {
    "valid": true,
    "type": "dynamic",
    "merchantName": "CONSULTORIA E INVESTIMENTOS",
    "merchantCity": "SAO PAULO",
    "txid": "***",
    "oneTime": true
  }
}

curl -X POST https://api.owem.com.br/v4/i/baas/pix/decode-qr \
  -H "Authorization: Basic $(echo -n 'SUA_API_KEY:SEU_SECRET' | base64)" \
  -H "Content-Type: application/json" \
  -d '{
    "accountId": "123456789012",
    "brCode": "00020126880014br.gov.bcb.pix2566qrcode.ip-digital/v2/qr/cob/f4fb168c-3fbf-46e0-ae57-23ecbe50548d5204000053039865802BR5925CONSULTORIA E INVESTIMENTO6009SAO PAULO62070503***6304BAEF"
  }'

​
Descrição

Decodifica um QR Code PIX (EMV-TLV) para extrair as informações do pagamento. Faz apenas parse local, não consulta o DICT.
PROGRAMA BETA - Este endpoint está disponível apenas para parceiros aprovados no programa BAAS.
Este endpoint faz apenas o parse local do código EMV-TLV. Ele não consulta o DICT (Diretório de Identificadores de Contas Transacionais), portanto não valida se a chave PIX existe ou está ativa.

​
Autenticação

Este endpoint usa Basic Auth com sua API Key + Secret. O scope baas:pix é configurado pela Owem na sua API Key.
Authorization: Basic {Base64(API_KEY:API_SECRET)}

​
Request

​
Headers

HeaderTipoObrigatórioDescrição
Authorizationstring✅Basic Auth (API Key + Secret em Base64)
Content-Typestring✅application/json

​
Body

{
  "accountId": "123456789012",
  "brCode": "00020126880014br.gov.bcb.pix..."
}
CampoTipoObrigatórioDescrição
accountIdstring✅ID da conta que fará o pagamento
brCodestring✅Código EMV-TLV do QR Code (copia e cola)

​
Response

​
Sucesso (200 OK)

{
  "requestId": "d584f1g9-3h08-779g-1hgd-76i128ge1dh7",
  "success": true,
  "size": 1,
  "data": {
    "valid": true,
    "type": "dynamic",
    "merchantName": "CONSULTORIA E INVESTIMENTOS",
    "merchantCity": "SAO PAULO",
    "txid": "***",
    "oneTime": true
  }
}

​
Campos da Response

CampoTipoDescrição
validbooleanSe o QR Code é válido
typestringTipo: static ou dynamic
merchantNamestringNome do beneficiário
merchantCitystringCidade do beneficiário
amountnumberValor do PIX (null se não definido)
pixKeystringChave PIX (apenas QR estático)
urlstringURL do payload (QR dinâmico)
txidstringID da transação (se disponível)

​
Tipos de QR Code

TipoDescrição
staticQR Code estático - chave PIX fixa, valor pode variar
dynamicQR Code dinâmico - gerado por cobrança, valor definido

​
Erros

CódigoDescrição
400QR Code inválido ou mal formatado
403Conta não pertence a este parceiro
404Conta não encontrada
Use este endpoint para validar o QR Code antes de efetuar o pagamento. Exiba as informações ao cliente para confirmação.
QR Codes dinâmicos possuem validade limitada. Após o vencimento, o pagamento será recusado mesmo que o decode seja bem-sucedido.
{
  "requestId": "d584f1g9-3h08-779g-1hgd-76i128ge1dh7",
  "success": true,
  "size": 1,
  "data": {
    "valid": true,
    "type": "dynamic",
    "merchantName": "CONSULTORIA E INVESTIMENTOS",
    "merchantCity": "SAO PAULO",
    "txid": "***",
    "oneTime": true
  }
}