# Overview of the `chargeback.created` webhook

When a `chargeback.created` event is triggered, FastSpring sends a webhook payload with chargeback details, including the reason, amount, and payment method. This webhook typically fires when a buyer's bank or card issuer initiates a chargeback against a FastSpring order.

This page includes:

* A full sample payload for the `chargeback.created` webhook
* A detailed table listing every payload property, including name, type, and description
* Field-specific notes for fraud-related chargebacks and processor metadata

> **Note:** Chargebacks are not the same as refunds. For refund-related events, refer to the [return.created](https://developer.fastspring.com/reference/returncreated) webhook documentation.

<div style={{ margin: "5%" }}></div>

# Webhook payload example

When a `chargeback.created` event is triggered, the webhook sends the following JSON payload:

```json
{
  "id": "F_sVWUGMSGKu3ATP3xe2Xg",
  "reasonCode": "4837",
  "reasonDescription": "FRAUDULENT",
  "fraudType": "true",
  "creationDate": "Fri May 09 17:00:00 UTC 2025",
  "chargebackAmount": 171.68,
  "currency": "BRL",
  "order": "F_sVWUGMSGKu3ATP3xe2Xg",
  "processorCaseId": "dsp_6dtaqbtq3cee7fqg3522hjgeqi",
  "status": "NEW",
  "paymentMethod": "CREDIT_CARD",
  "paymentMethodVariant": "Mastercard"
}

Payload properties

The payload properties table lists each field in the chargeback.created webhook payload, along with its name, type, and description.

Tip: Not all fields are always included. Some fields may return null or be omitted depending on the processor or payment method.

Name	Type	Description
Chargeback Details
`id`	string	Unique identifier for the chargeback event. Matches the associated order ID. This value is globally unique.
`reasonCode`	string	Chargeback reason code assigned by the payment processor. Values may vary by processor and dispute type.
`reasonDescription`	string	Plain-language description of the reason code. May indicate fraud, processing errors, or other dispute categories.
`fraudType`	boolean (string)	Indicates a fraud-related chargeback. This value is currently always `true`.
`creationDate`	string	Date and time FastSpring received the chargeback from the processor. Formatted in UTC.
Transaction Info
`chargebackAmount`	number	Total monetary amount of the chargeback, in the original transaction currency.
`currency`	string	3-letter ISO code representing the currency of the chargeback amount.
`order`	string	FastSpring-generated ID of the order associated with the chargeback.
`processorCaseId`	string	Case reference ID from the payment processor. Used to track and manage the dispute.
`status`	string	Status of the chargeback event. This value is currently always `NEW`.
Payment Method
`paymentMethod`	string	Payment method used for the original transaction. Example values: `CREDIT_CARD`, `PAYPAL`.
`paymentMethodVariant`	string	Specific variant of the payment method, such as a card brand. Example values: `Mastercard`, `Visa`. May be `null`.
Back to top ↑