pix.generated

Disparado quando um QR Code PIX é gerado para o cliente. O pagamento ainda está pendente até a confirmação (quando então é disparado purchase.approved).

Quando é disparado

• O cliente escolheu pagar com PIX no checkout.
• O gateway gerou o QR Code e o payload PIX (copiar e colar).

Exemplo de payload

{
  "event": "pix.generated",
  "data": {
    "transactionId": "uuid-da-transacao",
    "productId": "uuid-do-produto",
    "productName": "Nome do Produto",
    "amount": 97.00,
    "currency": "BRL",
    "customer": {
      "email": "cliente@email.com",
      "name": "Nome do Cliente",
      "document": "12345678900",
      "phone": "11999999999"
    },
    "paymentProvider": "rapdyn",
    "gatewayTransactionId": "id-transacao-no-gateway",
    "pixQrCode": {
      "encodedImage": "base64-da-imagem-qrcode"
    },
    "pixPayload": "00020126580014br.gov.bcb.pix...",
    "pixCopyPaste": "00020126580014br.gov.bcb.pix...",
    "pixExpirationDate": "2025-01-29T12:00:00.000Z",
    "status": "pending",
    "createdAt": "2025-01-28T12:00:00.000Z"
  },
  "timestamp": "2025-01-28T12:00:00.000Z",
  "webhookId": "uuid-do-webhook"
}

Campos do data

Campo	Tipo	Descrição
transactionId	string	ID da transação no TukanoPay.
productId	string	ID do produto.
productName	string	Nome do produto.
amount	number	Valor em reais.
currency	string	Moeda.
customer	object	Dados do comprador.
paymentProvider	string	Gateway (PIX é via rapdyn).
gatewayTransactionId	string	ID no gateway.
pixQrCode	object	Imagem do QR Code em base64.
pixPayload	string	Código PIX (copiar e colar).
pixCopyPaste	string	Mesmo código PIX.
pixExpirationDate	string	Data/hora de expiração do PIX em ISO 8601.
status	string	Sempre pending neste momento.
createdAt	string	Data de criação em ISO 8601.