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