Static integration only
Do not follow this guide if you are dynamically fetching warranties.
Once the customer has completed a purchase, you must notify Mulberry of the sale in order to initiate coverage by hitting our /api/checkout endpoint. Upon notification, Mulberry will send a welcome email to the customer, with instructions to access the customer portal (where the customer can manage their warranty details and file claims).
Checkout Call
HTTP method: POST
Authentication: Private Bearer Token
Staging Endpoint: https://partner-staging.getmulberry.com/api/checkout
Production Endpoint: https://partner.getmulberry.com/api/checkout
The example below would notify Mulberry that a Table sold for $1200 had a 24-month warranty associated with it.
{
"line_items":[
{
"warranty":{
"warranty_price":"100.00",
"warranty_id":"WTY-233",
"warranty_duration":24
},
"products":[
{
"product_price":"1200.00",
"product_id":"123456",
"product_title":"Dining Table",
"meta": {
"breadcrumbs": [
{"category": "All Products", "url": "https://yoursite.com/products"},
{"category": "Kitchen & Dining", "url": "https://yoursite.com/products/kitchen-and-dining"},
{"category": "Kitchen & Dining Furniture", "url": "https://yoursite.com/products/kitchen-and-dining-furniture"},
{"category": "Dining Tables", "url": "https://yoursite.com/products/dining-chairs"}
]
}
}
]
}
],
"billing_address":{
"city":"Brooklyn",
"first_name":"Josephine",
"last_name":"Clark",
"zip":"11231",
"address1":"123 Mint St. Apt 3F",
"address2":"",
"phone":"6462223345",
"state":"New York",
"country_code":"US",
"country":"United States"
},
"id":1455353616,
"phone":"1234567890",
"email":"[email protected]"
}Parameter | Definition | Required | Type |
|---|---|---|---|
line_items | Line items / products to add warranty coverage for | yes |
|
warranty | The warranty details | yes |
|
warranty_price | The price the customer purchased the warranty for (excluding tax) | yes |
|
warranty_id | The SKU representing a warranty in your product catalog | yes |
|
warranty_duration | The duration of the warranty sold in months | yes |
|
products | List of products covered by a warranty | yes |
|
product_price | The price the customer paid for the product (excluding tax) | yes |
|
product_id | The SKU of the product being purchased | yes | 'string' |
product_title | The title of the product sold | yes |
|
retailer categories | Product categorization assigned by the retailer | no |
|
images | Product images | no |
|
meta | Product metadata | no |
|
billing_address | The address of the customer purchasing the warranty | yes |
|
first_name | Customer First name | yes | `string |
last_name | Customer Last name | yes |
|
address1 | Customer Address Line 1 | yes |
|
address2 | Customer Address Line 2 | no |
|
phone | Customer Phone number | yes |
|
state | Customer State | yes |
|
country_code | Customer Country Code | yes |
|
country | Customer Country | yes |
|
id | The unique ID of the order in your ecommerce platform | yes |
|
email: | Customer Email | yes |
|
Handling quantity
To checkout with more than 1 of the same product, you must repeat the line item in the
line_itemsarray