View source for Enabling PayPal Website Payments Standard

[[File:PayPal logo.png|right|300px]]
'''Note: These instructions refer to a legacy PayPal service, and we recommend using the latest [[Enabing PayPal Checkout|PayPal Checkout]] service instead.'''

PayPal Website Payments Standard adds PayPal as a payment method in your checkout. The customer submits their order, and is redirected to the PayPal site to pay for their order.  At this point, the order is saved in your store with the payment status set to "Unpaid".

When they have paid, they are redirected back to your store, and your store marks the payment as received.

If you also want to enable PayPal Express, you will need to have a PayPal Business account. If you don't have a PayPal Business account, [https://www.paypal.com/au/webapps/mpp/merchant click here to sign up for a PayPal account], and then return to this page. 

== Part 1 - Configure your PayPal Account ==

When you've set up your PayPal account, follow the steps below to configure access to your PayPal account.

=== Include Shipping charges from your store ===
<gallery heights="200px" widths="200px" class="right">
File:Paypal account new 0.jpg|Configure PayPal Shipping
</gallery>
<gallery heights="200px" widths="200px" class="right">
File:Paypal account new 1.jpg|Configure PayPal Shipping
</gallery>
<gallery heights="200px" widths="200px" class="right">
File:Paypal account new 2.jpg|Allow Shipping Override
</gallery>

You need to configure PayPal to include the shipping charges that are calculated by your store.

# Log in to manage your PayPal account 
# Click on "Account settings" under Settings icon in the top menu.
# Click on "Shipping" under "Solutions & Services".
# In the "Shipping calculations" area, click "Update".
# Tick the box that says "Click here to allow transaction-based postage values to override the profile postage settings listed above (if profile settings are enabled)" 
# Click the "Save" button

=== Accept payments from customers without a PayPal account ===

<gallery heights="200px" widths="200px" class="right">
File:Paypal account new 3.jpg|Configure PayPal Website Preferences
</gallery>

<gallery heights="200px" widths="200px" class="right">
File:Paypal account new 4.jpg|Enable PayPal Account Optional
</gallery>

You can allow your customer to make payments using PayPal even if they don't have their own PayPal account.  Unfortunately all Paypal transactions processed in this method are not protected by PayPal's seller protection... so there is a risk of fraudulent transactions.

# Log in to manage your PayPal account 
# Click on "Account settings" under Settings icon in the top menu.
# Click on "Website payments" under "Solutions and Services".
# Click on "Update" under "Website preferences".
# Select the option that enables "PayPal Account Optional" 
# Click the "Save" button

=== Automatic Return at the end of the transaction ===

<gallery heights="200px" widths="200px" class="right">
File:Paypal account new 3.jpg|Configure PayPal Website Preferences
</gallery>

<gallery heights="200px" widths="200px" class="right">
File:Paypal account new 5.jpg|Enable Auto Return
</gallery>

Once a customer has made their payment using PayPal, a confirmation message is displayed and the customer is prompted to click a link to return to your store. If the customer does not click on this link, then any tracking code that you have installed will not be triggered and your site statistics may not correctly reflect the actual number of orders that have been processed.

You should enable the "Auto Return" feature in PayPal so that the customer is automatically redirected back to your store once the transaction has been completed.

# Log in to manage your PayPal account 
# Click on "Account settings" under Settings icon in the top menu.
# Click on "Website payments" under "Solutions & Services".
# Click "Update" on "Website preferences".
# Select the option that enables "Auto Return" 
# Enter your store's web address as the "Return URL". For example, ''<nowiki>http://mystore.spiffystores.com</nowiki>''.

=== Encrypted website payments ===
<gallery heights="200px" widths="200px" class="right">
File:Paypal account new 6.jpg|Turn off encrypted payments
</gallery>
The encrypted website payments option is only applicable when you use PayPal Payment Buttons. This payment method is not applicable to your Spiffy Store, as we use a direct, fully-encrypted method of connecting to PayPal which is not related to PayPal Payment Buttons. This means that you should set the ''Block non-encrypted website payment'' option to ''Off''.

# Log in to manage your PayPal account 
# Click on "Account settings" under Settings icon in the top menu.
# Click on "Website payments" under "Solutions & Services".
# Click "Update" on "Website preferences".
# Scroll down to "Encrypted website payments".
# Select "Off" for the "Block non-encrypted website payment" option.

== Part 2 - Enable PayPal Website Payments Standard in your Spiffy Store ==

Your PayPal account is now ready to connect to your Spiffy Store. You now need to follow the steps below to enable PayPal in your store. 

# Log in to your Spiffy Store Toolbox 
# Go to the "Checkout &amp; payment" page in the Preferences section 
# In the PayPal section at the top, choose "PayPal Website Payments Standard" 
# Type your PayPal account email into the "Account Email" field
# If you also want to enable PayPal Express, tick the box next to "Enable PayPal Express" and click the "Save" button.
## You will then be redirected to the PayPal site&hellip;
## If not already logged in, log in and then grant permissions to Spiffy Stores by clicking on the '''Grant Permission''' button.  
# Click the "Activate" button.

After you've followed the steps above, your Spiffy Store should now be set up to accept payments through PayPal Website Payments Standard. To verify that it's all working, go to your store, add a product to your cart.

The PayPal Express icon is displayed on your cart page.  Clicking this button takes you through the steps of paying with PayPal Express.  To view the PayPal Website payments Standard process,  click the "Checkout" button (not the PayPal button) and proceed through to the last page of the checkout. The PayPal option should appear at the bottom of page 2 of the checkout.

==Common Issues with PayPal==
As PayPal is an external payment method (the customer is redirected to the PayPal site), there can be a few issues that we have no control over...
=== PayPal Express is showing errors! ===

You may get an error when enabling PayPal Express or you may get an error when trying to make a test purchase using PayPal Express. The error could look something like this...

<pre>Unable to connect to PayPal Express
You do not have permissions to make this API call
Please contact store for assistance or continue using another payment method </pre>

If you encounter this error, please go to the "Preferences -> Checkout & payment" section of your Toolbox and DISABLE PAYPAL EXPRESS, save the changes, then edit it and try enabling it again.  You should be redirected to the PayPal site again, where you will need to log in and approve the API requests that appear on the PayPal site after you've logged in.

If this continues to occur after disabling and re-enabling PayPal Express, please log in to your PayPal account, and go to the "Profile -> My Selling Tools -> API Access Update -> Add or edit API permissions" page, and remove any permissions you've added for "Spiffy Internet Services", then log out of PayPal completely, and try enabling PayPal Express again in your Toolbox.

If you continue to have problems, please ensure that the email address that you have used for your PayPal account has been verified.

=== Help! The PayPal Express button isn't showing up! ===

If the button isn't there, you may need to add a little code to your theme to make it show up. Instructions on how to do this are below.

'''Adding the PayPal Express button to your cart page'''

# Log into your Spiffy Store Toolbox, and navigate to the "Theme editor" page
# Scroll down to the "Theme templates" section, and click on your "Cart.liquid" file to edit it
# Towards the bottom of the code, you should see a line that looks something like this
#; <pre><input name="checkout" type="submit" class="button" id="checkout-button" value="Checkout"></pre> 
# Add the following code immediately after the checkout button tag, then click "Save"
<pre>
{% if additional_checkout_buttons %}
  <div class="additional-checkout-buttons">
    <p>- or -</p>
    {{ content_for_additional_checkout_buttons }}
  </div>
{% endif %}
</pre>

The PayPal Express button should now appear under the "Update cart" and "Checkout" buttons. If you need to adjust the position of the button, you should do this using CSS.

=== Help! Checkout fails with the message "Payment has already been made for this InvoiceID" ===

You might see this message if you have multiple stores using the same PayPal account. By default, each Spiffy Store generates sequential invoice numbers as a simple number, usually starting at 1000. If you have multiple stores, then each store will generate a sequence of order numbers that will overlap with other stores using the same PayPal account. This means that PayPal may reject a new order if it has the same order number as a previous order that was placed via a different store using the same PayPal account.

In order to avoid this problem, simply go to the "Preferences -> Standards & formats" and look for the "Adjust your standards and formats" section. You'll need to create a unique Order ID format for each store sharing the same PayPal account. You can do this by clicking on the "(formatting)" link next to the "Order ID'.

Update the order id format by including a simple character prefix to distinguish each store. For example add a couple of letters in front of the invoice number...

<pre>
#TS{{number}}
</pre>

=== Help! The shipping price doesn't show up in PayPal Express ===

That is the way that PayPal Express works unfortunately.  The shipping rate is shown to the customer when they return to your store to confirm their payment.  If you don't like the way that PayPal Express works, you should just use PayPal Website Payments Standard instead.