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. To have one site wide setup, we recommend placing the Base stack in a Stacks partial you can use on all pages, but still update in a single location. 😉
TOC
Global Settings:
- Currency
Select the currency you will be advertising your products with. - 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.
PayPal Settings:
- Enable PayPal
Check if you wish to offer PayPal payments in your shopping cart. - Use Sandbox
Checking this will force your shopping cart to use the PayPal sandbox server. The PayPal sandbox is a self-contained, virtual testing environment that mimics the live PayPal production environment. The sandbox provides a shielded space where you can initiate and watch while your apps process PayPal API requests without touching any live PayPal accounts. For more information click here. - PayPal Email
The email address you use to receive PayPal payments. Generally the email address you use to login to your PayPal account. - 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) - 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. - 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.
Stripe Settings
- Enable Stripe
Check if you wish to offer Stripe ( Credit Card ) payments in your shopping cart. - Publishable Key
The Publishable API key is meant solely to identify your account with Stripe, it isn't secret. In other words, they can safely be published in places like your RapidWeaver web projects. - Secret Key
The Secret API key should be kept confidential and only stored on your own servers. Your account’s secret API key can perform any API request to Stripe without restriction. PaySnap only uses this value server-side. The end-user never comes in contact with this value.
You can find your API keys by following instructions in this article.
Locate API keys in the Dashboard
Optional Settings
- Quantity Type
Within the shopping cart you can display the quantity input in two different ways, via TEXT or STEPPER.- TEXT displays an input the customer can type into.
- STEPPER is similar to TEXT, but adds + and - buttons to "step" the count up and down without using a keyboard.
- 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. - 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. - Open Cart on Add
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. - Debug Mode
When enabled, your server will output extra content to help investigate any issues occurring on the server on in browser. THIS IS NOT RECOMMENDED ON LIVE SITE.
Cart Text
You can customize all of the text in the cart window.
- Cart Title
Text located at the top of the shopping cart.
EXAMPLE: My Cart
- Cart Total
Label for dynamic cart total amount located at top of shopping cart.
EXAMPLE: Total Amount
- Cart Total Items
Trailing text placed behind the total quantity of items in shopping cart.
EXAMPLE: 12 item(s) in cart
- PayPal Checkout
Text used for PayPal checkout button. Feel free to use some FontAwesome code in there if you like.EXAMPLE: <i class="fa fa-paypal"></i> Pay with PayPal
- Stripe Checkout
Text used for Stripe ( Credit Card ) checkout button. Feel free to use some FontAwesome code in there if you like.EXAMPLE: <i class="fa fa-credit-card"></i> Pay with Credit Card
- Cart Footer
Text located at the very bottom of the cart window.
EXAMPLE: Powered by PaySnap
- Total Warning
If a customer tries to checkout with an empty cart the text you enter here will be displayed.
EXAMPLE: Checkout not possible with zero total.
- Empty Cart
Text displayed when a user has a cart containing no products.
EXAMPLE: Cart is Empty!
Cart Style
- Use the provided color pickers and font size tools to style the display of products and item details. Even better, use the Preview toggle to see your changes live inside Edit Mode. 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.
0 Comments