# Checkout PIX ponta a ponta

Conecte criação, apresentação do PIX e confirmação do pedido.

## Crie a cobrança

Monte o body conforme a [referência de checkout](https://www.grandepay.com.br/docs/api-reference/checkout) e envie `POST /v1/checkout`. Sucesso devolve 200 com `uuid` e `status` 0.

> **Sem idempotência na criação.**
>
> A rota pública de checkout não oferece chave idempotente. Um retry após timeout pode criar uma segunda cobrança.

## Exiba o PIX

Mostre `pix_code` como copia e cola, sem espaços ou quebras.

`pix_expiration` só existe se o provedor enviar.

## Confirme o pagamento

O evento `transaction.paid` confirma o pagamento. Valide e persista conforme [Recebendo postbacks](https://www.grandepay.com.br/docs/guides/receiving-postbacks).

## Falhas

Erros de criação estão em [Erros](https://www.grandepay.com.br/docs/api-reference/errors).