# Receber PIX

Do primeiro pedido à confirmação do pagamento.

## 1. Prepare sua conta

Entre na VibeCash, ative dois fatores e crie uma chave com as permissões de cobrança, consulta e webhook. [Criar chave de API](/docs/pages/guides/authentication).

## 2. Crie a cobrança

```
curl --request POST \
  --url 'https://seu-dominio/v1/payment-pix/create' \
  --header 'X-API-Key: tp_live_SUA_CHAVE' \
  --header 'Idempotency-Key: operacao-unica-123' \
  --header 'Content-Type: application/json' \
  --data '{"amount":5,"description":"Pedido 123","coverFee":false,"externalReference":"pedido-123"}'
```

## 3. Exiba o PIX

Mostre o QR retornado em `qrCodeBase64` ou o conteúdo de `copyPaste`. Guarde o ID e a sua referência externa para acompanhar o pedido.

## 4. Confirme o pagamento

Receba `payment.paid` por webhook ou consulte a cobrança até `COMPLETED`. Uma criação bem-sucedida não significa que o cliente pagou.
