FastSpring AppAPI ReferenceWebhooksFastSpring JSChangelogFastSpring.com
Developer Documentation
Sign In

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

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 ↑