Paypal Connect

To use PayPal as a social login provider, you will need an App ID and App Secret from your PayPal app, then copy these keys into your ReachFive settings. This tutorial explains how to create a PayPal App and connect it to your ReachFive account.

Default values for Paypal

The default values available to ReachFive from Paypal are:

  • Full name

  • Phone number

  • Email

  • Address

  • Birthday

When integrating with ReachFive, the name field contains the Full name provided through PayPal in the profile scope.

For more, see icon paypal Default public profile fields.

Set up PayPal app

In this section, we go over setting up an app within PayPal.

  1. Go to PayPal.

  2. Log in with your account and go to your dashboard.

    paypal dashboard

Create a new REST API app

You need to create a new REST API application in PayPal in order to leverage ReachFive properly.

  1. From My Apps & Credentials, click Create App.

    paypal createApp

  2. Give your app a name.

    paypal createApp appName

  3. Click Create App.

Configure Your PayPal App

There are certain parameters and information that you need to input in your PayPal app so that it can communicate with ReachFive.

  1. Go to Live App Settings.

    paypal 4

  2. Add https://{REACHFIVE_DOMAIN}/login/callback as the Return URL where REACHFIVE_DOMAIN is your ReachFive domain.

  3. Then, check Log In with PayPal and click Advanced options.

    paypal 5

  4. Check the following:

    • Personal information

    • Address information

    • Account information

  5. Add your Privacy policy URL, User agreement URL and Save it.

    If you don’t check these boxes, you’ll need to pass the permissions review process.

Validate your PayPal app

Every PayPal application which collects user data needs to be reviewed.

You must send an email to help-loginappreview@paypal.com with your app ID, how you use PayPal connect, and why you need to collect user information, such as the name, email, and street address.

Find an example of such an email below.

For more information, refer to the official PayPal documentation.

Hello,

I currently work for [BRAND].

I would like my Live PayPal Application with client ID [Client ID live APP] to be reviewed.

On my website, users can create an account to place orders, using our own account creation form or by using social connectors, which we encourage them to do.

As per the information on https://developer.paypal.com/docs/connect-with-paypal/reference/?mark=scope%20attri#scope-attributes, we request the following scopes:

* profile
* email
* address

These scopes will be helpful to collect the following information, which we use:

* Given name - to create an account
* Family name - to create an account
* Email address - to create an account
* Birthdate - to create an account, and used to send gifts on the user birthday
* Phone number - to request user consents
* Postal address - to deliver orders

If you need more information from us, please reach out.

Thanks in advance for your help.

Best regards,

[YOUR_NAME]
[COMPANY]

Configure PayPal as Provider on ReachFive

There are two environments in your PayPal app: Sandbox and Live.

Make sure to fetch the client ID and secret mentioned below from the Live environment.

  1. On the ReachFive Console, go to Settings  Providers, then select PayPal.

    paypal 8

  2. Copy the Client ID and Secret fields from your PayPal app to the corresponding field in the PayPal provider configuration window.

    paypal 7

  3. Under Permissions, select all values except https://uri.paypal.com/services/expresscheckout.

    paypal 9

UX considerations

When naming your app, it’s best to use your brand name or a name that is meaningful to your users.

User sessions

One area to consider is when users authenticate with PayPal, they are redirected to the PayPal login screen. On this screen, the login typically gives users a chance to cancel and return to the previous page. In the case that this is your PayPal application, the redirect page title is in fact the name of your application.

So, for example, if you named your Application, "Test-Test Richard", it would tell your users to return to "Test-Test Richard". Because of this, be sure to name your app something meaningful when creating it in PayPal.

You can find the name of your app in PayPal by navigating to the Apps & Credentials section and looking for App name.