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 webhook documentation.

Webhook payload example

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

{
  "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"
}

Navigate this webhook

The chargeback.created webhook payload contains a small set of fields grouped into three categories. Use the links below to jump directly to a section of the property reference.

Chargeback Details

Transaction Info

Payment Method

Payload properties

All fields below are included in the chargeback.created webhook payload. Fields are grouped into categories for easier navigation.

Name	Type	Description
Chargeback Details
id	string	Unique identifier for the chargeback event
reasonCode	string	Processor-assigned reason code for the dispute
reasonDescription	string	Plain-language description of the reason code
fraudType	string	Indicates a fraud-related chargeback; current payloads return `true`
creationDate	string	Date and time FastSpring received the chargeback in UTC
Transaction Info
chargebackAmount	number	Total chargeback amount in transaction currency
currency	string	Three-letter ISO 4217 currency code for `chargebackAmount`
order	string	Order ID associated with the chargeback
processorCaseId	string	Dispute case identifier from the payment processor
status	string	Status of the chargeback (e.g., `NEW`)
Payment Method
paymentMethod	string	Payment method used for the original transaction (e.g., `CREDIT_CARD`, `PAYPAL`)
paymentMethodVariant	string	Specific payment variant or card brand (e.g., `Mastercard`, `Visa`); may be `null`