Documentation

PaySnap stack


PaySnap Base

This Stack Element must be on all pages that will have PaySnap items or View Cart buttons. This stack will establish the settings for how your page passes data to PayPal.

Required PayPal Settings:

  • PayPal Email
    The email address you use to receive PayPal payments. Generally the email address you use to login to your PayPal account.
  • Currency
    Select the currency you will be advertising your products with.
  • Language
    Select the desired language that PayPal hosted checkout pages should be displayed in (note this setting affects ONLY PayPal checkout pages, it does not translate your Rapidweaver page)
  • Return URL
    Address of the page you would like buyers sent to after a successful transaction.
  • Cancel URL
    Address of the page you would like buyers sent to after a canceled transaction.

Optional PayPal Settings:

  • Notify URL
    If you need to use PayPal IPN to post transaction results to your own server, provide that url here (not common).
  • Weight Unit
    If you use weight based shipping rules (established in your PayPal Account Profile for US based merchants) select your desired unit of measure [Pounds or Kilograms]
  • Cart Handling
    If you wish to add a handling fee in addition to your shipping, enter the desired amount here.
  • Cart Weight
    Used to define a flat weight to the entire cart.
  • Cart Tax
    Used to define a flat tax amount for the entire cart.
  • Custom
    Any value you wish to pass back to the Notify IPN page.
  • Use Sandbox
    If you will be testing with a PayPal Sandbox account to test your pages in a non-transactional environment, enable this option and be sure to enter your Sandbox account as the PayPal Email address.
  • Empty Cart at Checkout
    When enabled, the buyer's cart will be empty once checkout is complete. If they return to your site AFTER completing a purchase, the buyer will have an empty cart.
  • Cart Expiration
    Define how long (in hours) you'd like a cart session to remain active. If a visitor comes to your site and adds product to their cart, then leaves your site, their cart session will remain active and available to them upon their return to your site for the amount of time you specify.
  • Shipping
    Define how PayPal will handle shipping addresses:
    • Prompt (No Require) - this setting allows the user to provide a shipping address but does not require them to do so.
    • No Prompt - this setting does not allow the user to provide a shipping address. This option is generally used in conjunction with non-shipped items (digital goods, services, etc)
    • Prompt (Require) - Prompt the buyer for their shipping address and do not allow them to proceed through checkout without providing it.

Cart Text

You can customize all of the text in the cart window.

  • OK Button
    When a user deletes an item from the cart a confirm/cancel dialog is displayed. By default the confirm button is labeled "Ok". To change this label, enter custom text here.
  • Cancel Button
    When a user deletes an item from the cart a confirm/cancel dialog is displayed. By default the cancel button is labeled "Cancel". To change this label, enter custom text here.
  • Cart Title
    Text located at the top of the cart (to the right of the (X) Close symbol).
  • Checkout
    Text to initiate checkout at PayPal. Note that use of #paypal# in this field will insert the official PayPal logo.
  • Cart Footer
    Text located at the very bottom of the cart window.
  • Confirm Delete
    When a user deletes an item from the cart a confirm/cancel dialog is displayed. By default the instructional text displayed above the buttons is "Delete this item?" To change this label, enter custom text here.
  • Total Warning
    If a customer tries to checkout with an empty cart the text you enter here will be displayed.
  • Empty Cart
    Text displayed when a user has a cart containing no products.

Cart Style

  • Use the provided color pickers and font size tools to style the display of products and item details. Even better, with version 2 we've provided a Preview tool. Style the cart as desired, then click the Preview checkbox to see a preview of your style changes. Note that style settings will be applied to ALL PaySnap stacks on the same page as this instance of PaySnap Base. Some stacks allow you to individually override these style settings on a per-item basis.

PaySnap Base

  • If requested by our support department, enable Debug Mode, then Preview your page. The resulting Debug report can help us troubleshoot your page.

PaySnap Button

Add the PaySnap Button Stack wherever you'd like to place an Add to Cart Button or a View Cart button. Keep in mind that Add To Cart buttons must be placed INSIDE a PaySnap Item stack. View Cart buttons can be placed on any Stacks page that ALSO contains a PaySnap Base stack. The Button stack gives you a great deal of flexibility in designing your buttons:

  • Button Type
    Select the action the button should perform. Add to Cart or View Cart.
  • Title (Value)
    The text that will appear on the button if you utilize a plain style button.
  • Disabled
    Use this option to leave a product on your page but DISABLE its Add To Cart function. This can be used when an item is out of stock or is not currently available but you want to leave product information available on your page. If the button is DISABLED, users can not utilize the button to add *this* product to their cart.
  • Button Style
    We offer predesigned buttons you can use in Small and Large sizes. You can also use a Plain (generic browser style) button with custom text (designated in the Title field above}.
    You also have the option of using a Custom Image (Select your appropriately sized custom image for this button in jpg, gif or png format.) or utilize the built in button builder to build your own styled button. Simply select your own size and color scheme and add our optional icons to the button. A preview of your custom button is shown in the content area of the button stack.

More Details

This stack is a lightbox stack that you can use to provide additional product information and images. When you add this stack, you'll need to drag in a stack element capable of displaying the content you'd like. For example, you may want to drag in a 2-column stack to setup a nice column display, then drag in a text stack in the left column and an image stack in the right column so you can display text and image horizontally. You can drag in most any stack you like as long as it's compatible with the Fancybox jQuery script (some stacks utilizing mootools or other frameworks may not work inside this stack - all of the "stock" Stacks are fine, including multi column stacks, html, styled text and image stacks)

    • Link Text
      The text clicked to open the lightbox. By default this is "More Details..." Enter your own custom text here.
    • Image as Link
      If you wish to use an image file as the clickable link to open the lightbox, enable this checkbox and add your desired .jpg, .gif or .png image.
    • Box Title
      The lighbox's title is displayed underneath.
    • Full Scren
      When enabled, the content in the lightbox modal will scale to the full size of the browser window. Suited for users with a lot of images or item description content.
    • Box Width
      Width value (in pixels) of the lightbox. Be sure that the content you're placing in the lightbox (especially images) will format properly within this width.
    • Box Height
      Height value (in pixels) of the lightbox. Be sure that the content you're placing in the lightbox (especially images) will format properly within this width.

Custom Colors

      Enable to override your style selection in FormSnap Base and supply custom lightbox colors for just *this* instance of the More Details stack.

Title

    Use this color selector to choose a color title text within the lightbox.

PaySnap Item

This stack is essentially the product wrapper that all other stacks get nested within to create a full product. Add To Cart Buttons, More Details, Item Options, Price and Quantity Input stacks must all be placed WITHIN a PaySnap item stack - this associates those stacks with a particular product. There are only a few basic settings to this stack:

    • Item Name
      The name of the item. This product name is used in the Cart as well as on the PayPal checkout pages.
    • Item Number
      If you use a part number or SKU to identify product, enter it here. This is optional.
    • Item Price
      The numerical price of the item. This is a setting only and is used to pass the product's pricing information to the cart window as well as PayPal. To display the price of the item on the published page, be sure to add a PaySnap Price stack as well.
    • Editable Price
      Enable this checkbox to allow the buyer or donor to specify the own amount they'd like to pay or donate. Note that Editable Price items can not be used in conjunction with products that have options and prices assigned to those options.

Weight

    If you'll use weight based rules at PayPal, specify the item's weight here. Be sure to include only numeric values, no symbols or weight abbreviations (the scale of weight to be used is defined in the PaySnap Base stack)
  • Handling Fee
    If you wish to add a per-item handling fee to this product, enter your desired fee here (no currency symbols, ONLY a numeric value, ie, 5.50)
  • Tax
    If you wish to charge a flat tax amount on this item (and NOT use PayPal Tax Calculation Rules), enter the exact tax amount here. Enter as a currency value, not a percentage. (no currency symbols, ONLY a numeric value, ie, 3.21)

PaySnap - Item Option

If your product(s) have more that one available configuration, the Item Option stack is for you. Add an Item Option stack to a PaySnap Item to give your buyers product options. For example, a user selling a shirt may want to offer items in varying colors and sizes. You can even setup pricing variations on product options.

  • Option Type
    Select an input type for your option. You can choose a Dropdown menu, Radio button menu, Checkbox menu or a Text input to allow your buyers to enter a custom option/message in relation to the product.
  • Option Label
    Name of the option displayed next to the input. If you're soliciting a size selection from the user, you might label the field "Choose Your Size".
  • Option Count
    The number of selections that should be available in this option. (ie, Small, Medium, Large = 3 Options).
  • List Horizontal
    Radio button and checkbox inputs are displayed vertically by default. Enable this to display options horizontally.
  • Display Label
    When enabled, the Option Label (as defined above) will be displayed. If you don't need to display this, disable the Display Label checkbox.

PaySnap Price

The PaySnap Price stack is used only to display the item's price - note that you need to set the product price in the PaySnap Item stack as well.

  • Editable Price
    When this is enabled, buyer's can revise the price of the item. Useful for solicitation of donations or Name-Your-Own-Price items. Be sure to enable the Editable Price option in the item stack also.
  • Display Price
    Enter your product's price here. You may wish to include the currnecy symbol as part of this value (ie, $10.00 or £10.00, etc).
  • Color
    The price will be displayed in the color you choose with this color picker.
  • Size
    Font Size (in px) of the price.
  • Bold
    Enable to apply bold styling to the price text.

PaySnap Quantity Input

By default, PaySnap assumes all products have a quantity of 1. If you don't add a Quantity Input stack to your product, 1 unit will be added to the cart each time the user clicks the Add to Cart Button. If you want to give buyers the opportunity to add multiple units of a product to their cart, add this stack to your PaySnap Item.

  • Display Label
    If you wish to add a descriptive label to the quantity input box (for example, "Quantity" or "Qty", enable this checkbox and enter your desired quantity input label.
  • Default Value
    You can assign a default value to the quantity box. If you sell items that come in pairs, you may wish to make the default value 2.

Last Update: 2015-09-01T12:46:15Z