chargeback.created
Overview of the chargeback.created webhook
chargeback.created webhookWhen 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.createdwebhook - 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.
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 |