Payloom 3 - Placeholders(PRO)

Placeholders

General Order Placeholders

These variables contain non product specific data such as the clients name and transaction id etc.

Placeholder	Definition
#mc_gross#	Total amount paid
#total#	Total amount paid.
#totalnet#	Total Net amount paid.
#mc_currency#	Currency (e.g. USD, GBP etc).
#txn_id#	Transaction ID
#order_number#	Transaction ID
#first_name#	Customer's First Name
#last_name#	Customer's Last Name
#payer_business_name#	Business Name if Provided
#name#	Displays clients full name or business
#payer_email#	Customer's email address
#email#	Customer's email address
#telephone#	Customer's telephone number
#address_name#	Name to use with address
#address_street#	Address if provided
#address_city#	City if provided
#address_state#	State if provided
#address_zip#	Zip or Post code if provided
#address_country#	Country if provided
#address_country_code#	Two Letter Country code
#date#	Date in 22 May 2005 format
#payment_date#	Paypal transaction date
#tax#	Tax amount
#taxrate#	Tax rate
#fee#	Fee paid for transaction
#num_cart_items#	Number of items in Payloom cart
#payer_status#	Status of payers Paypal account
#address_status#	Status of payers address
#custom1#	Custom 1 Value
#custom2#	Custom 2 Value
#custom3#	Custom 3 Value
#custom4#	Custom 4 Value

---

Download Items Placeholders

These are the variables that you need to use to place the secure download links, product description etc in the email.

Placeholder	Definition
#description#	Description of product ordered
#filename#	Filename of the product
#link#	The secure URL of the product
#size#	The download size in a friendly format such as 11 KB or 1.23 MB
#expires#	Expiry time in friendly format or blank if no expiry. (e.g. 24 hours or 2 days etc)
#product#	Complete product details including size and link etc.

---

Ordered Items Placeholders

These variables can be used to display details about all items ordered including items that are not downloadable. This is useful if you want to create an invoice or receipt and are often used in the optional order notification or confirmation emails. These variables work within a block that gets repeated for each item ordered. To do this just create the text or html code that should be repeated and place <!--eachitemstart--> at the start of the section and <!--eachitemend--> at the end. Within this section you can use the following variables.

Placeholder	Definition
#item_number#	Item number or id
#quantity#	Quantity of item
#item_name#	Description of Item
#item_options#	Item Options
#description#	Description of Item
#itemprice#	Item Price
#itempricenet#	Item Net Price
#itemtotal#	Total Amount for this Item
#itemtax#	Tax Amount for this Item
#itemposition#	1 for the first item, 2 for the second, etc...

Unknown or physical products

It is possible to define a section of the template that is only displayed if any products ordered are not digital. such as physical products for example. Just surround the text or html section that should only be displayed in this case as follows:

<!--unknownstart-->
Some of the items you have ordered are not downloadable so will be shipped to you by Federal Express.
<!--unknownend-->

Also in a similar way you can ensure that the download section of your template is only visible if products are setup in Payloom. To do this use <!--knownstart--> and <!--knownend--> to surround that section.