Skip to main content
POST
/
v4
/
i
/
baas
/
pix
/
pay-qrcode
curl -X POST https://api.owem.com.br/v4/i/baas/pix/pay-qrcode \
  -H "Authorization: Basic $(echo -n 'SUA_API_KEY:SEU_SECRET' | base64)" \
  -H "Content-Type: application/json" \
  -d '{
    "accountId": "123456789012",
    "brCode": "00020126880014br.gov.bcb.pix2566qrcodes.saq.digital/v2/qr/cob/f4fb168c-3fbf-46e0-ae57-23ecbe50548d5204000053039865802BR5925TMS CONSULTORIA E INVESTI6009SAO PAULO62070503***6304BAEF",
    "amount": 100.10,
    "externalId": "9cdd03c1-56b5-40d3-9f44-2250810e8fab"
  }'

{
  "requestId": "g817i4j2-6k31-001j-4kjg-09l451jh4gk0",
  "success": true,
  "size": 1,
  "data": {
    "success": true,
    "status": "processing",
    "endToEndId": "E5470000120260113123456789012345",
    "amount": 100.1,
    "externalId": "9cdd03c1-56b5-40d3-9f44-2250810e8fab",
    "createdAt": 1768265000000
  }
}

curl -X POST https://api.owem.com.br/v4/i/baas/pix/pay-qrcode \
  -H "Authorization: Basic $(echo -n 'SUA_API_KEY:SEU_SECRET' | base64)" \
  -H "Content-Type: application/json" \
  -d '{
    "accountId": "123456789012",
    "brCode": "00020126880014br.gov.bcb.pix2566qrcodes.saq.digital/v2/qr/cob/f4fb168c-3fbf-46e0-ae57-23ecbe50548d5204000053039865802BR5925TMS CONSULTORIA E INVESTI6009SAO PAULO62070503***6304BAEF",
    "amount": 100.10,
    "externalId": "9cdd03c1-56b5-40d3-9f44-2250810e8fab"
  }'

​
Descrição

Efetua um pagamento PIX usando um QR Code (EMV-TLV). O pagamento é processado de forma assíncrona.
PROGRAMA BETA - Este endpoint está disponível apenas para parceiros aprovados no programa BAAS.

​
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...",
  "amount": 100.1,
  "externalId": "9cdd03c1-56b5-40d3-9f44-2250810e8fab"
}
CampoTipoObrigatórioDescrição
accountIdstring✅ID da conta que fará o pagamento
brCodestring✅Código EMV-TLV do QR Code
amountnumber⚠️Valor do pagamento (obrigatório se QR estático)
externalIdstring✅ID externo para rastreamento (UUID)
Sobre o campo amount: - QR Dinâmico: O valor já está embutido no QR Code. Se você enviar amount, ele será ignorado e o valor do QR será usado. - QR Estático: O QR não contém valor. O campo amount é obrigatório.

​
Response

​
Sucesso (200 OK)

{
  "requestId": "g817i4j2-6k31-001j-4kjg-09l451jh4gk0",
  "success": true,
  "size": 1,
  "data": {
    "success": true,
    "status": "processing",
    "endToEndId": "E5470000120260113123456789012345",
    "amount": 100.1,
    "externalId": "9cdd03c1-56b5-40d3-9f44-2250810e8fab",
    "createdAt": 1768265000000
  }
}

​
Campos da Response

CampoTipoDescrição
successbooleanSe a requisição foi aceita
statusstringStatus inicial: processing
endToEndIdstringID E2E do PIX (use para consultar status)
amountnumberValor do pagamento
externalIdstringID externo informado (se enviado)
createdAtnumberTimestamp de criação (ms)

​
Status do Pagamento

StatusDescrição
processingPagamento em processamento
succeededPagamento concluído com sucesso
failedPagamento falhou
O pagamento é assíncrono. Use o endpoint Consultar Pagamento com o endToEndId para verificar o status final.

​
Erros

CódigoDescrição
400QR Code inválido
400Valor obrigatório para QR estático
400Saldo insuficiente
403Conta não pertence a este parceiro
404Conta não encontrada

​
Fluxo do Pagamento

Recomendamos usar webhooks para receber notificações de pagamentos concluídos ou falhos, em vez de fazer polling no endpoint de consulta.
{
  "requestId": "g817i4j2-6k31-001j-4kjg-09l451jh4gk0",
  "success": true,
  "size": 1,
  "data": {
    "success": true,
    "status": "processing",
    "endToEndId": "E5470000120260113123456789012345",
    "amount": 100.1,
    "externalId": "9cdd03c1-56b5-40d3-9f44-2250810e8fab",
    "createdAt": 1768265000000
  }
}