> ## Documentation Index > Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt > Use this file to discover all available pages before exploring further. # Cobrar com um QR code dinâmico > Crie uma cobrança Pix com um QR code dinâmico e receba o pagamento em uma conta do Midaz, com o Pix Lerian e o Lerian SPI. Crie uma cobrança Pix com um QR code dinâmico e saiba quando o pagador a paga. > [!NOTE] > > Este fluxo é uma leitura sugerida dos manuais do BACEN para o Pix. Os manuais prevalecem sobre esta página. Sua instituição, como participante, valida o fluxo e o implementa sobre as APIs da Lerian. Veja [como ler os diagramas](https://docs.lerian.studio/pt/diagrams/introduction.md). ## Participantes *** * **Sua instituição.** O participante do Pix do recebedor. Chama a API do Pix Lerian, mostra o QR code e recebe os eventos. * **Pix Lerian.** Cria a cobrança e acompanha o status dela. Credita o pagamento no Midaz. * **Midaz.** O ledger que guarda a conta que recebe o pagamento. * **Lerian SPI.** Registra a cobrança, a serve para a instituição do pagador e troca as mensagens do Pix com o SPI. * **SPI.** O sistema de pagamentos instantâneos do BACEN. Liquida o pagamento. * **Instituição do pagador.** O participante do Pix do pagador. Lê a cobrança e envia o pagamento. ## Antes de começar *** * A conta que recebe o pagamento tem uma chave Pix ativa que sua instituição registrou no Pix Lerian. * Seus sistemas recebem os eventos do Pix Lerian. Veja [Eventos do Pix Lerian](https://docs.lerian.studio/pt/interfaces/pix-lerian/pix-lerian-events.md). ## Diagrama *** ![Cobrar com um QR code dinâmico](https://mintcdn.com/lerian-49cb71fc/AR-wpjGp5R6xEqsz/images/pt/d2/id-charge-with-a-dynamic-qr-code.svg?fit=max\&auto=format\&n=AR-wpjGp5R6xEqsz\&q=85\&s=a143f452078b5f7cfe1ebb83f3e99224) ## Passo a passo *** | # | Origem | Destino | Mensagem | API da Lerian | O que acontece | | - | - | - | - | - | - | | 1 | Sua instituição | Pix Lerian | API da Lerian | [`POST /collections/immediate`](https://docs.lerian.studio/pt/reference/interfaces/pix-lerian/cob/create-immediate-collection) | Crie a cobrança com o seu `txId`, a chave Pix, o valor e a expiração. Envie o cabeçalho `X-Idempotency`. | | 2 | Pix Lerian | Pix Lerian | Passo interno | | O Pix Lerian verifica se a chave Pix está ativa. | | 3 | Pix Lerian | Lerian SPI | Chamada interna | | O Pix Lerian registra a cobrança no Lerian SPI. | | 4 | Pix Lerian | Sua instituição | API da Lerian | Resposta ao passo 1 | O Pix Lerian responde `201` com a cobrança em `ACTIVE`, o conteúdo do QR code em `emvPayload` e a localização dele. | | 5 | Sua instituição | Sua instituição | Passo interno | | Mostre o QR code ao pagador. | | 6 | Instituição do pagador | Lerian SPI | HTTPS | | A instituição do pagador lê a cobrança na localização dela. O Lerian SPI responde com a cobrança assinada. | | 7 | Instituição do pagador | SPI | `pacs.008` | | A instituição do pagador envia o pagamento. | | 8 | SPI | Lerian SPI | `pacs.008` | | O pagamento chega à sua instituição. | | 9 | Lerian SPI | Pix Lerian | Chamada interna | | O Lerian SPI repassa o Pix que chegou ao Pix Lerian. O Pix Lerian aceita o Pix, e o SPI o liquida, como em [Receber um Pix](https://docs.lerian.studio/pt/diagrams/native-rails/send-and-receive-pix.md). | | 10 | Pix Lerian | Midaz | Chamada interna | | Depois da liquidação, o Pix Lerian credita a conta. | | 11 | Lerian SPI | Lerian SPI | Passo interno | | Depois da liquidação, o Lerian SPI marca a cobrança como paga. | | 12 | Lerian SPI | Pix Lerian | Chamada interna | | O Lerian SPI repassa a cobrança paga ao Pix Lerian. | | 13 | Pix Lerian | Sua instituição | API da Lerian | Evento `collection.paid` | A cobrança fica `COMPLETED`. | ## Regras *** * Uma cobrança não cria nenhuma transação no Midaz. O dinheiro chega como um Pix recebido, com o próprio evento `inbound_transfer.completed`. * Uma nova cobrança precisa de uma nova chave `X-Idempotency` e de um novo `txId`. * Uma cobrança com vencimento segue os mesmos passos. Crie-a com [`POST /collections/duedate`](https://docs.lerian.studio/pt/reference/interfaces/pix-lerian/cob/create-due-date-collection). O evento `collection.paid` dela tem `type` `DUE_DATE`. * Para encerrar uma cobrança imediata não paga, cancele-a com [`DELETE /collections/immediate/{id}`](https://docs.lerian.studio/pt/reference/interfaces/pix-lerian/cob/cancel-immediate-collection). A cobrança fica `CANCELLED`. ## Como saber que terminou *** O Pix Lerian publica `collection.paid`, e [`GET /collections/immediate/{id}`](https://docs.lerian.studio/pt/reference/interfaces/pix-lerian/cob/get-immediate-collection) mostra a cobrança em `COMPLETED`. ## O que pode dar errado *** | Situação | O que você vê | O que fazer | | - | - | - | | A chave Pix é desconhecida ou não está ativa. | O Pix Lerian recusa a cobrança. | Use uma chave Pix ativa da conta que recebe. | | A resposta ao pedido não chega. | Nenhuma resposta, ou um timeout. | Envie o mesmo pedido de novo com a mesma chave `X-Idempotency`. | A [lista de erros do Pix Lerian](https://docs.lerian.studio/pt/reference/interfaces/pix-lerian/pix-lerian-error-list.md) descreve cada código. ## Relacionados *** * [Enviar e receber Pix](https://docs.lerian.studio/pt/diagrams/native-rails/send-and-receive-pix.md) * [Usar o COB com o Pix Lerian](https://docs.lerian.studio/pt/interfaces/pix-lerian/pix-lerian-cob.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.