Order Chargeback

chargeback.created

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.

Payload properties

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

NameTypeDescription
Chargeback Details
idstringUnique identifier for the chargeback event
reasonCodestringProcessor-assigned reason code for the dispute
reasonDescriptionstringPlain-language description of the reason code
fraudTypestringIndicates a fraud-related chargeback; current payloads return true
creationDatestringDate and time FastSpring received the chargeback in UTC
Transaction Info
chargebackAmountnumberTotal chargeback amount in transaction currency
currencystringThree-letter ISO 4217 currency code for chargebackAmount
orderstringOrder ID associated with the chargeback
processorCaseIdstringDispute case identifier from the payment processor
statusstringStatus of the chargeback (e.g., NEW)
Payment Method
paymentMethodstringPayment method used for the original transaction (e.g., CREDIT_CARD, PAYPAL)
paymentMethodVariantstringSpecific payment variant or card brand (e.g., Mastercard, Visa); may be null