Skip to main content
This guide explains how to specify product variants when submitting an order through the API, ensuring the correct options are selected for each purchase.

​
Amazon & Shopify

  • For Amazon and Shopify, the variantSelections field is not supported. You need to provide a deep link for productUrl that points directly to the correct variant.

​
Other Merchants

  • For non-Amazon/Shopify stores, if the productUrl in the checkout intent already includes the variant ID, you don’t need to include variantSelections in your request.
  • When using the variantSelections field, pass the exact option labels and values shown on the product page, not a variant ID. For example:
    [{ label: 'Size', value: '8.5' }, { label: 'Color', value: 'Blue' }]. If the values don’t match exactly, the API will return a options_not_selected error.
  • Variant information isn’t available through the Universal Checkout API. To access variant details, you’ll need to use a third-party API like Rainforest.