Skip to main content
Este evento é disparado quando um estorno ou chargeback é processado em um pedido previamente pago.

​
Exemplo de Payload

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "event_type": "order.refunded",
  "status": "refunded",
  "amount": "9900",
  "currency": "BRL",
  "net_amount": "9405",
  "created_at": "2026-01-27T10:30:00.000Z",
  "paid_at": "2026-01-27T10:35:00.000Z",
  "chargeback_at": "2026-01-30T15:20:00.000Z",
  "payment_method": "credit_card",
  "customer": {
    "id": "customer-uuid",
    "name": "João Silva",
    "email": "[email protected]",
    "phone": "5511999999999",
    "document": "12345678900"
  },
  "offers": [
    {
      "id": "offer-uuid",
      "name": "Produto Principal",
      "price": 9900,
      "quantity": 1,
      "type": "principal"
    }
  ],
  "paymentDetail": {
    "card_brand": "visa",
    "card_last_digits": "4242",
    "card_holder_name": "JOAO SILVA",
    "installments": 1
  }
}

​
Campos do Payload

Tipo: string (UUID)Identificador único do pedido.
"id": "550e8400-e29b-41d4-a716-446655440000"
Tipo: stringSempre será "order.refunded" neste evento.
"event_type": "order.refunded"
Tipo: stringSempre será "refunded" neste evento.
"status": "refunded"
Tipo: stringValor total do pedido original em centavos.
"amount": "9900"  // R$ 99,00
Tipo: stringCódigo da moeda (BRL, USD, MXN, etc.).
"currency": "BRL"
Tipo: stringValor líquido do pedido original em centavos.
"net_amount": "9405"  // R$ 94,05
Tipo: string (ISO 8601)Data em que o pedido foi criado originalmente.
"created_at": "2026-01-27T10:30:00.000Z"
Tipo: string (ISO 8601)Indica quando o estorno foi processado. Sempre preenchido neste evento.
"chargeback_at": "2026-01-30T15:20:00.000Z"
Tipo: stringMétodo usado na transação original. Valores possíveis:
  • bank_slip - Boleto bancário
  • credit_card - Cartão de crédito
  • pix - PIX
  • wallet_picpay - Carteira PicPay
  • wallet_google_pay - Google Pay
  • wallet_apple_pay - Apple Pay
  • paypal - PayPal
"payment_method": "credit_card"
Tipo: objectObjeto contendo informações do cliente.
{
  "id": "customer-uuid",       // string
  "name": "João Silva",        // string
  "email": "[email protected]",   // string
  "phone": "5511999999999",    // string
  "document": "12345678900"    // string
}
Tipo: arrayLista de produtos que foram estornados.
[
  {
    "id": "offer-uuid",           // string
    "name": "Produto Principal",  // string
    "price": 9900,                // number (centavos)
    "quantity": 1,                // number
    "type": "principal"           // string
  }
]
Tipo: objectDetalhes do método de pagamento original.
{
  "card_brand": "visa",              // string | null
  "card_last_digits": "4242",        // string | null
  "card_holder_name": "JOAO SILVA",  // string | null
  "installments": 1                  // number
}