PayZu PixDICT (Diretório de Identificadores de Contas Transacionais)

Consultar os dados de um QR Code

POST/pix/qrcode/read

Confira o passo a passo → https://docs.payzu.com.br/docs/pix/read-a-qr-code


Body Params

emvstringobrigatório
Código copia e cola do QR Code (EMV).

Headers

Authorizationstringobrigatório
Bearer seguido do token de API.
acceptstring
Formato da resposta.

Responses

200QR Code lido
qrCodeTypestringTipo do QR Code.
STATICDYNAMIC
namestring | nullNome do recebedor.
documentstring | nullCPF ou CNPJ do recebedor.
amountnumber | nullValor a pagar.
originalAmountnumber | nullValor embutido no QR Code.
txidstring | nullIdentificador (txid) do QR Code.
additionalInfostring | nullInformação adicional do QR Code.
expiresInnumber | nullSegundos até expirar (0 nos QR Codes estáticos).
createdAtstring | nullData de criação (só em QR Codes dinâmicos).
amountEditableboolean | nullIndica se o pagador pode alterar o valor.
dueDatestring | nullData de vencimento.
400Requisição inválida
statusstringSempre ERROR.
errorstringNome do status HTTP.
errorCodestringCódigo do erro, como PZV001.
messagestringMotivo em texto, para exibir ou registrar.
statusCodeintegerO mesmo status HTTP da resposta.
requestIdstringInforme este id ao suporte para localizar a chamada.
detailsarray of objectsErros de validação por campo.
Campos de cada item 2
fieldstringCampo rejeitado.
messagestringMotivo da rejeição.
401Token ausente ou inválido
statusstringSempre ERROR.
errorstringNome do status HTTP.
errorCodestringCódigo do erro, como PZV001.
messagestringMotivo em texto, para exibir ou registrar.
statusCodeintegerO mesmo status HTTP da resposta.
requestIdstringInforme este id ao suporte para localizar a chamada.
403Acesso negado
statusstringSempre ERROR.
errorstringNome do status HTTP.
errorCodestringCódigo do erro, como PZV001.
messagestringMotivo em texto, para exibir ou registrar.
statusCodeintegerO mesmo status HTTP da resposta.
requestIdstringInforme este id ao suporte para localizar a chamada.
410QR Code vencido ou removido
statusstringSempre ERROR.
errorstringNome do status HTTP.
errorCodestringCódigo do erro, como PZV001.
messagestringMotivo em texto, para exibir ou registrar.
statusCodeintegerO mesmo status HTTP da resposta.
requestIdstringInforme este id ao suporte para localizar a chamada.
424Falha na instituição financeira
statusstringSempre ERROR.
errorstringNome do status HTTP.
errorCodestringCódigo do erro, como PZV001.
messagestringMotivo em texto, para exibir ou registrar.
statusCodeintegerO mesmo status HTTP da resposta.
requestIdstringInforme este id ao suporte para localizar a chamada.
429Limite de requisições atingido
statusstringSempre ERROR.
errorstringNome do status HTTP.
errorCodestringCódigo do erro, como PZV001.
messagestringMotivo em texto, para exibir ou registrar.
statusCodeintegerO mesmo status HTTP da resposta.
requestIdstringInforme este id ao suporte para localizar a chamada.
retryAfterSecondsintegerSegundos de espera antes de tentar de novo.
500Erro interno
statusstringSempre ERROR.
errorstringNome do status HTTP.
errorCodestringCódigo do erro, como PZV001.
messagestringMotivo em texto, para exibir ou registrar.
statusCodeintegerO mesmo status HTTP da resposta.
requestIdstringInforme este id ao suporte para localizar a chamada.

Linguagem

Credenciais Bearer

Token de API

Gerar credencial de sandbox

curl --request POST \     --url https://pix.sandbox.payzu.dev/v1/pix/qrcode/read \     --header 'authorization: Bearer SEU_TOKEN' \     --header 'accept: application/json' \     --header 'content-type: application/json' \     --data '{}'
Resposta

Clique em Try It! para enviar uma requisição e ver a resposta aqui. Ou escolha um exemplo:

application/json