Mulberry gives retailers the ability to offer a personalized remarketing experience to customers that do not attach a warranty to their sale during the on-site checkout process. We are able to tailor the customer’s landing page to the unique transaction, by providing information on what the customer bought (driving higher attachment rates for you).

For example, by sending a POST request to our /api/carts endpoint with the following information, we can return URL to you that can then be integrated into your Mulberry remarketing materials.

Post Purchase Link Endpoint

HTTP method: POST

Authentication: Private Bearer Token

Staging Endpoint: https://partner-staging.getmulberry.com/api/carts

Production Endpoint: https://partner.getmulberry.com/api/carts

{
  "order_id": "7689dde5c0f64fffa7ad217f6f73",
  "line_items": [
    {
      "product_title": "Apple Macbook Pro 2019",
      "product_id": "123456",
      "product_price": "1500.00",
      "product_delivery_date": "2025-12-15",
      "meta": {
        "breadcrumbs": [
          {
            "category": "Electronics"
          },
          {
            "category": "Consumer Electronics"
          }
        ]
      },
      "detail": {
        "images": [
          {
            "src": "https://www.apple.com/v/macbook-pro/af/images/overview/hero_13__d1tfa5zby7e6_large_2x.jpg"
          }
        ]
      }
    }
  ],
  "billing_address": {
    "first_name": "Josephine",
    "last_name": "Clark",
    "address1": "123 Mint St. Apt 3F",
    "phone": "",
    "email": "j.clark1234@gmail.com",
    "city": "Brooklyn",
    "zip": "11231",
    "state": "NY",
    "country": "United States",
    "address2": "",
    "country_code": "US",
    "province_code": "NY"
  }
}

Providing additional information such as imagery and product metadata helps Mulberry identify and classify the product more accurately.

Parameter	Description	Required	Type
order_id	Unique order ID from your ecommerce platform (Must be a non-sequential / UUID)	yes	`string`
line_items	List of products to offer protection plans for	yes	`array`
product_id	Product SKU	yes	`string`
product_price	Product price	yes	`string`
product_title	Product title	yes	`string`
product_delivery_date	Product delivery date	no	`string`
meta	Product metadata	no	`object`
images	Product images	no	`array`
billing_address	Customer address	yes	`object`
first_name	First name	yes	`string`
last_name	Last name	no	`string`
address1	Address Line 1	no	`string`
phone	Phone number	no	`string`
email	Email Address	yes	`string`
city	City	no	`string`
state	State	yes	`string`
country	Country	yes	`string`
address2	Address Line 2	no	`string`

Staging Response

{
  "success": true,
  "url": "https://staging.getmulberry.com/carts/3af6dd3b/checkout/7689dde5c0f64fffa7ad217432f6f73",
  "warrantable_products": true
}

Production Response

{
  "success": true,
  "url": "https://app.getmulberry.com/carts/3af6dd3b/checkout/7689dde5c0f64fffa7ad217432f6f73",
  "warrantable_products": true
}

If any of the purchased products are eligible for a warranty, then warrantable_products will be returned as true. Then, the response URL can then be used on Thank You pages, marketing email campaigns etc.

🚧
Building the URL
You don't need to store the URL that the carts API responds with. You can build it by using the values below.

Landing Page URL Structure

The structure of the Post Purchase landing page is as follows:

Staging

https://staging.getmulberry.com/carts/[retailer_uuid]/checkout/[order_id]

Production

https://app.getmulberry.com/carts/[retailer_uuid]/checkout/[order_id]

Parameter	Definition
retailer_uuid .	This is the unique ID that Mulberry has assigned to you and will not change. You can find it within the Settings tab within the Partner Dashboard
order_id	This is the order ID from your ecommerce platform for this particular customer's order.