Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
gateways:paypal:paypal_plus [2016/11/18 14:25] – [Obtaining a Test Account] adamgateways:paypal:paypal_plus [2025/03/04 18:11] (current) – [Setting Up PayPal Plus for FoxyCart] adam
Line 1: Line 1:
 ---- dataentry gateway ---- ---- dataentry gateway ----
-type            : gateway         # do not change this line +type               : gateway # do not change this line 
- +name               : PayPal Plus #  
-# Add the full name of the gateway after the colon below. +countries          : DE #  
-name            : PayPal Plus +support-added      : 2.0.0  
- +support-removed     #  
-Supported Countries. Please use 2-character ISO Country Codes available at +supports-3dsecure  : yes enter "yes" or "no" (without quotes)
-# http://www.iso.org/iso/english_country_names_and_code_elements +
-# Separate multiple country codes by commas. +
-countries       : DE +
- +
-Enter the FoxyCart versions where support was added or removed (if applicable). +
-# Version numbers should include applicable decimals, such as "0.7.0" and not "070" +
-support-added   : 2.0.0 +
-support-removed :  +
- +
-Features and Details+
 auth-net-emulation :  # enter "yes" or "no" (without quotes) auth-net-emulation :  # enter "yes" or "no" (without quotes)
-supports-3dsecure  :  # enter "yes" or "no" (without quotes) +gateway_url        : https://www.paypal.com/de/webapps/mpp/paypal-plus 
- +
-# Gateway URL +
-gateway_url     : https://www.paypal.com/de/webapps/mpp/paypal-plus+
 ---- ----
 +
  
  
Line 31: Line 19:
 ===== Setting Up PayPal Plus for FoxyCart ===== ===== Setting Up PayPal Plus for FoxyCart =====
  
-PayPal Plus requires a fully verified PayPal merchant account and goes through a vetting process. To apply for PayPal Plus go to www.paypal.de/paypal-plus +PayPal Plus requires a fully verified **GERMAN** PayPal merchant account and goes through a vetting process. To apply for PayPal Plus go to www.paypal.de/paypal-plus
-==== Disable Editable Cart and Coupons on Checkout ====+
  
-Because of how the PayPal Plus flow works, you need to disable the ability to edit the cart or add a coupon on the checkout when using PayPal Plus. To do thatnavigate to the "configuration" section of your store's FoxyCart administration, and look for the "Customize which checkout fields are shown and requiredoption. Enable this and set the "editable cart" and "coupon entryoptions to disabled, and save the page.+<WRAP center round important 90%> 
 +Subscriptions are not supported with PayPal Plus at this time. If you intend to sell subscriptions with your FoxyCart store, you will also need to make use of another payment gateway that does. 
 +</WRAP> 
 +==== Important Notes ==== 
 + 
 +  * At this time, it is not possible to process subscriptions with PayPal Plus 
 +  * Cart editing and the ability to add coupons is disabled on the checkout when PayPal Plus is enabledThis can still be completed on the cart though. 
 + 
 +==== Create a PayPal Developer App ==== 
 + 
 +To get startedPayPal recommend setting up a developer account to test everything out. Follow the details below in the [[gateways:paypal:paypal_plus#testing|Testing section]] for details on doing that. 
 + 
 +==== Making your PayPal Plus App live ==== 
 + 
 +When you're ready to go live with your PayPal Plus payment optionfollow the following steps: 
 + 
 +  - Within the PayPal Developer portal, find the REST API app you created previously and select it.  
 +  - In the top right of the details screen, look for the "Test | Livetoggle, and switch that to live. The screen will then update to show the live credentials for your app.  
 +  - You'll need to copy the Client ID and Secret into your FoxyCart administration'"paymentssection for PayPal Plus. Remember to first switch your payment servers to "Live Servers" at the top of the payments page in the FoxyCart administration before copying the live credentials from your PayPal account. 
 +  - You'll also need to set up a new live webhook in the same way that you activated the test webhooks earlier with a URL like ''https://YOUR-STORE.foxycart.com/ipn.php''.
  
-{{ :gateways:paypal:paypalplus_disable.jpg?nolink&500 |}} 
 ===== Testing ===== ===== Testing =====
  
Line 60: Line 65:
 ===== Important Notes and Caveats ===== ===== Important Notes and Caveats =====
  
 +==== Possible Action: Datafeed Handling ====
 +
 +At the time of the customer completing the transaction - we don't necessarily know whether the transaction was completed yet or not. We instead rely on a notification from the gateway after the checkout has been completed to confirm whether the transaction was approved or not. To handle this, transactions are initially marked as pending, and when we get a confirmation from the gateway on the result of the transaction, we update it accordingly. Each time the status changes, a datafeed will be sent to your endpoint if configured with the transaction details and the ''status'' node will be present.
 +
 +The ''status'' node can contain one of three different values: ''pending'', ''approved'' or ''rejected''. Depending on the types of actions you're needing to perform at your datafeed endpoint, you need to make sure the appropriate status value is present first.
 +==== Pay Upon Invoice ====
 +
 +If a customer selects to pay using the Pay Upon Invoice option, they'll be provided with bank details that they can complete a manual transfer from their bank into PayPal. The bank details they need will be displayed on the receipt, as well as within a email receipt that is sent straight after transaction completion. 
  
 +As part of the email, we also include a specific language string letting the customer know that they still need to complete some actions. You can alter this language string from the "language" section of the FoxyCart administration, within the "email" group labelled "paypal plus pui".
  
 ===== User Notes and Experiences ===== ===== User Notes and Experiences =====
 <wrap tip>If you have tips, experience, or helpful notes related to this gateway that would benefit others, please add them below, including your name and the date.</wrap> We reserve the right to edit or remove comments that don't add value to this page. <wrap tip>If you have tips, experience, or helpful notes related to this gateway that would benefit others, please add them below, including your name and the date.</wrap> We reserve the right to edit or remove comments that don't add value to this page.

Site Tools