For the specified market cart, add a item. If cart uuid not provided, a new cart is automatically created.
| Field | Type | Notes |
|---|
| accnt | A valid account number, up to 6 digits in length. | |
| admin | An associative array of arbitrary keys and values. | * Optional |
| created | A valid date and time in YYYY-MM-DD HH:MM:SS format, or a DateTime object. | |
| discounts | An array of associative arrays containing | |
| | | amount | A floating-point value. | | | discount_uuid | A valid UUID (Universally Unique IDentifier). | | | eligibility | An associative array containing the fields: | |
| | | categories | An array of arbitrary values. | | products | An array of arbitrary values. |
|
| item_uuid | A valid UUID (Universally Unique IDentifier). | * Optional | | modifiable | A boolean value (0 or 1). | | | modified | A boolean value (0 or 1). | | | owner | A string of text, containing no newlines or other control characters. | | | priority | A positive integer value (i.e. 1 and up). | | | repetition | A non-negative integer value (i.e. 0 and up). | | | strategy | One of: 'credit', 'percent', 'percent_mrc' | | | type | One of: 'account', 'admin', 'bundle', 'coupon', 'offset', 'package', 'reseller' | |
|
| expiration | A valid date and time in YYYY-MM-DD HH:MM:SS format, or a DateTime object. | |
| items | An array of associative arrays containing | |
| | | code | Either: a valid market bundle code, beginning with "BNDL-" and the rest beging at least 3 chars long, including at least one letter.; or a valid market package code, beginning with "PKG-" and the rest beging at least 3 chars long, including at least one letter.; or a valid product code, at least 3 chars long, including at least one letter. | | cycle | A valid billing cycle (monthly, quarterly, biannually, yearly, or biennially). | | details | One of the following: |
| | An associative array containing the fields: A market cart item containing all the details of a cart item containing a single product | * Optional |
| base_price | A positive floating-point value representing a price, containing 2 to 5 decimals. | | | code | A valid product code, at least 3 chars long, including at least one letter. | | | description | A string permitting tabs, carriage returns and newlines | | | discountable | A boolean value (0 or 1). | | | extra_data | An associative array of arbitrary keys and values. | * Optional | | global_discountable | A boolean value (0 or 1). | | | options | An array of associative arrays containing | |
| | | discountable | A boolean value (0 or 1). | | key | A product option name. | | key_description | A string of text, containing no newlines or other control characters. | | key_display_order | An integer value. | | key_group | A string of text, containing no newlines or other control characters. | | key_group_display_order | A string of text, containing no newlines or other control characters. | | num_units | An integer value. | | package_to_product_option_visibility | A single word, consisting of only letters and digits. | | parent_ptok_id | A valid id number (a positive integer). | | parent_ptov_id | A valid id number (a positive integer). | | price | A positive floating-point value representing a price, containing 2 to 5 decimals. | | price_total | A positive floating-point value representing a price, containing 2 to 5 decimals. | | ptok_id | A valid id number (a positive integer). | | ptov_id | A valid id number (a positive integer). | | value | A product option value. | | value_comments | A string permitting tabs, carriage returns and newlines | | value_description | A string of text, containing no newlines or other control characters. | | value_display_order | An integer value. | | value_price_time_unit | A single word, consisting of only letters, digits, hyphens, and underscores. |
|
| package_custom_description | A string permitting tabs, carriage returns and newlines | | | package_custom_title | A string permitting tabs, carriage returns and newlines | | | package_display_order | A positive integer value (i.e. 1 and up). | | | package_show_description | A boolean value (0 or 1). | | | package_to_product_id | A valid id number (a positive integer). | | | price_time_unit | A single word, consisting of only letters, digits, hyphens, and underscores. | | | product_id | A valid id number (a positive integer). | | | properties | An associative array of arbitrary keys and values. | * Optional | | region_id | A positive integer value (i.e. 1 and up). | | | related_package_to_product_id | A valid id number (a positive integer). | | | series_description | A string permitting tabs, carriage returns and newlines | | | series_display_order | A positive integer value (i.e. 1 and up). | | | series_entry_cart_category | A string permitting tabs, carriage returns and newlines | | | series_entry_cart_plan | A string permitting tabs, carriage returns and newlines | | | series_entry_cart_series | A string permitting tabs, carriage returns and newlines | | | series_entry_display_order | A positive integer value (i.e. 1 and up). | | | series_entry_featured | A boolean value (0 or 1). | | | subtitle | A string of text, containing no newlines or other control characters. | | | title | A string of text, containing no newlines or other control characters. | | | uuid | A valid UUID (Universally Unique IDentifier). | |
|
An associative array containing the fields: A market cart item containing all the details of a cart item containing a market package | * Optional |
| bundle_display_order | A positive integer value (i.e. 1 and up). | | bundle_to_package_id | A valid id number (a positive integer). | | code | A valid market package code, beginning with "PKG-" and the rest beging at least 3 chars long, including at least one letter. | | products | An array of associative arrays containing |
| | | base_price | A positive floating-point value representing a price, containing 2 to 5 decimals. | | | code | A valid product code, at least 3 chars long, including at least one letter. | | | description | A string permitting tabs, carriage returns and newlines | | | discountable | A boolean value (0 or 1). | | | extra_data | An associative array of arbitrary keys and values. | * Optional | | global_discountable | A boolean value (0 or 1). | | | options | An array of associative arrays containing | |
| | | discountable | A boolean value (0 or 1). | | key | A product option name. | | key_description | A string of text, containing no newlines or other control characters. | | key_display_order | An integer value. | | key_group | A string of text, containing no newlines or other control characters. | | key_group_display_order | A string of text, containing no newlines or other control characters. | | num_units | An integer value. | | package_to_product_option_visibility | A single word, consisting of only letters and digits. | | parent_ptok_id | A valid id number (a positive integer). | | parent_ptov_id | A valid id number (a positive integer). | | price | A positive floating-point value representing a price, containing 2 to 5 decimals. | | price_total | A positive floating-point value representing a price, containing 2 to 5 decimals. | | ptok_id | A valid id number (a positive integer). | | ptov_id | A valid id number (a positive integer). | | value | A product option value. | | value_comments | A string permitting tabs, carriage returns and newlines | | value_description | A string of text, containing no newlines or other control characters. | | value_display_order | An integer value. | | value_price_time_unit | A single word, consisting of only letters, digits, hyphens, and underscores. |
|
| package_custom_description | A string permitting tabs, carriage returns and newlines | | | package_custom_title | A string permitting tabs, carriage returns and newlines | | | package_display_order | A positive integer value (i.e. 1 and up). | | | package_show_description | A boolean value (0 or 1). | | | package_to_product_id | A valid id number (a positive integer). | | | price_time_unit | A single word, consisting of only letters, digits, hyphens, and underscores. | | | product_id | A valid id number (a positive integer). | | | properties | An associative array of arbitrary keys and values. | * Optional | | region_id | A positive integer value (i.e. 1 and up). | | | related_package_to_product_id | A valid id number (a positive integer). | | | series_description | A string permitting tabs, carriage returns and newlines | | | series_display_order | A positive integer value (i.e. 1 and up). | | | series_entry_cart_category | A string permitting tabs, carriage returns and newlines | | | series_entry_cart_plan | A string permitting tabs, carriage returns and newlines | | | series_entry_cart_series | A string permitting tabs, carriage returns and newlines | | | series_entry_display_order | A positive integer value (i.e. 1 and up). | | | series_entry_featured | A boolean value (0 or 1). | | | subtitle | A string of text, containing no newlines or other control characters. | | | title | A string of text, containing no newlines or other control characters. | | | uuid | A valid UUID (Universally Unique IDentifier). | |
|
| title | A string of text, containing no newlines or other control characters. | | version_id | A valid id number (a positive integer). |
|
An associative array containing the fields: A market cart item containing all the details of a cart item containing a market bundle | * Optional |
| code | A valid market bundle code, beginning with "BNDL-" and the rest beging at least 3 chars long, including at least one letter. | | packages | An array of associative arrays containing |
| | | bundle_display_order | A positive integer value (i.e. 1 and up). | | bundle_to_package_id | A valid id number (a positive integer). | | code | A valid market package code, beginning with "PKG-" and the rest beging at least 3 chars long, including at least one letter. | | products | An array of associative arrays containing |
| | | base_price | A positive floating-point value representing a price, containing 2 to 5 decimals. | | | code | A valid product code, at least 3 chars long, including at least one letter. | | | description | A string permitting tabs, carriage returns and newlines | | | discountable | A boolean value (0 or 1). | | | extra_data | An associative array of arbitrary keys and values. | * Optional | | global_discountable | A boolean value (0 or 1). | | | options | An array of associative arrays containing | |
| | | discountable | A boolean value (0 or 1). | | key | A product option name. | | key_description | A string of text, containing no newlines or other control characters. | | key_display_order | An integer value. | | key_group | A string of text, containing no newlines or other control characters. | | key_group_display_order | A string of text, containing no newlines or other control characters. | | num_units | An integer value. | | package_to_product_option_visibility | A single word, consisting of only letters and digits. | | parent_ptok_id | A valid id number (a positive integer). | | parent_ptov_id | A valid id number (a positive integer). | | price | A positive floating-point value representing a price, containing 2 to 5 decimals. | | price_total | A positive floating-point value representing a price, containing 2 to 5 decimals. | | ptok_id | A valid id number (a positive integer). | | ptov_id | A valid id number (a positive integer). | | value | A product option value. | | value_comments | A string permitting tabs, carriage returns and newlines | | value_description | A string of text, containing no newlines or other control characters. | | value_display_order | An integer value. | | value_price_time_unit | A single word, consisting of only letters, digits, hyphens, and underscores. |
|
| package_custom_description | A string permitting tabs, carriage returns and newlines | | | package_custom_title | A string permitting tabs, carriage returns and newlines | | | package_display_order | A positive integer value (i.e. 1 and up). | | | package_show_description | A boolean value (0 or 1). | | | package_to_product_id | A valid id number (a positive integer). | | | price_time_unit | A single word, consisting of only letters, digits, hyphens, and underscores. | | | product_id | A valid id number (a positive integer). | | | properties | An associative array of arbitrary keys and values. | * Optional | | region_id | A positive integer value (i.e. 1 and up). | | | related_package_to_product_id | A valid id number (a positive integer). | | | series_description | A string permitting tabs, carriage returns and newlines | | | series_display_order | A positive integer value (i.e. 1 and up). | | | series_entry_cart_category | A string permitting tabs, carriage returns and newlines | | | series_entry_cart_plan | A string permitting tabs, carriage returns and newlines | | | series_entry_cart_series | A string permitting tabs, carriage returns and newlines | | | series_entry_display_order | A positive integer value (i.e. 1 and up). | | | series_entry_featured | A boolean value (0 or 1). | | | subtitle | A string of text, containing no newlines or other control characters. | | | title | A string of text, containing no newlines or other control characters. | | | uuid | A valid UUID (Universally Unique IDentifier). | |
|
| title | A string of text, containing no newlines or other control characters. | | version_id | A valid id number (a positive integer). |
|
| title | A string of text, containing no newlines or other control characters. | | version_id | A valid id number (a positive integer). |
|
|
| type | A string of text, containing no newlines or other control characters. | | uuid | A valid UUID (Universally Unique IDentifier). |
|
| metadata | An associative array of arbitrary keys and values. | * Optional |
| orderable | A boolean value (0 or 1). | |
| share | A valid UUID (Universally Unique IDentifier). | |
| status | A single word, consisting of only letters, digits, and underscores. | |
| totals | An associative array containing the fields: | |
| | | charges | An array of associative arrays containing |
| | | billing | An array of associative arrays containing |
| | | cart | An associative array containing the fields: |
| | | cost | An associative array containing the fields: |
| | | discountable | A monetary value, such as -$.05, 0.05, or -5.00 | | non_discountable | A monetary value, such as -$.05, 0.05, or -5.00 | | total | A monetary value, such as -$.05, 0.05, or -5.00 |
|
| discounts | An array of associative arrays containing |
| | | amount | A floating-point value. | | amount_off | A monetary value, such as -$.05, 0.05, or -5.00 | | discount_uuid | An array of a valid UUID (Universally Unique IDentifier). | | ineligible_product_uuids | An array of a valid UUID (Universally Unique IDentifier). | | type | One of: 'account', 'admin', 'bundle', 'coupon', 'offset', 'package', 'reseller' |
|
| items | A positive integer value (i.e. 1 and up). | | price | An associative array containing the fields: |
| | | discountable | A monetary value, such as -$.05, 0.05, or -5.00 | | non_discountable | A monetary value, such as -$.05, 0.05, or -5.00 | | total | A monetary value, such as -$.05, 0.05, or -5.00 |
|
|
| items | An array of associative arrays containing |
| | | cost | An associative array containing the fields: |
| | | discountable | A monetary value, such as -$.05, 0.05, or -5.00 | | non_discountable | A monetary value, such as -$.05, 0.05, or -5.00 | | total | A monetary value, such as -$.05, 0.05, or -5.00 |
|
| discounts | An array of associative arrays containing |
| | | amount | A floating-point value. | | amount_off | A monetary value, such as -$.05, 0.05, or -5.00 | | discount_uuid | A valid UUID (Universally Unique IDentifier). | | ineligible_product_uuids | An array of a valid UUID (Universally Unique IDentifier). | | type | One of: 'account', 'admin', 'bundle', 'coupon', 'offset', 'package', 'reseller' |
|
| price | An associative array containing the fields: |
| | | discountable | A monetary value, such as -$.05, 0.05, or -5.00 | | non_discountable | A monetary value, such as -$.05, 0.05, or -5.00 | | products | An array of associative arrays containing |
| | | base_price_discountable | A monetary value, such as -$.05, 0.05, or -5.00 | | base_price_non_discountable | A monetary value, such as -$.05, 0.05, or -5.00 | | discountable | A monetary value, such as -$.05, 0.05, or -5.00 | | non_discountable | A monetary value, such as -$.05, 0.05, or -5.00 | | product_code | A valid product code, at least 3 chars long, including at least one letter. | | product_uuid | A valid UUID (Universally Unique IDentifier). | | total | A monetary value, such as -$.05, 0.05, or -5.00 |
|
| total | A monetary value, such as -$.05, 0.05, or -5.00 |
|
|
| month_end | A positive integer value (i.e. 1 and up). | | month_start | A positive integer value (i.e. 1 and up). | | months | A positive integer value (i.e. 1 and up). | | occurrence | A positive integer value (i.e. 1 and up). |
|
| cycle | A valid billing cycle (monthly, quarterly, biannually, yearly, or biennially). |
|
| credits | An array of associative arrays containing |
| | | amount_off | A monetary value, such as -$.05, 0.05, or -5.00 | | | item_uuid | A valid UUID (Universally Unique IDentifier). | * Optional | | month_end | A positive integer value (i.e. 1 and up). | | | month_start | A positive integer value (i.e. 1 and up). | | | months | A positive integer value (i.e. 1 and up). | |
|
| summary | An associative array containing the fields: |
| | | cart | An associative array containing the fields: |
| | | amount_off_today | A monetary value, such as -$.05, 0.05, or -5.00 | | cost | A monetary value, such as -$.05, 0.05, or -5.00 | | due_today | A monetary value, such as -$.05, 0.05, or -5.00 | | price | A monetary value, such as -$.05, 0.05, or -5.00 |
|
| items | An array of associative arrays containing |
| | | cost | A monetary value, such as -$.05, 0.05, or -5.00 | | cycle | A valid billing cycle (monthly, quarterly, biannually, yearly, or biennially). | | discounts | An array of associative arrays containing |
| | | amount | A monetary value, such as -$.05, 0.05, or -5.00 | | amount_off_today | A monetary value, such as -$.05, 0.05, or -5.00 | | discount_uuid | A valid UUID (Universally Unique IDentifier). | | owner | A string of text, containing no newlines or other control characters. | | repetitions | A non-negative integer value (i.e. 0 and up). | | type | One of: 'account', 'admin', 'bundle', 'coupon', 'offset', 'package', 'reseller' |
|
| item_uuid | A valid UUID (Universally Unique IDentifier). | | price | A monetary value, such as -$.05, 0.05, or -5.00 |
|
|
| timeline | An array of associative arrays containing |
| | | cost | A monetary value, such as -$.05, 0.05, or -5.00 | | cycles | An array of a valid billing cycle (monthly, quarterly, biannually, yearly, or biennially). | | month | A positive integer value (i.e. 1 and up). | | price | A monetary value, such as -$.05, 0.05, or -5.00 |
|
|
| updated | A valid date and time in YYYY-MM-DD HH:MM:SS format, or a DateTime object. | |
| uuid | A valid UUID (Universally Unique IDentifier). | |
| version | A positive integer value (i.e. 1 and up). | |
