Pix Cobrança Pix

Como criar uma cobrança Pix e acompanhar o pagamento.

1. Crie a cobrança

curl -X POST https://api.paygrid.io/v1/transactions \
  -H "X-Api-Key: sk_sua_chave" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: pedido-4211" \
  -d '{
    "amount": 1990,
    "currency": "BRL",
    "method": "pix",
    "reference": "pedido-4211",
    "customer": {
      "name": "João da Silva",
      "document": "12345678900",
      "phone": "+5511999999999"
    }
  }'

Pix é sempre 1x — sem parcelamento. E o pagador precisa ter nome, documento e telefone; sem isso o provedor recusa.

2. Resposta

{
  "transactionId": "tx_01H...",
  "status": "pending",
  "reference": "pedido-4211",
  "qrCode": "00020126580014br.gov.bcb.pix...",
  "qrCodeUrl": "https://api.paygrid.io/v1/.../qr.png",
  "amount": "1990",
  "currency": "BRL",
  "method": "pix"
}

Exiba o qrCode (copia-e-cola) ou o qrCodeUrl (imagem) para o pagador.

3. Acompanhe o status

Consulte a qualquer momento:

curl https://api.paygrid.io/v1/transactions/{transactionId} \
  -H "X-Api-Key: sk_sua_chave"

O status muda para approved quando o provedor confirma o pagamento. Em sandbox o Pix é aprovado automaticamente; em produção, o pagador precisa realmente pagar.

4. Receba a notificação

Configure webhooks para ser notificado do desfecho sem precisar consultar. Também é possível consultar a lista de pagamentos: GET /v1/payments.

Pronto: o pagador escaneia, o provedor confirma, o Paygrid atualiza o status e (se configurado) dispara o webhook.