Event payload example and property overview for subscription.group.deactivated
Webhook response payload example (expansion enabled)
When a subscription.group.deactivated
event is triggered, the webhook sends the following JSON payload:
{
"cotermGroupId": "aB1c2deFGhIjKL3mn-opqR",
"cotermGroupDisplayName": "Tech Services Monthly Plan",
"cotermGroupPeriodStartDate": 1754044800000,
"cotermGroupPeriodEndDate": 1756646400000,
"cotermGroupPrimarySubscription": "sub-001",
"cotermGroupStatus": "DUNNING",
"cotermGroupOrderId": "aBCDE12fGH3iJkL4mNOpq",
"cotermNextChargeDate": 1740441600000,
"cotermNextChargeTotal": 49.9,
"cotermGroupSize": 2,
"currency": "USD",
"account": {
"id": "abCdE1FGH2Hij3KLMnOpqR",
"account": "abCdE1FGH2Hij3KLMnOpqR",
"contact": {
"first": "Jane",
"last": "Doe",
"email": "jane.doe@company.com",
"company": "Company Inc.",
"phone": "8001234567",
"subscribed": true
},
"address": {
"address line 1": "123 Business Rd",
"address line 2": "Floor 4",
"city": "Metropolis",
"country": "US",
"postal code": "12345",
"region": "US-NY",
"region custom": null,
"company": "Company Inc."
},
"language": "en",
"country": "US",
"lookup": {
"global": "lookup-001"
},
"url": "https://company.onfastspring.com/account"
},
"subscriptions": [
"1abc2DE_FGhIjKLm3NoPQR",
"2abc2DE_FGhIjKLm3NoPQR"
]
}
Webhook response payload properties
The webhook response properties table outlines each property in the subscription.group.deactivated
event JSON payload, specifying their name, data type, and description.
Name | Type | Description |
---|---|---|
Co-term Group Information | ||
cotermGroupId | string | Unique identifier for the co-term group. |
cotermGroupDisplayName | string | Display name of the co-term group. This property is optional when creating a co-term group. |
cotermGroupPeriodStartDate | integer | Start date of the co-term group period in milliseconds. |
cotermGroupPeriodEndDate | integer | End date of the co-term group period in milliseconds. |
cotermGroupPrimarySubscription | string | ID of the primary subscription in the co-term group. This property represents the most recently purchased subscription within the group. |
cotermGroupStatus | string | Status of the co-term group (e.g., "EXECUTED"). |
cotermGroupOrderId | string | Order ID associated with the co-term group. |
cotermNextChargeDate | integer | Next charge date for the co-term group in milliseconds. This value is computed by adding one day to the length of the current term (see the monthly and yearly subscription examples below).
Monthly Subscription: If the co-term is initiated on February 11, the next charge date becomes March 12 (one full month plus one day). Yearly Subscription: If initiated on February 11, 2025, the next charge date becomes February 12, 2026 (one full year plus one day). |
cotermNextChargeTotal | number | Total amount for the next charge, displayed in the nextChargeCurrency. |
cotermGroupSize | string | Number of subscriptions in the co-term group. |
currency | string | 3-character ISO code of the currency used in the co-term group (e.g., "USD"). |
Account Object | ||
account.id | string | Unique identifier for the account. |
account.account | string | FastSpring-generated customer account ID. |
account.contact.first | string | First name of the account contact. |
account.contact.last | string | Last name of the account contact. |
account.contact.email | string | Email address of the account contact. |
account.contact.company | string | Company name associated with the account contact (if applicable). |
account.contact.phone | string | Phone number of the account contact (if provided). |
account.contact.subscribed | boolean | Indicates if the account contact is subscribed to updates. |
account.address.address line 1 | string | First line of the account address. |
account.address.address line 2 | string | Second line of the account address (if applicable). |
account.address.city | string | City of the account address. |
account.address.country | string | Country of the account address (ISO 3166-1 alpha-2 code). |
account.address.postal code | string | Postal code of the account address. |
account.address.region | string | Region of the account address (e.g., state or province). |
account.address.region custom | string | Custom region information for the account address (if provided). |
account.address.company | string | Company name associated with the account address (if applicable). |
account.language | string | Preferred language of the account (e.g., "en"). Two-letter language code (ISO 639). |
account.country | string | Country associated with the account. Two-letter country code (ISO 3166-1 alpha-2). |
account.lookup.global | string | Global lookup identifier for the account. |
account.url | string | FastSpring account URL for accessing the account's details. |
Subscriptions Array | ||
subscriptions | array | Array of subscription IDs that were a part of the deactivated co-term group. |