Warranty Updates Webhook

🚧
This feature is not finalized and is subject to change.

The Warranty Updates webhook provides events for changes in a single warranty. Webhooks are delivered via a POST request. The following events are supported:

Warranty Activated (For un-activated MulberryCare plans only)
Warranty Activation Expired (For un-activated MulberryCare plans only)
Warranty Upgraded
Warranty Cancelled
Warranty Claim Approved

Warranty update events contain the full details of the issued warranty. In the case of upgrades, it is possible for warranty details to change including coverage_details or the policy_terms_url.

Warranty Activated

A WARRANTY_ACTIVATED event occurs when a customer activates a Mulberry Care warranty. This cannot occur for non Mulberry Care plans or already activated Mulberry Care plans. The activated event data will contain an id for the active Mulberry warranty.

{
	"event_id": 1000,
	"event_name": "WARRANTY_ACTIVATED",
	"data": {
		"warranty": {
			"id": "6e21a59b06824bbd9f6480c0c193fc28",
			"order_id": "6e0650f72d52459baf2f79c2d135b701",
			"external_order_id": "order-12345",
			"external_product_id": "product-1234567",
			"warranty_status": "active",
			"duration_months": 12,
			"warranty_start_date": "2022-10-10 17:49:24.079121+00:00",
			"warranty_end_date": "2023-10-10 17:49:24.079121+00:00",
			"policy_terms_url": "https://terms.getmulberry.com/20210210_shield_multiproduct",
			"coverage_details": {
				"long": [
					"Accidental rips & tears",
					"Seam separation",
					"Broken zippers",
					"Minor burn or heat marks, up to one inch in length",
					"All stain types",
					"Extended coverage for product defects, past the limited warranty",
					"Free repairs and fast replacements, with no additional fees"
				],
				"short": [
					"Rips & tears",
					"Seam separation",
					"Broken zippers",
					"Minor burn or heat marks",
					"Accidental stains",
					"Product defects, once the limited warranty expires",
					"Free repairs and fast replacements"
				]
			},
			"purchase_window_days": 60,
			"available_upgrade_plans": [
				{
					"price": "34.99",
					"currency": "USD",
					"duration_months": 36
				},
				{
					"price": "54.99",
					"currency": "USD",
					"duration_months": 60
				}
       ]
		}
	}
}

Warranty Activation Window Expired

A WARRANTY_ACTIVATION_EXPIRED event occurs when a customer does not activate a Mulberry Care warranty within the activation window. This cannot occur for non Mulberry Care plans or already activated Mulberry Care plans. The activated event data will not contain an id for the active Mulberry warranty.

In this state a warranty is no longer eligible for activation. If the warranty has upgrade offers then it is still eligible for purchased upgrade plans until the end of the purchase window.

{
	"event_id": 1000,
	"event_name": "WARRANTY_ACTIVATION_EXPIRED",
	"data": {
		"warranty": {
			"id": null,
			"order_id": "6e0650f72d52459baf2f79c2d135b701",
			"external_order_id": "order-12345",
			"external_product_id": "product-1234567",
			"warranty_status": "expired",
			"duration_months": 12,
			"warranty_start_date": null,
			"warranty_end_date": null,
			"policy_terms_url": "https://terms.getmulberry.com/20210210_shield_multiproduct",
			"coverage_details": {
				"long": [
					"Accidental rips & tears",
					"Seam separation",
					"Broken zippers",
					"Minor burn or heat marks, up to one inch in length",
					"All stain types",
					"Extended coverage for product defects, past the limited warranty",
					"Free repairs and fast replacements, with no additional fees"
				],
				"short": [
					"Rips & tears",
					"Seam separation",
					"Broken zippers",
					"Minor burn or heat marks",
					"Accidental stains",
					"Product defects, once the limited warranty expires",
					"Free repairs and fast replacements"
				]
			},
			"purchase_window_days": 60,
			"available_upgrade_plans": [
				{
					"price": "34.99",
					"currency": "USD",
					"duration_months": 36
				},
				{
					"price": "54.99",
					"currency": "USD",
					"duration_months": 60
				}
       ]
		}
	}
}

Warranty Upgraded

A WARRANTY_UPGRADED event occurs when a customer upgrades from a Mulberry Care warranty to an extended regular warranty plan. This cannot occur for non Mulberry Care plans. The upgraded event data will contain an id for the active Mulberry warranty.

Sample event payload:

{
	"event_id": 1001,
	"event_name": "WARRANTY_UPGRADED",
	"data": {
		"warranty": {
			"id": "6e21a59b06824bbd9f6480c0c193fc28",
			"order_id": "6e0650f72d52459baf2f79c2d135b701",
			"external_order_id": "order-12345",
			"external_product_id": "product-1234567",
			"warranty_status": "active",
			"duration_months": 24,
			"warranty_start_date": "2021-10-10 17:49:24.079121+00:00",
			"warranty_end_date": "2023-10-10 17:49:24.079121+00:00",
			"policy_terms_url": "https://terms.getmulberry.com/20210210_shield_multiproduct",
			"coverage_details": {
				"long": [
					"Accidental rips & tears",
					"Seam separation",
					"Broken zippers",
					"Minor burn or heat marks, up to one inch in length",
					"All stain types",
					"Extended coverage for product defects, past the limited warranty",
					"Free repairs and fast replacements, with no additional fees"
				],
				"short": [
					"Rips & tears",
					"Seam separation",
					"Broken zippers",
					"Minor burn or heat marks",
					"Accidental stains",
					"Product defects, once the limited warranty expires",
					"Free repairs and fast replacements"
				]
			},
			"purchase_window_days": null,
			"available_upgrade_plans": []
		}
	}
}

Warranty Cancelled

A WARRANTY_CANCELLED event occurs when a customer, partner or Mulberry cancels an issued warranty. In the case of a warranty that Mulberry collected payment for, this event occurs after Mulberry has successfully refunded the customer.

Sample event payload:

{
	"event_id": 1002,
	"event_name": "WARRANTY_CANCELLED",
	"data": {
		"warranty": {
			"id": "6e21a59b06824bbd9f6480c0c193fc28",
			"order_id": "6e0650f72d52459baf2f79c2d135b701",
			"external_order_id": "order-12345",
			"external_product_id": "product-1234567",
			"warranty_status": "cancelled",
			"duration_months": 12,
			"warranty_start_date": "2021-10-10 17:49:24.079121+00:00",
			"warranty_end_date": "2022-10-10 17:49:24.079121+00:00",
			"policy_terms_url": "https://terms.getmulberry.com/20210210_shield_multiproduct",
			"coverage_details": {
				"long": [
					"Accidental rips & tears",
					"Seam separation",
					"Broken zippers",
					"Minor burn or heat marks, up to one inch in length",
					"All stain types",
					"Extended coverage for product defects, past the limited warranty",
					"Free repairs and fast replacements, with no additional fees"
				],
				"short": [
					"Rips & tears",
					"Seam separation",
					"Broken zippers",
					"Minor burn or heat marks",
					"Accidental stains",
					"Product defects, once the limited warranty expires",
					"Free repairs and fast replacements"
				]
			},
			"purchase_window_days": 60,
			"available_upgrade_plans": [{
					"price": "34.99",
					"currency": "USD",
					"duration_months": 36
				},
				{
					"price": "54.99",
					"currency": "USD",
					"duration_months": 60
				}
			]
		}
	}
}

Warranty Claim Approved

A WARRANTY_CLAIM_APPROVED event occurs when a customer has filed a claim and a portion or the entire amount of the warranty has been paid out by Mulberry. This event can be used to track the status of a warranty to identify when it is active or marked fulfilled using the warranty_status field.

A product warranty is worth up to the original product price. If a customer files a claim and 10% of the product price is paid out for repairs, the customer may file a claim again and can use the remaining 90% balance on their warranty for any other valid claims. Once the balance on a warranty has been exhausted, the warranty is closed out. At this point a customer may not file additional claims.

Sample event payload:

{
	"event_id": 1003,
	"event_name": "WARRANTY_CLAIM_APPROVED",
	"data": {
		"warranty": {
			"id": "6e21a59b06824bbd9f6480c0c193fc28",
			"order_id": "6e0650f72d52459baf2f79c2d135b701",
			"external_order_id": "order-12345",
			"external_product_id": "product-1234567",
			"warranty_status": "fulfilled",
			"duration_months": 24,
			"warranty_start_date": "2021-10-10 17:49:24.079121+00:00",
			"warranty_end_date": "2023-10-10 17:49:24.079121+00:00",
			"policy_terms_url": "https://terms.getmulberry.com/20210210_shield_multiproduct",
			"coverage_details": {
				"long": [
					"Accidental rips & tears",
					"Seam separation",
					"Broken zippers",
					"Minor burn or heat marks, up to one inch in length",
					"All stain types",
					"Extended coverage for product defects, past the limited warranty",
					"Free repairs and fast replacements, with no additional fees"
				],
				"short": [
					"Rips & tears",
					"Seam separation",
					"Broken zippers",
					"Minor burn or heat marks",
					"Accidental stains",
					"Product defects, once the limited warranty expires",
					"Free repairs and fast replacements"
				]
			},
			"purchase_window_days": null,
			"available_upgrade_plans": []
		}
	}
}