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",
      "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": "[email protected]",
    "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.

ParameterDescriptionRequiredType
order_idUnique order ID from your ecommerce platform (Must be a non-sequential / UUID)yesstring
line_itemsList of products to offer protection plans foryesarray
product_idProduct SKUyesstring
product_priceProduct priceyesstring
product_titleProduct titleyesstring
metaProduct metadatanoobject
imagesProduct imagesnoarray
billing_addressCustomer addressyesobject
first_nameFirst nameyesstring
last_nameLast namenostring
address1Address Line 1nostring
phonePhone numbernostring
emailEmail Addressyesstring
cityCitynostring
stateStateyesstring
countryCountryyesstring
address2Address Line 2nostring

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]

ParameterDefinition
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_idThis is the order ID from your ecommerce platform for this particular customer's order.