Crie cobranças via Pix

Crie cobranças com billingType igual a PIX e disponibilize o QR Code dinâmico para pagamento.

📘
Ao concluir este guia, você saberá criar uma cobrança via Pix e recuperar o QR Code e o código copia e cola.

1. Crie a cobrança

Envie a cobrança com a forma de pagamento PIX.

POST /v3/lean/payments

{
  "customer": "cus_000005219613",
  "billingType": "PIX",
  "value": 100.90,
  "dueDate": "2023-07-21"
}

Consulte o endpoint: Criar nova cobrança com dados resumidos na resposta.

Recomendamos manter uma chave Pix cadastrada na conta.

2. Obtenha o QR Code

Após criar a cobrança, envie o ID retornado para recuperar os dados do QR Code.

GET /v3/payments/id/pixQrCode

Consulte o endpoint: Obter QR Code para pagamentos via Pix.

A resposta disponibiliza:

Campo	Descrição
`encodedImage`	Imagem do QR Code em Base64
`payload`	Código Pix copia e cola
`expirationDate`	Data de expiração do QR Code

📘
O QR Code é dinâmico, possui vencimento e pode ser pago uma única vez.
Ele expira 12 meses após a data de vencimento da cobrança e pode ser impresso ou incluído em documentos, como boletos e carnês.

🚧
Cobranças sem chave Pix cadastrada
Atualmente, é possível gerar um QR Code Pix dinâmico de pagamento imediato sem uma chave Pix cadastrada no Asaas. Nesse caso, o QR Code é vinculado a uma instituição parceira e pode ser pago até 23:59 do mesmo dia.
Se a cobrança for atualizada, obtenha um novo QR Code.
Essa funcionalidade será descontinuada futuramente, com comunicação 30 dias antes. Por isso, recomendamos cadastrar uma chave Pix.

Cobranças via Pix / QR Code dinâmico

Crie cobranças via Pix

1. Crie a cobrança

2. Obtenha o QR Code

Cobranças sem chave Pix cadastrada

Próximos passos