PayPal Plus

Setting up 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 paypal.de/paypal-plus.

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 enabled. Both can still be done on the cart.

Create a PayPal developer app

To get started, PayPal recommend setting up a developer account to test everything out. Follow the steps in the Testing section below.

Making your PayPal Plus app live

When you're ready to go live with your PayPal Plus payment option:

1. 1

   Within the PayPal Developer portal, find the REST API app you created previously and select it.

2. 2

   In the top right of the details screen, find the Test | Live toggle and switch it to live. The screen updates to show the live credentials for your app.

3. 3

   Copy the Client ID and Secret into the PayPal Plus entry in your Foxy payment method set, under Live setup.

4. 4

   Set up a new live webhook the same way you set up the test webhook earlier, with a URL like https://YOUR-STORE.foxycart.com/ipn.php.

Testing

Obtaining a test account

1. 1

   Go to developer.paypal.com and log in with your PayPal developer account.

2. 2

   From the Dashboard, find the REST API apps section and click Create App.

3. 3

   Give your app a name and select a Sandbox developer account. This developer account needs to be a German developer account — it should show (DE) at the end of the listing in the dropdown. If you don't have one, go to the Accounts section under Sandbox in the left hand navigation and create a business account, selecting Germany as the country.
   

4. 4

   After creating the app you'll be taken to a summary screen showing your test Client ID and Secret. Enter these into the PayPal Plus entry in your Foxy payment method set, under Test setup. The secret is hidden by default — click Show to see it.
   

5. 5

   Below the credentials you'll see a panel for webhooks. These are needed to communicate details back to Foxy from your PayPal account. Click Add Webhook and enter the IPN URL for your Foxy store, which looks like https://YOUR-STORE.foxycart.com/ipn.php.
   If your Foxy store is example.foxycart.com, the webhook URL is https://example.foxycart.com/ipn.php. If you have a custom subdomain like secure.yourstore.com, the webhook URL is https://secure.yourstore.com/ipn.php. Select All Events for the event types.

At this point you should be able to make test purchases on your store. When paying through the PayPal Plus interface on the checkout, use test buyer accounts created in the PayPal developer portal. If you don't have any, you can create them from the Accounts section.

Troubleshooting & interpreting response codes

Contact PayPal for info.

Important notes and caveats

Possible action: datafeed handling

We don't necessarily know at the time the customer completes the transaction whether it was completed. We rely on a notification from the gateway afterwards to confirm whether it was approved. Transactions are initially marked as pending, and we update them when the gateway confirms the result.

Each time the status changes, a datafeed is sent to your endpoint if configured, with the transaction details and a status node. The status node contains one of three values: pending, approved or rejected. Depending on what your endpoint does, make sure you check for the appropriate status value first.

Pay Upon Invoice

If a customer selects the Pay Upon Invoice option, they'll be given bank details so they can make a manual transfer from their bank into PayPal. The bank details appear on the receipt and in an email receipt sent straight after the transaction completes.

That email includes a language string letting the customer know they still need to complete some actions. You can edit this string from the language section of the Foxy administration, in the email group labelled paypal plus pui.