Skip to main content

Documentation Portal

Product Setup

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.GetCheckoutCartInfo (to Merchant)

Note

By default, the customiztion 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, no matter the value, that includes at least one product manufactured in China/HK.

  • 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:

  • MIDCode: A unique identifier generated from the manufacturer's name and location.

  • MIDAddress: The full postal address of the manufacturing supplier.

  • MIDName: The complete business name of the manufacturing supplier.

To generate an MIDCode

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

  1. Collect Supplier Information: Ensure your manufacturing supplier has provided their complete business name and postal address. This information is essential for defining the MIDCode.

  2. Generate the MIDCode

    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

    MIDCode: AUOZR92MEL

MIDAddress and MIDName Configuration

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

Example:

  • MIDAddress: 92 Alice Springs Road, Melbourne, Victoria, Australia, 3001

  • MIDName: Ozrock

Ensure the MID fields are set as Classes in your getCheckoutCartInfo API response.Classes

  • Important! The field names must be set exactly as shown in the example below: midcode, midname, and midaddress.

Example

 {
  "productsList":[
      "MetaData":{
        "Attributes":[
          {
            "AttributeKey":"midcode",
            "AttributeValue":"********"
          },
          {
            "AttributeKey":"midname",
            "AttributeValue":"********"
          },
          {
            "AttributeKey":"midaddress",
            "AttributeValue":"********"
          }
]