chargeback

Disparado quando um chargeback é registrado — a adquirente notificou que o portador do cartão contestou a cobrança.

Quando é disparado

• A gateway (Cielo, Asaas, etc.) envia notificação de chargeback para o TukanoPay.
• O TukanoPay processa internamente (atualiza transação, revoga acesso à área de membros quando aplicável) e dispara este webhook para você.

Exemplo de payload

{
  "event": "chargeback",
  "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": "cielo",
    "gatewayTransactionId": "id-transacao-no-gateway",
    "chargebackReason": "Cartão roubado",
    "chargebackDate": "2025-01-28T15:00:00.000Z",
    "gateway": "cielo"
  },
  "timestamp": "2025-01-28T15: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 da transação em reais.
currency	string	Moeda.
customer	object	Dados do comprador.
paymentProvider	string	Gateway da transação.
gatewayTransactionId	string	ID no gateway.
chargebackReason	string	Motivo informado pela adquirente.
chargebackDate	string	Data do chargeback em ISO 8601.
gateway	string	Nome da gateway que reportou o chargeback.