Using the remote carting function, there is a wealth of information you can pass to Spark Pay Online Stores to manipulate and customize your selling experience. This article contains a list of all the pieces of information Spark Pay Online Stores accept when using remote carting along with a description of what the field does, what type of information is expected to be passed, as well as any synonymous paramters that can be used.
Item ID - itemid (int)
Scope: Item
Description: When this is specified, the store attempts to lookup an existing product. If one is not found, a phantom item ith this id is created.
Synonyms: None
Item Name - itemname (string)
Scope: Item
Description: Sets the name of the item in the cart.
Synonyms: product, product[]
Quantity - qty (int)
Scope: Item
Description: Defines the quantity of the specified item to add to the cart.
Synonyms: quantity
Item URL - itemurl (string)
Scope: Item
Description: Specifies the url to return the user to when clicking on the item in the cart on your Americommerce Spark Pay Online Stores /AmeriCart site.
Synonyms: None
Item Number - itemnr (string)
Scope: Item
Description: Defines the item number of the item. If no item id is provided, this field will be used as a lookup to find an existing item. If no item is found, a phantom item with this item number is created.
Synonyms: itemnbr
Price - price (decimal)
Scope: Item
Description: Sets the price of the item per unit. For example, an item with a price of $5 and quantity of 3 would charge the customer $15.
Synonyms: productpr*
*The productpr field combines the price with other information - {info}:{price}.
Image URL - imageurl (string)
Scope: Item
Description: Defines the url of the image for the item in the cart.
Synonyms: None
No Tax - notax (bool)
Scope: Item Description: Specifies whether or not to charge tax for the item. Synonyms: None Legacy: The legacy AmeriCart equivalent of this tag is =TF=. For more information on the legacy flags, view the KnowledgeCenter Article on Product Modifier Tags. Weight - weight (decimal)
Scope: Item
Description: Sets the weight of the item. Mostly used for shipping charge calculations.
Synonyms: None
Is Hidden - hidden (bool)
Scope: Item
Description: Specifies whether the item is hidden. Default is false.
Synonyms: None
Item Type - itemtype (string)
Scope: Item Description: This field is used to specify the type of item being passed. Supported values include:
- Normal
- Discount
- DiscountFlat
- DiscountChange
- Info
- Shipping
- Tax
- Error
This is most ofton used in conjunction with the SpecialItemData field. Synonyms: None Special Item Data - specialitemdata (string)
Scope: Item Description: The information that should be passed in this field is determined by the Product Type field. The following is a list of available values for the Item Type field. Based on which one is used, the Special Item Data field should contain different information. The information to use is as follows:
- Normal - Leave the field blank. If anything is specified, it will not be used.
- Discount - Applies a percentage discount to the order. SpecialItemData in this case will be the percentage amount to subtract from the order. Must be a whole number, 50 for a 50% discount, etc. If this is used, the item description will be displayed as the name of the discount.
- DiscountFlat - Applies a flat dollar amount discount to the order. SpecialItemData in this case will be the dollar amount to subtract from the order total, so 50 for $50 dollars, 24.75, etc. If this is used, the item description will be displayed as the name of the discount.
- DiscountChange - allows you to actually specify embedded quantity discounts (also known as quantity break pricing) for a cart item. In this case, the SpecialItemData contains the formula for the quantity breaks. This also differs slightly in that this item type is applied to actual cart items. So, instead of adding a separate cart item, this should be used to flag an actual cart item as the DiscountChange type if you want to embed quantity discounts.
- Info - This is an arbitrary message displayed only on the Order Edit or Order View screen.
- Shipping - Allows you to specify a formula that overrides the normal shipping calculating for this cart. In this case SpecialItemData contains the formula. The Description of the item will be the name of the method.
- Tax - Specify a tax override for the cart. For example, pass .07 will charge 7% tax on the order.
- Error - This is used to display an error to the customer. It is displayed as error text to the customer during the checkout process.
Synonyms: None Legacy: The legacy AmeriCart equivalent of this tag is =AS=. For more information on the legacy flags, view the KnowledgeCenter Article on Product Modifier Tags. Personalize - personalize (string)
Scope: Item
Description: Pipe delimited personalization option list. More limited than personalization.
Synonyms: personalization
Personalization - personalization (string)
Scope: Item
Description: Pipe delimited personalization option list in the same order as the pre-defined product personalizations.
Synonyms: personalize
Non Shipping Item - nonshippingitem (bool)
Scope: Item
Description: Specifies whether an item is shipping or not. If false, it will not be used for shipping charge calculations.
Synonyms: None
Admin Comments - admincomments (string)
Scope: Item
Description: The information in this field will appear on the order as a private comment about the item. Can be used for notes on the item.
Synonyms: None
Mfg Item Number - mfgitemnr (string)
Scope: Item
Description: Sets the manufacturer's item number. Useful when drop-shipping and with warehouse emails.
Synonyms: manufactureritemnr, manufactureritemnumber
Warehouse ID - warehouseid (int)
Scope: Item
Description: Specifies which wharehouse the item is coming from. The is used to determine the "ships from" address in the shipping charge calculation. It is also the warehouse that gets the warehouse notifications email, if enabled.
Synonyms: None
Variant ID - variantid (int)
Scope: Item
Description: Pipe delimited variant id list. Variants in this list will be selected for the product.
Synonyms: None
Variant - variant (string)
Scope: Item
Description: Pipe delimited variant name list (these values must match the labels of the variants if using an existing product). Variants in this list will be selected for the product.
Synonyms: None
Remove Cart ID - removecartid (int)
Scope: Cart
Description: Removes particular items from the cart by cart item ID, pipe delimited.
Synonyms: None
Child Items In Personalize - childitemsinpersonalize (bool)
Scope: Cart
Description: Turns on dynamic (custom) kitting.
Synonyms: None
Cart ID - cartid (int)
Scope: Cart*
Description: Used for dynamic kitting to update an existing cart row.
Synonyms: None
Child items - childitems (string)
Scope: Cart*
Description: Pipe delimited special format field - {id}_{qty} used by dynamic kitting to set child items.
Synonyms: None
Return URL - return (string)
Scope: Cart
Description: URL to return to, unless overridden by the item URL.
Synonyms: None
SSL - ssl (bool)
Scope: Cart
Description: Enables SSL for AddToCart.aspx.
Synonyms: None
Description - desc (string)
Scope: Item
Description: Sets the item description in the cart.
Synonyms: description
Max Quantity - maxqty (int)
Scope: Item Description: Sets the maximum quantity for this item. Synonyms: NoneLegacy: The legacy AmeriCart equivalent of this tag is =MX1=. For more information on the legacy flags, view the KnowledgeCenter Article on Product Modifier Tags. Insurance Cost - insurance (decimal)
Scope: Item
Description: Adds an additional insurance cost to the item, if specified.
Synonyms: None
Unit of Measure - unit (string)
Scope: Item
Description: Sets the unit of measure. For example, "lbs" or "kgs".
Synonyms: None
No Shipping Charges - itemshipsfree (bool)
Scope: Item Description: Specifies that this item ships for free. Synonyms: NoneLegacy: The legacy AmeriCart equivalent of this tag is =SF=. For more information on the legacy flags, view the KnowledgeCenter Article on Product Modifier Tags. Is In Package Deal - pkgdeal (bool)
Scope: Item Description: Item cannot be removed from the cart unless the cart is cleared. Synonyms: NoneLegacy: The legacy AmeriCart equivalent of this tag is =NA=. For more information on the legacy flags, view the KnowledgeCenter Article on Product Modifier Tags. Remove If Quantity Modified - lockqty (bool)
Scope: Item Description: Removes the item from the cart if the quantity is changed. Synonyms: NoneLegacy: The legacy AmeriCart equivalent of this tag is =CA=. For more information on the legacy flags, view the KnowledgeCenter Article on Product Modifier Tags. Order Ships for Free - ordershipsfree (bool)
Scope: Item Description: Specifies that the order ships for free. Synonyms: NoneLegacy: The legacy AmeriCart equivalent of this tag is =SFO=. For more information on the legacy flags, view the KnowledgeCenter Article on Product Modifier Tags. Exempt From Min Order Amount - minorderexempt (bool)
Scope: Item Description: Them item is not taken in consideration when calculating the minimum order amount. Synonyms: NoneLegacy: The legacy AmeriCart equivalent of this tag is =NSOF=. For more information on the legacy flags, view the KnowledgeCenter Article on Product Modifier Tags. Force Shipping Charges - forceshipping (bool)
Scope: Item Description: Forces shipping charges on the item. Synonyms: NoneLegacy: The legacy AmeriCart equivalent of this tag is =DNSF=. For more information on the legacy flags, view the KnowledgeCenter Article on Product Modifier Tags. Use Override Qty - useqtyoverride (bool)
Scope: Item
Description: If true, the value provided in the qtyoverride parameter will be used. If false, it will not regardless of whether it is set or not.
Synonyms: None
Quantity Override - qtyoverride (bool)
Scope: Cart
Description: Specifies the quantity override (op99 from AmeriCart) for the item. This is used to disallow customers from changing the quantity of an item. Pricing and shipping will be calcualted based on this value if the useqtyoverride parameter is passed as true.
Synonyms: None
Do Not Discount - nodiscount (bool)
Scope: Item Description: Flags the item as ineligible for discounts. Synonyms: NoneLegacy: The legacy AmeriCart equivalent of this tag is =DF=. For more information on the legacy flags, view the KnowledgeCenter Article on Product Modifier Tags. Own Box - ownbox (bool)
Scope: Item Description: Specifies that the item ships separately. Synonyms: NoneLegacy: The legacy AmeriCart equivalent of this tag is =SHIPSEP=. For more information on the legacy flags, view the KnowledgeCenter Article on Product Modifier Tags. Shipping Override - shippingoverride (decimal)
Scope: Item Description: Overrides the shipping price for the order when this item is in the cart. Synonyms: NoneLegacy: The legacy AmeriCart equivalent of this tag is =SS=. For more information on the legacy flags, view the KnowledgeCenter Article on Product Modifier Tags. Append to Descriptions - appendtodesc (string)
Scope: Cart
Description: Appends text to all descriptions, op98 from AmeriCart.
Synonyms: None
Clear Cart - clear (bool)
Scope: Cart
Description: Clears the cart before performing any additional operations.
Synonyms: killcart
Continue Shopping URL - continueshopping (string)
Scope: Cart
Description: Overrides the URL that the cart's "Continue Shopping" redirects the user to.
Synonyms: None
ForceChargeCard - forcecardcharge (string)
Scope: Cart
Description: When an item is added to cart using remote carting and the ForceChargeCard parameter is set to true (e.g. forcechargecard=1), then the subsequent checkout transaction will charge the shoppers credit card even if the gateway is configured to authorize only. This only persists until the next add to cart request, so if another item is added to cart and forcechargecard is not explicitly set, it will revert to the normal configured gateway behavior.
Synonyms: None