Custom Messages

Modified on Sun, 24 Sep, 2023 at 4:47 PM

Can I display order values inside custom messages?

Yes. Use the replacement codes below to insert order values into custom messages.

CODE	DESCRIPTION
[ORDER_NUM]	Order Number
[INVNUM]	Order Invoice Number
[SUB_TOTAL]	Cost of order before discounts and other charges
[SALES_TAX]	Sales tax
[SHIPPING_CHARGE]	Shipping charge
[SHIPPING_METHOD]	Shipping method
[COD_CHARGE]	COD charge
[MINIMUM_ORDER_CHARGE]	Minimum order charge
[VOLUME_DISCOUNT]	Volume discount amount
[PROMO_DISCOUNT]	Promotional discount amount
[PROMO_DISCOUNT_CODE]	Promotional discount code
[GRAND_TOTAL]	Cost of order after discounts and other charges
[B_FNAME]	Customer Billing First Name
[B_LNAME]	Customer Billing Last Name
[B_ADDR1]	Customer Billing Address Line 1
[B_ADDR2]	Customer Billing Address Line 2
[B_CITY]	Customer Billing City
[B_STATE]	Customer Billing State
[B_ZIP]	Customer Billing Postal Code
[B_COUNTRY]	Customer Billing Country
[B_EMAIL]	Customer Billing Email Address
[IP_ADDR]	Customer IP Address
[USER1]	User defined field 1 value
[USER2]	User defined field 2 value
[USER3]	User defined field 3 value
[USER4]	User defined field 4 value
[USER5]	User defined field 5 value
[ITEMS]...[/ITEMS]	Items ordered. Replace ... with any of the item codes below.^*
[ITEM_NUM]	Starting at 1, continuing in sequence for each item.
[ITEM_NAME]	Item name
[ITEM_DESC]	Item description
[ITEM_UNIT_PRICE]	Item price
[ITEM_QTY]	Item quantity
[ITEM_TOTAL]	Item total (item price * item quantity)
[ITEM_FILE]	Item file (digital goods)

^* By default, item values are joined by commas. For example, if there were 3 products in an order with item names sku#1, sku#1, sku#3 and your tracking coding contained [ITEMS][ITEM_NAME][/ITEMS], the output would be sku#1,sku#1,sku#3. To change the character that joins item values, use [ITEMS join=:][ITEM_NAME][/ITEMS] (this would produce sku#1:sku#1:sku#3).

For example, if you wanted your customers to agree to terms before submitting their order, you could enter the following message in the "Review Order" box.

[B_FNAME] [B_LNAME], by submitting your order, you agree to the following terms and conditions: We will not accept returns or exchanges after 30 days from the date of purchase.

Can I only display text if the order subtotal exceeds a specific amount?

Yes. You will need to use the SUB_TOTAL replacement code (see FAQ above for list of replacement codes).

For example, if you give away a t-shirt to customers who order $30 or more in merchandise, you could enter the following in a custom message.

[?SUB_TOTAL >= 30]Congratulations! You qualify for a FREE
t-shirt.[/?SUB_TOTAL]

Given the example above, you could also allow the customer to add the free t-shirt to their cart directly from the "Shopping Cart" page. To do this, follow the instructions below.

1. Click on Products > Add New in the top menu bar.
2. Enter the Name, Description and set Price to 0.00.
3. Click on the Save Button.
4. Under "Add to Cart Link 2" select and copy the HTML code.
5. Click on Settings > Custom Message.
6. Paste the HTML code into the Shopping Cart Page box.
7. Surround the HTML code with the SUB_TOTAL replacement codes.

For example:

[?SUB_TOTAL >= 30]Congratulations! You qualify for a FREE t-shirt
<form method="post" action="http://www.ewebcart.com/105/cart"><input type="hidden" name="item_id" value="1">
<input type="submit" name="add" value="Add to Cart"></form>
[/?SUB_TOTAL]

The "free t-shirt" message and "Add to Cart" button would only display if the order subtotal was at least $30. Please note that once the free item is added to the cart, it will not automatically be removed if subsequent changes cause the order subtotal to fall below $30.