1. Image(s)
    Specify the scaled or cropped size of the image that will be generated on the details page

  2. Name
    Enter the name of the item or service you wish to sell
  3. Product ID
    If you have an ID or tracking number for your item, enter it here. This field will be displayed to your customers at the time of payment, and will be shown in both the buyer’s and seller’s transaction details on the PayPal website - this may be a part number you or the product manufacturer use to designate this item. Use of this field may help your search engine ranking even if you don't necessarily need it, so consider using a part number.
  4. Tags
    Enter the name of the item or service you wish to sell
  5. Price
    Enter the price of the item you wish to sell. If you would like to allow customers to specify their own price paid for an item, enable the Customize checkbox. This is also useful for donation amounts instead of goods or services.
  6. Shipping
    The cost to ship this item. If you use shipping amounts in PayLoom the shipping price for all products will be added up at checkout.
    This will override what you have set in your PayPal account profile - do not use this field if you are using shipping rules in your PayPal profile. Applied one time per Cart line Item.
  7. Shipping2
    The cost of shipping each additional unit of this item. If this variable is omitted and profile-based shipping rates are configured, buyers are charged an amount according to the shipping methods they choose.
  8. Tax
    The tax AMOUNT you would like to charge for this item. ( i.e. 2.25 )
    By making the value 0.00, you could run a tax-free promotion on an item. This will override any tax rules set in your PayPal account profile - do not use this field if you are using tax rules in your PayPal profile.
  9. Weight
    Enter your product's weight if you use PayPal Shipping Rules based on weight. The weight type you enter here should correspond with the unit of weight specified in your PayPal account, ie, oz, lb, kg, etc.
    Used with PayPal only
  10. Handling
    If you wish to add a handling fee to this item, enter the handling charge amount here (ie, 5.50). Applied one time per Cart line Item.
  11. File ( PRO )
    Make the product digital by checking the "Downloadable" checkbox. If you want to use a remote URL, like an S3 link for example, then check the "Remote URL" checkbox. Otherwise, leave unchecked.
  12. File Path ( PRO )
    You will specify/choose the location of the file here. The "path" is dependent on whether you choose "Remote URL" (above) or not.
  13. Expires ( PRO )
    This is the number of minutes that you would like links for this product to be valid for. This can be any value from 1 minute to several years. If you don’t want the link to expire set it to 0. Expiry times are measured from the time when the link is created.
Back to top


  1. Brief Description
    A short description of the item you are selling. This is generally used in list views so keep it short. Use our built in WYSIWYG tools to modify text styles or add links to other products.
    HTML Allowed if checkbox enabled
  2. Long Description
    A Longer, more elaborate description of the item you are selling. This is used when user is viewing the detailed view. Use our built in WYSIWYG tools to modify text styles or add links to other products.
    HTML Allowed if checkbox enabled
Back to top


  1. Option fields let your customers specify options (such as size or color) for the items they purchase. Options can have price overrides - so you can have a product with a base price and then offer it with different configuration/price options

    To Setup A Product Option:

    • Click the + symbol in the Product Options page (top pane) to add an option.
    • Provide a title for the option. For example, Size or Color.
    • Choose the type of input the customer will use to selection options, you can use Select Menu, Radio Buttons, Text field (for user supplied options - more on this later), Checkboxes or Hidden.
    • If this option will have Price Overrides, enable the checkbox.
    • Now you need to setup the choices that will appear in the Option you just created. In the lower Option Choices pane, click the + symbol.
    • Next you'll define the values of the choices for this option. Enter a Choice Value and (if enabled) Price Override. For example, if you are selling T-Shirts, your Choice Values might be Small, Medium, Large and X-Large. If you charge $9.95 for your shirts and $2 additional for X-Large, you would enter 0.00 as the Price Override value for S, M and L and 2.00 as the Price Override for X-L.
    • This option is now complete. You can now start from the first step and add an additional option, for example, Color, if you want users to be able to select a size AND color for this product.
  2. CSV Import
    Import in any Comma Separate Value file to easily setup product options containing many choices. Format your code like the example below...

    South Carolina,SC

Back to top
  1. Header

    A short description of the item you are selling. This is generally used in list views so keep it short. Use our built in WYSIWYG tools to modify text styles or add links to other products.
    HTML Allowed if checkbox enabled
  2. Footer

    A Longer, more elaborate description of the item you are selling. This is used when user is viewing the detailed view. Use our built in WYSIWYG tools to modify text styles or add links to other products.
    HTML Allowed if checkbox enabled

Pro Features

  1. Settings

    1. Company Name
      Your company name as it will appear in the default email.
    2. Reply-To Email
      Your sales email address that will be used in emails. Ideally this email address should be on the same domain as your site.
    3. Web Site URL
      This is your website URL that will be used displayed in the default email.
    4. Link Key
      Should be set to a unique encryption key that is used to create secure download links. Any random word will do but you must keep this value secret.
    5. PDT Token
      see PayPal Setup
    6. Password
      The password used to enter the manual order form and view orders page.
    7. Folder Name
      Name that is obscure and that cannot be guessed. Your downloadable files will be stored here.
    8. Notification Email
      Payloom can send you, the seller, an email each time an order is received. Your can format this email however you like using the Notify Email Template.
    9. Copy of Order Email
      The address you want to receive copies of the order emails sent to clients. You can have several email addresses separated by commas if you wish
    10. Debug Email
      The address you want to receive detailed debug information related to your Payloom cart. You can have several email addresses separated by commas if you wish.
    11. Download Notify Email
      This setting will cause an email to be sent to you each time a download link is used. The email will let you know the original order number, email address item number, item description, filename, IP address, time of download and expiry time of the link.
    12. Error Email
      The address you want to receive error notices related to your Payloom cart. You can have several email addresses separated by commas if you wish.
    13. Timezone
      Default timezone that should be used with your shopping cart. A listing of properly formatted timezones can be found at
    14. Direct Order Button
      The text to be shown on the Direct Order Checkout button.
    15. Enable Direct Order Mode
      Allow customers to skip payment authorization and have order processed immediately. This is great for vendors accepting cash or check payments for their wares.
    16. HTML Formatted Email
      Specify if you want HTML formatted emails or Plain Text emails sent.

  2. MySQL

    Save your orders to a sepecifed MySQL database. You can then access the data via our provided backend interface OR using your own custom script/app.

    1. Save to MySQL Database
      Enable this feaure if you wish to have all orders saved to a MySQL database. Orders saved can later be viewed using the Pro Admin Page.
    2. Host Address
      IP or web adddress to your MySQL database server. The most common is "localhost", but check with your host if you are not sure.
    3. Username
      The username used to login to your MySQL server.
    4. Password
      The password used to login to your MySQL server.
    5. Database Name
      The name of the database you wish to use for saving orders to.
    6. Table Name
      The table name you wish to have setup for saving orders to.

  3. Security

    Lorem ipsum dolor sit amet, consectetur adipiscing elit. Phasellus ac magna non augue porttitor scelerisque ac id diam. Mauris elit velit, lobortis sed interdum at, vestibulum vitae libero. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

    Creating a Block...

    • Click the + symbol in the bottpm left corner to add a block.
    • Select the type of block, IP Address or Email Address.
    • Type in a value depending on the Type you chose in the step above. Please use valid IP and Email address formatting.
    • When you have finished adding blocks, then use the Set... button at the bottom of the page to assign the Block Page the blocked user will see when they are redirected from downloading your product(s).

  4. Misc

    Error Messages

    1. Default Error
      Generic error message that is shown when errors not assigned occur.
    2. Wrong Amount
      Error shown when the total amount fails to match the prices set in Payloom.
    3. Transaction Not Complete
      The message shown when a transaction ( you guessed it ) does not have a status of Complete.
    4. Download Permission Denied
      The name of the database you wish to use for saving orders to.
    5. Link Expired
      Message that is shown when the download link has expired.

  5. Templates

    1. Notify Email
      Template used for emails sent to seller/vendor.
    2. Order Email
      Template used for emails sent to the customer.
    3. Manual Email
      Template used for order emails sent using the Manual/Test Order Form found on the Pro Admin Page.
    4. Return Page
      Template used for the return page your customers see after a successful order. This will contain any download links if you are selling digital goods.
    5. Download Page
      Template used for display page during download. This is your basic "Download in the Background" page. There may be times when the automatic download will not begin (because of browser security restrictions etc) in which case you can use the template variable #link# to include the link in the page.
    6. Error Page
      Template used for your own error page to match the rest of your site and insert into it a variable placeholder that will be replaced with the error message at run time. To do this simply insert #message# in the appropriate place inside your template.

  6. Extra Fields

    1. Show Extra Fields at Checkout
      Enablig this feature will add form inputs the customer can fill in at checkout. This is great for gathering additional information from the customer.
    2. First Name - Telephone
      Enable/Disable which input fields you would like displayed at checkout. You can also enter the localized text value that the user will see for each field, as well as, mark if the field needs to be required.
    3. Custom 1 - 4
      Same as above , but these will contain any custom data you wish to gather at checkout.
    4. Placeholders
      The placeholder text that will be included in the Optional and Required text input fields.
    5. Validation Error
      Error text that is shown when a Required or Email input is not valid.

  7. Stripe™

    1. Enable Stripe
      Enabling this will display a button at checkout that will initiate a Stripe ( Credit Card ) button at checkout.
    2. Secret Key
      Your secret API key (Test or Live).
    3. Publishable Key
      Your publishable API key (Test or Live).
    4. Description
      A description of the product or service being purchased.
    5. Panel Label
      The label of the payment button in the Checkout form (e.g. “Subscribe”, “Pay {{amount}}”, etc.). If you include {{amount}}, it will be replaced by the provided amount. Otherwise, the amount will be appended to the end of your label.
    6. Button Text
      The text to be shown on the default blue button.
    7. Image
      A square image of your brand or product. The recommended minimum size is 128x128px.
    8. Requires Zip Code
      Specify whether Checkout should validate the billing ZIP code.
    9. Accept Bitcoin
      Specify whether to accept Bitcoin in Checkout.
    10. Allow Remember Me
      Specify whether to include the option to "Remember Me" for future purchases.

  8. Pro Admin Page

    There maybe times when you wish to send a client the download links manually. Perhaps when there is a problem with payment, the original email is not received or because you wish to allow evaluation before purchase. The Pro Admin Page can be used to send the download links manually in this case.

    The Pro Admin Page also gives you the option to View Orders saved to MySQL database ( if enabled ).

    To display the Pro Admin Page open your browser and go to URL similar to:

Payloom Settings ( Page Inspector )

There are a few VERY important bits of information you need to provide on the Page Inspector for EACH PayLoom page on your site. Click on the Inspector icon in the lower right hand corner of your PayLoom page to open the Page Inspector. All of the really important stuff is located on the PayPal tab of the Inspector:

PayPal Settings

  1. PayPal Email Account
    This is probably the single most important field you'll fill out to setup PayLoom! The email address you enter in this field should be the email account you've configured to RECEIVE PayPal payments. If you do not enter your PayPal verified email address here, PayLoom generated pages will not be associated with your account!
  2. Language
    This is the language that the PayPal Shopping Cart will be displayed in. Does not affect your PayLoom pages but affect language once the customer is transferred to PayPal for final checkout.
  3. Payment Success URL
    The URL or Page to which PayPal redirects buyers' browser after they complete their payments.
    This setting ignored when using Pro Features.
  4. Payment Canceled URL
    A URL or Page to which PayPal redirects the buyers' browsers if they cancel checkout before completing their payments.
  5. Payment Notify (IPN) URL
    The URL or Page to which PayPal posts information about the payment, in the form of Instant Payment Notification messages. If you don't know what IPN is, you can probably leave this field empty.
    This setting ignored when using Pro Features.
  6. Tax
    Cart-wide tax, overriding any individual item tax values.
  7. Weight
    If profile-based shipping rates are configured with a basis of weight, PayPal uses this value to calculate the shipping charges for the payment. This value overrides the weight values of individual items. Allowable values are decimals numbers, with 2 significant digits to the right of the decimal point.
  8. Handling
    Handling charges. This variable is not quantity-specific. The same handling cost applies, regardless of the number of items on the order. Default – No handling charges are included.
  9. Weight Unit
    The unit of measure if Weight is specified. Allowable values are: lbs and kgs The default value is lbs.
  10. Custom
    Pass-through variable for your own tracking purposes, which buyers do not see. Default – No variable is passed back to you.
  11. Shipping
    1. Prompt ( No Require ) - prompt for an address, but do not require one
    2. No Prompt - do not prompt for an address
    3. Prompt ( Require ) - prompt for an address, and require one
    The default is to Prompt, but not require.
  12. Use PayPal Sandbox
    Use the PayPal Sandbox server for testing prior to going live with your cart. This is an advanced setting and should only be used if you know what you are doing.
  13. Enable PayPal
    Decide if you want to enable PayPal at Checkout. Remember that you will need to enable at least one checkout type ( PayPal, Stripe PRO and Direct PRO ) or no Checkout button will be shown.

Back to top

Style Settings

  1. Layout

    • Default Layout
      Default layout shown when page is first loaded. ( select one )
      • Grid - grid based layout with containers of equal height and width.
      • Packed - same as above but heights are variable. Similar to Pinterest layout.
      • List - Basic lists tyle layour similar to a table view.
    • Available Layouts
      Layouts available to the user in the Cart Toolbar.
      • Grid
      • Packed ( looks the same as grid when view on smaller devices )
      • List
    • Grid Width
      Percentage based width the Grid and Packed layout will use when building the layout.
    • Border
      Set the width and color of borders used on grid/packed items, shopping cart and product image box.
    • Background
      Set the background color used on grid/packed items, shopping cart and product image box.
    • Footer Background
      Set the background color of footers used in grid/packed item, shopping cart and product image box.
  2. Toolbar

    • Border
      Color of toolbar border.
    • Background
      Color of toolbar background (default) and background (hover).
    • Text/Icons
      Color of toolbar text/icons (default) and text/icons (hover).
    • Placeholder
      Color of toolbar filter placeholder.
  3. Primary Buttons

    Style setting for all Primary Buttons. Primary buttons include "Add to Cart" and "Checkout" buttons.
    • Background
      Color of background (default) and background (hover).
    • Border
      Color of border (default) and border (hover).
    • Text
      Color of text (default) and text (hover).
  4. Secondary Buttons

    Style setting for all Secondary Buttons. Secondary buttons include "View Details", "Continue Shopping" and "Cart" buttons.
    • Background
      Color of background (default) and background (hover).
    • Border
      Color of border (default) and border (hover).
    • Text
      Color of text (default) and text (hover).
  5. Button Borders / Radius

    • Width
      Width in pixels of button borders.
    • Radius
      Radius in pixels of button borders.
  6. Button padding

    Padding used in all buttons ( including toolbar buttons ).
    • Vertical
      Padding in pixels of button top and bottom.
    • Horizontal
      Padding in pixels of button left and right.
  7. Font Size
    Font size used for all buttons ( including toolbar buttons ).
  8. Misc

    • Price / Total Color
      Color used for item prices and cart grand total.

Back to top

Text Settings

These setting give you the ability to personalize all the text that is used throughout your Payloom 3 Shopping Cart.

  1. Checkout
    Text used on Checkout Button. Available placeholders for this button are #paypal-logo# and #paypal-icon#. When you use a placeholder a special icon will replace it. Give it a try to see what we mean.
  2. View Details
    Used on buttons included with each product on the front page of Shopping Cart.
  3. Out of Stock
    Used on Add to Cart button displayed on product details page when the product is marked as Out of Stock.
  4. Add to Cart
    Used on Add to Cart button displayed on product details page.
  5. Cart Items
    Used on Cart Button in between the count badge and the total amount.
  6. Filter Results
    Used as placeholder text in the Search/Filter input field.
  7. Continue
    Used on Continue Shopping Buttons.
  8. Show All Filter
    Used on Show All menu item in quick sort dropdown.
  9. Processing
    Text displayed after the user clicks the Checkout Button.
  10. Empty Cart
    Text displayed on Cart Page when the cart is empty.
  11. Items Header
    Used as the Items header in the Cart table.
  12. Quantity Header
    Used as the Quantity header in the Cart table.
  13. Total Label
    Text used as the Label for Cart grand total.
  14. Delete
    Used as tooltip text when hovering over Delete icon in Cart table.

Back to top

Thumbnail Settings

  1. Thumb Image Settings
    The crop/scale and size settings you specify here will be applied to ALL image thumbnails on THIS PayLoom page.
  2. Background
    Change the background color of your product image.
  3. Padding
    Add padding to your product image.
  4. Border Radius ( Rounded Corners )
    Use this slider to control the image corner shape, rounded to square
  5. Border
    Add a border to your product. You can even adjust the thickness and color of it.
  6. Drop Shadow
    Add a drop shadow to the entire product image - the X and Y values control the shadow's offset.

Back to top

Misc Settings

  1. Empty Cart at Checkout
    If enabled, the customers cart will be purged when the Checkout button is clicked.
  2. Cart Expiration
    Number of hours Payloom will store the cart data before purging it.
  3. Currency
    This is the currency you will RECEIVE payments in and will also affect the currency symbol displayed on your PayLoom pages.
  4. Include Price with Tax
    When enabled the price of the product + tax will be displayed under the primary price. This is usually required to comply with various tax laws around the globe.
  5. Taxed Price Label
    The label shown predceding the Price Including Tax ( see above ).
  6. Debug Mode
    Enabling will tell script to show any errors and additional debug information. Do not use this when your cart is live and in production.

Back to top

Stacks Settings

There may come a time when you will want to include your Payloom 3 generated page into a Stacks page. Well we baked that goodness right into Payloom 3. It is super simple to execute too.

See instructions below....

  1. Open your Payloom 3 page.
  2. Preview the page so all the export paths get initiated.
  3. Open Page Inspector for Payloom 3
  4. Select the Stacks icon.
  5. Copy the Stacks URL
  6. Open your Stacks page and drag in the Payloom 3 Remote stack.
  7. Paste the Stacks URL from the plugin page into the Payloom 3 Page field of the stack.
  8. Publish your Stacks page to your web host in order to see the magic happen.
  9. That's it

Heads Up!
You may want to uncheck the "Show in navigation" checkbox in the Payloom "General Settings" Page Inspector tab.

PayPal Setup ( IPN and PDT )

Enable IPN

Click the Profile link at the Top of PayPal Overview page.

Click My Selling Tools in the left hand column under My Profile. Scroll down to the Getting paid and managing risk section ( you may have to expand it ) and click Update next to Instant payment notifications. Enable IPN and set the Notification URL to ( using your domain name of course ).

It should look something like this...

The IPN URL is called by Paypal each time an order is made and Payloom uses this call to send out the download email to the buyer. This happens even if the do not return to your site after making payment.

If you are already using IPN for another script then have no fear. Just leave the URL as you already have it. Payloom can override the default IPN URL when the customer submits their order. You do not need to do anything.

Enable Auto Return and PDT

Although Payloom will email the download links to the buyer immediately after paying it is a good idea to also return them to your site and provide the download links on a download page also. Payloom uses Paypal's Auto Return and PDT to accomplish this.

Return to the Profile page and click the My Selling Tools link in the left column under My Profile. In the Selling online section ( you may have to expand it ) and click Update next to Website preferences.

Enable Auto Return and set the URL to be (setting your site)

Now scroll down the page a little and enable Payment Data Transfer. Click Save to store the settings. Once enabled it should look something like this.

Finally copy to the clipboard the long Identity Token that Paypal displays after you enable PDT. This needs to be added to your Pro Settings in the space provided.


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:

Some of the items you have ordered are not downloadable so will be shipped to you by Federal Express.

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.

Frequently Asked Questions

Answers to frequently asked questions.

  1. Can I use Shipping and Taxes with Stripe or Direct Order?

    Yes. Shipping and Tax values will be saved to MySQL database and used to calculate final Grand Total for ALL orders.

  2. Does Payloom 3 offer Discounts?

    No. At this time Payloom 3 does not offer discount support. Maybe in a future update, but not in current version.

  3. Does Payloom 3 support EU VAT Taxing?

    Yes , If you use PayPal, then you can setup your International Sales Tax Rates on the PayPal site.
    No, if using Stripe or Direct Order checkout.

No results matching your search.