# Cobranças Pix (/docs/pix-processamento/endpoints/pix-operations)



Cobranças Pix são o caminho de **entrada de dinheiro**. Você gera o QR, mostra ao cliente, e a PayZu te avisa quando ele pagar. Todos os endpoints abaixo trabalham com transações do tipo `DEPOSIT`.

<QuickLinks>
  <QuickLink href="/docs/pix-processamento/endpoints/pix-operations/post_pix" title="Criar cobrança" method="POST" path="/pix" />

  <QuickLink href="/docs/pix-processamento/endpoints/pix-operations/get_pix" title="Consultar cobrança" method="GET" path="/pix" />

  <QuickLink href="/docs/pix-processamento/endpoints/pix-operations/get_pix_qrcode" title="Imagem do QR" method="GET" path="/pix/qr-code/{id}" />

  <QuickLink href="/docs/pix-processamento/endpoints/pix-operations/get_proof" title="Comprovante" method="GET" path="/proof/{id}" />
</QuickLinks>

## Quando usar cada um [#quando-usar-cada-um]

| Pergunta                            | Endpoint                                                                                   |
| ----------------------------------- | ------------------------------------------------------------------------------------------ |
| Quero cobrar um cliente             | [`POST /pix`](/docs/pix-processamento/endpoints/pix-operations/post_pix)                   |
| Cliente pagou? Qual o status agora? | [`GET /pix`](/docs/pix-processamento/endpoints/pix-operations/get_pix)                     |
| Quero renderizar o QR como imagem   | [`GET /pix/qr-code/{id}`](/docs/pix-processamento/endpoints/pix-operations/get_pix_qrcode) |
| Cliente pediu o comprovante oficial | [`GET /proof/{id}`](/docs/pix-processamento/endpoints/pix-operations/get_proof)            |

<Callout type="info">
  Ao criar uma cobrança, a PayZu gera um QR Code **dinâmico** (com valor e ID por cobrança).
</Callout>

## Exemplos [#exemplos]

<Accordions type="single">
  <Accordion title="POST /pix, criar cobrança simples">
    ```bash
    curl -X POST https://api.payzu.processamento.com/v1/pix \
      -H "Authorization: Bearer $TOKEN" \
      -H "Content-Type: application/json" \
      -d '{
        "amount": 99.90,
        "clientReference": "order-1234",
        "callbackUrl": "https://seusite.com.br/webhooks/payzu"
      }'
    ```

    Resposta:

    ```json
    {
      "id": "PAYZU20251123104518DF75D20A8F",
      "status": "PENDING",
      "amount": 99.90,
      "clientReference": "order-1234",
      "qrCodeText": "00020126870014br.gov.bcb.pix...",
      "qrCodeUrl": "https://api.payzu.processamento.com/v1/pix/qr-code/PAYZU20251123104518DF75D20A8F"
    }
    ```
  </Accordion>

  <Accordion title="GET /pix, consultar por clientReference">
    ```bash
    curl "https://api.payzu.processamento.com/v1/pix?clientReference=order-1234" \
      -H "Authorization: Bearer $TOKEN" \
      -H "Content-Type: application/json"
    ```
  </Accordion>
</Accordions>

## Fluxo recomendado [#fluxo-recomendado]

<Mermaid
  chart="`
flowchart LR
  A[&#x22;POST /pix&#x22;] --> B[&#x22;Exibe QR&#x22;]
  B --> C[&#x22;Cliente paga&#x22;]
  C --> D[&#x22;Callback COMPLETED&#x22;]
  D --> E[&#x22;Marca pedido pago&#x22;]
  E --> F[&#x22;GET /proof opcional&#x22;]

  click A &#x22;/docs/pix-processamento/endpoints/pix-operations/post_pix&#x22; &#x22;POST /pix&#x22;
  click D &#x22;/docs/pix-processamento/webhooks&#x22; &#x22;Webhooks&#x22;
  click F &#x22;/docs/pix-processamento/endpoints/pix-operations/get_proof&#x22; &#x22;GET /proof&#x22;

  style A fill:#f59e0b,stroke:#d97706,color:#ffffff
  style D fill:#14ce71,stroke:#0eb464,color:#ffffff
`"
/>

## Tutoriais e boas práticas [#tutoriais-e-boas-práticas]

<QuickLinks>
  <QuickLink href="/docs/pix-processamento/tutoriais/receive-pix" title="Tutorial: Receber Pix" />

  <QuickLink href="/docs/pix-processamento/best-practices/idempotency" title="Idempotência" />

  <QuickLink href="/docs/pix-processamento/webhooks" title="Webhooks" />
</QuickLinks>