purchase.refused

Disparado quando uma compra é recusada — todas as tentativas de pagamento (em uma ou mais gateways) falharam.

Quando é disparado

• Cartão recusado em todas as gateways configuradas.
• Timeout ou erro ao processar o pagamento.

Exemplo de payload

{
  "event": "purchase.refused",
  "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"
    },
    "failedAttempts": [
      {
        "gateway": "cielo",
        "error": "Cartão recusado"
      },
      {
        "gateway": "asaas",
        "error": "Transação não autorizada"
      }
    ],
    "lastError": "Transação não autorizada",
    "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.
failedAttempts	array	Lista de tentativas que falharam em cada gateway.
failedAttempts[].gateway	string	Nome da gateway.
failedAttempts[].error	string	Mensagem de erro retornada.
lastError	string	Último erro (útil para exibir ao usuário).
createdAt	string	Data de criação em ISO 8601.