Product Customization and Add-ons

This feature enables you to link a product with a customization or add-on (such as engraving or a special setting) that incurs an additional fee or price.

Customization

To set up this relationship, modify the getCheckoutCartInfo request:

No changes are required to the parent product.
Set the customization or add-on product as follows:
- Set ParentCartItemId to the CartItemId of the parent parent product.
- Set the productCartItemOptionId to denote the nature of this product add-on, such as "Engraving."
- If the customization or add-on is not a distinct physical product, set IsVirtual to true in your getCheckoutCartInfo.

Note

By default, the customization or add-on is displayed on separate lines on the checkout page. If you require them to appear on the same line beneath the parent product, reach out to the Global-e design team for assistance. Additionally, we can configure the transactional emails to showcase the customization or add-on beneath the parent product instead of displaying them on separate lines.

Example:

{
	"productsList": [
		{
			"ProductCode": "ProductCode",
			"CartItemId": "line 1",
			"Name": "Product Name",
			"NameEnglish": "Product Name",
			"Description": "Description",
			"DescriptionEnglish": "Description",
			"ImageURL": "https://domain/img/imageName.jpg",
			"ImageWidth": "",
			"ImageHeight": "",
			"OriginalListPrice": 100,
			"OriginalSalePrice": 100,
			"OrderedQuantity": 1
		},
		{
			"ProductCode": "ProductCode",
			"CartItemId": "line 2",
			"CartItemOptionId": "Engraving",
			"ParentCartItemId": "line 1",
			"Name": "Option Name",
			"NameEnglish": "Option Name",
			"Description": "Description",
			"DescriptionEnglish": "Description",
			"ImageURL": "https://domain/img/imageName.jpg",
			"ImageWidth": "",
			"ImageHeight": "",
			"OriginalListPrice": 40,
			"OriginalSalePrice": 40,
			"OrderedQuantity": 1,
			"IsVirtual": true
		}
	]
}

MID Support

U.S. Customs requires the Manufacturer's Identification Code (MID) for certain shipments to the United States.

What is Manufacturer’s Identification

Manufacturer's Identification (MID) includes details of the manufacturer of the goods which is required in some cases by the US customs. MID includes the full business name and postal address of the manufacturing supplier as well as a specific code based on the manufacturer's name and country.

MID is required for:

Any order shipped to the USA, with a declarative value to customs above $800, including at least one product manufactured in China.
Any shipment to the USA with a declarative value to customs higher than $2,500 (regardless of the Country Of Origin of the products).

Configuration

Configure the following MID fields:

MID Code: A unique identifier generated from the manufacturer's name and location.
MID Address: The full postal address of the manufacturing supplier.
MID Name: The complete business name of the manufacturing supplier.

To generate an MID Code

The Global-e Crossborder app gets the MID information from the Product Meta fields in the Products section.

If the required data is not already available in your system or cannot be obtained from your manufacturer(s), you can generate the MID code by following the steps below.

Collect Supplier Information: Ensure your manufacturing supplier has provided their complete business name and postal address. This information is essential for defining the MID code.
Generate the MID Code
1. Identify the two-letter ISO country code for the supplier’s country (e.g., GB for the United Kingdom, NL for the Netherlands, DE for Germany).
2. Use the first three letters of the supplier's first and second names (if applicable).
3. Extract the highest numerical digits (up to four) from the address line.
4. Use the first three letters of the supplier’s city name.
Example:
Supplier: Ozrock, 92 Alice Springs Road, Melbourne, Victoria, Australia, 3001
MID Code: AUOZR92MEL

MID Address and MID Name configuration

No special formatting is required for the MID Address and MID Name fields. These fields should be filled exactly as provided by the supplier's data.

Example:

MID Address: 92 Alice Springs Road, Melbourne, Victoria, Australia, 3001
MID Name: Ozrock

Ensure the MID information is set as Classes in your getCheckoutCartInfo API response.

Example

 {
  "productsList":[
      "MetaData":{
        "Attributes":[
          {
            "AttributeKey":"MID_Code",
            "AttributeValue":"********"
          },
          {
            "AttributeKey":"MID_Name",
            "AttributeValue":"********"
          },
          {
            "AttributeKey":"MID_Address",
            "AttributeValue":"********"
          }
]

Documentation Portal

Product Customization and Add-ons

Note

MID Support