Obter QR Code para pagamentos via Pix

Endpoint responsável por recuperar o QR Code Pix de uma cobrança específica.

Essa chamada retorna o QR Code em imagem Base64, o payload do Pix Copia e Cola e a data de validade correspondente ao QR Code gerado para a cobrança.


Cobranças compatíveis

O QR Code Pix pode ser recuperado para cobranças com:

  • PIX
  • BOLETO
  • UNDEFINED

Nesses cenários, o Pix fica habilitado como meio de pagamento da cobrança.


Características do QR Code retornado

O QR Code gerado por esse endpoint possui as seguintes características:

  • é dinâmico
  • possui vencimento
  • pode ser pago uma única vez
  • pode ser impresso ou exibido em documentos
  • expira em até 12 meses após a data de vencimento, quando vinculado ao fluxo regular com chave Pix

Chave Pix e comportamento transitório

Atualmente, ainda é possível obter QR Code Pix dinâmico de pagamento imediato mesmo sem possuir chave Pix cadastrada no Asaas.

Nesse cenário, o QR Code fica vinculado a uma instituição parceira e pode ser pago até 23:59 do mesmo dia. A cada atualização da cobrança, será necessário obter um novo QR Code.

Como essa possibilidade será descontinuada futuramente, a recomendação é que a conta possua chave Pix cadastrada no Asaas para manter o fluxo estável e aderente ao comportamento definitivo da plataforma.


Parâmetro da requisição

  • id — Identificador único da cobrança no Asaas

🚧

Atenção

Chamadas GET devem ser enviadas com body vazio.

Caso contrário, a API poderá retornar erro 403 Forbidden.

Path Params
string
required
Responses

403

Forbidden. Ocorre quando o body da requisição está preenchido, chamadas de método GET precisam ter um body vazio.

404

Not found

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json