PayPalOAuth

Skip to end of metadata
Go to start of metadata

This page is a step-by-step guide for the process of opening and setting up an external application in PayPal as part of the Gigya Setup process.

To receive assistance from the Gigya team with your app's configuration, visit the Support tab in your console.

If your site is defined under one of Gigya's non-US data centers, replace domain references to (http:// or https://) "socialize.gigya.com " (or "socialize.us1.gigya.com ") with "socialize.<DC>.gigya.com ". Where <DC> is the region of your Data center (e.g., "socialize.eu1.gigya.com "  for European Data center).

Domain references are defined in Gigya's dashboard, externally in social network app definition pages, and when using Gigya's SDKs to set the domain (in particular the APIDomain  field in class GSRequest).

When using any 3rd Party Apps with Gigya, it is important to ensure that you Enable retrieving user contacts from the Permissions page of the Console prior to making your app live. This enables basic username and email retrieval for your users from providers that don't consider this an elevated permission.

Phase 1 - Creating Your App

  1. Go to the PayPal App center at https://developer.paypal.com/ and log in to your account.
  2. Enter the Dashboard.

     

  3.  Click Create App.

     

  4.  Enter a name for your app.
    1. Note you can only use letters, numbers, and spaces.

       

  5.  Be sure you are in the Live version of the app configuration. If you create the app in Sandbox mode, you will need to re-configure all settings when enabling Live mode.

     

  6. If your PayPal account is a Premier or Business account, you will see your app credentials here:

  7. In the LIVE APP SETTINGS section, enter your Return URL, which will be either your sites CNAME or https://socialize.<data_center>.gigya.com/GS/GSLogin.aspx.

  8.  In the App feature options, un-select the boxes labeled:
    1. Accept payments
    2. Invoicing
    3. Payouts 

  9. In the Log In with PayPal section, open the Advanced options and select:
    • Personal Information
    • Address Information
    • Open the Account Information Advanced options and select:
      • Time zone
      • Locale
      • Language

     
     
  10. Select Allow the customers who haven't yet confirmed their email address with PayPal, to log in to your app
  11. Enter a valid URL for both Privacy policy and User agreement URL fields.
  12. Finally, Save your app. (Be advised that the PayPal session time is approximately 10 minutes, so if it takes you longer than that to configure your app, you may need to start over).
  13. Click through the warning that you are turning off some app capabilities. This is because we disabled some feature in Step 8, above.



  14.  You should now see an Application saved successfully notice on the page (or an error describing the issue).



  15. Leave this page open and proceed to Phase 2 - Configuring PayPalOAuth in the Gigya console (below).
     

You must complete this entire process (above), within the session length of PayPal, which is approximately 10 minutes, or you will loose any data not saved in the configuration.

 

Phase 2 - Configuring PayPalOAuth in the Gigya console

  1. If you are not logged into Gigya, go to http://console.gigya.com/ and sign in. Then go to the Gigya Dashboard.
  2.  Press the Site Settings button that corresponds to the domain you wish to configure. You will be redirected to the Site Settings page.

  3.  Click Providers Configurations in the left-hand menu.

  4.  On the page that opens, select the button that corresponds to the PayPalOAuth configuration.

  5.  In the dialog that appears, from the PayPal app configuration page still open from Phase 1, copy and paste both your Client ID and Secret into the corresponding fields of the dialog.
    1. Be sure to check the Enable CName box, if you are using a CName in your app's Return URL field from Phase 1 (above).
    2. Important: The Sandbox and Live Client ID/Secret pairs are different, ensure you are copying the keys from the Live version of your app.

  6.  Click OK to close the dialog.
  7. Press the Save Settings button in the lower-right of the Providers Configurations page.

  8. You can set additional permissions regarding the information Gigya requests from PayPal by going to the Permissions page of the Gigya console via the left-hand menu.

  9. Here you can choose whether to gather the users Email address, Street address, and/or Phone number by selecting the corresponding options and clicking the Save Permissions button on the lower right-hand section of the page.

  10.  That's it, PayPalOAuth configuration is complete! Please note that it can take from 1 minute to 3 hours for configurations made in PayPal to become synchronized.

    If you have issues getting your app to function properly due to entering an incorrect Return URL during the initial app setup, it is often more effective to create a new app, being sure to enter the correct Return URL at setup, then waiting on PayPal to synchronize a change.

Additional Information

For more information, please see https://developer.paypal.com/docs/.


  • No labels