Skip to main content
Para mais detalhes sobre o endpoint e a descrição completa de todos os campos do body, consulte a referência do endpoint.

​
Visão Geral

Esta receita mostra como criar uma cobrança PIX e exibir o QR Code para o pagador. O fluxo completo:
  1. Criar a cobrança PIX
  2. Exibir o QR Code para o pagador
  3. Receber a confirmação via webhook (ver página dedicada)

​
Pré-requisitos

​
1. Criar a cobrança PIX

Crie a cobrança enviando o valor e, opcionalmente, uma referência externa para identificar o pedido no seu sistema: 
curl -X POST 'https://app.plowf.com/api/v1/payments' \
  -H 'Authorization: Bearer seu_token_aqui' \
  -H 'Content-Type: application/json' \
  -d '{
    "value": 150.00,
    "type": "pix",
    "external_ref": "PEDIDO-12345"
  }'
A resposta inclui o campo payment.payload com o código Copia e Cola do PIX: 
{
  "data": {
    "uuid": "770e8400-e29b-41d4-a716-446655440000",
    "status": "PENDING",
    "payment": {
      "payload": "00020126580014br.gov.bcb.pix...",
      "expires_at": "2024-01-01T23:59:59Z"
    },
    "external_ref": "PEDIDO-12345"
  }
}

​
2. Exibir o QR Code para o pagador

Use o payload para gerar o QR Code na sua interface. Exemplo com Node.js: 
const QRCode = require('qrcode');

async function gerarQRCode(payload) {
  const dataUrl = await QRCode.toDataURL(payload);
  return dataUrl; // Base64 PNG para exibir em <img src="...">
}
Exiba também o código Copia e Cola como texto para quem preferir copiar e colar no app do banco.
O QR Code expira na data indicada em payment.expires_at. Informe o usuário sobre o prazo.

​
Próximos passos

Com a cobrança criada, configure seu endpoint para processar a confirmação de pagamento:

​
Referências