IgnitionDeck Documentation

PayPal Adaptive

PayPal Adaptive, unlike PayPal Standard, allows 100% threshold (pre-order) and subscription funding types as well as the default immediate capture (order).  For IgnitionDeck Enterprise, it allows site owners to charge transaction fees to crowdfunding project creators. To read more about the capabilities of the different payment gateway options in IgnitionDeck Commerce (IDC), please see our documentation page called Choosing Payment Gateways.

NOTE: Taking IDC payments via PayPal requires at least a business-level PayPal account. To learn more about PayPal account types, see PayPal’s documentation on account types.

NOTE: It is a good idea to review PayPal’s documentation page called “Crowdfunding Application Guidelines“.

docs_Idc_PayPalAdaptive

  1. Navigate yoursite.com/wp-admin > IDC > Gateways > PayPal
  2. Check the box to “Enable PayPal Adaptive” (you may need to first uncheck the box for PayPal Standard).
  3. Enter your PayPal account email address (this is the email address that PayPal will make payments to).
  4. In a separate window or tab, log into your PayPal account.
  5. In your PayPal account, navigate to Profile > My Selling Tools > API Access > Update.
  6. On the PayPal “API Access page,” click “View API Signature.”
  7. On the PayPal “View or Remove API Signature” page, click the “Show” link for each of the following: API Username, API Password, and Signature.
  8. Copy and paste each of these into their respective fields in yoursite.com/wp-admin > IDC > Gateways > PayPal.
  9. (IDE only – optional) Check the “Enable for Creators” if you want project creators to be able to capture funds directly.
  10. Save your Gateway Settings.
  11. Log into developer.paypal.com and create an App in Dashboard > My Apps & Credentials > Create and manage NVP/SOAP API apps.
  12. You will automatically be navigated to PayPal-apps.com, provide your PayPal credentials again, and then click on the New Application button.
  13. Fill out the information, making sure to enable Adaptive Payments. Give your App a name and select “Web” as the platform.
  14. Submit your new App. PayPal will review your App.
  15. When PayPal has approved your App (usually in 24-72 hours), you will be able to retrieve your App ID from developer.paypal.com > Dashboard > Applications > Create and Manage Classic API apps.
  16. Enter your App ID in yoursite.com/wp-admin > IDC > Gateways > PayPal.
  17. Set the Pre-approval field to 364 days, or according to what PayPal approves for your app. For more info, see PayPal’s documentation page called “Crowdfunding Application Guidelines.”
  18. Save your Gateway Settings.

NOTE: The PayPal Return URL field is only used for PayPal Standard, so you do not need to fill this out.

In your PayPal account you should set up the return URL for your site.  This is done in Profile > Selling Preferences > Website Payment Preferences.  The correct format is your site’s URL with the appropriate HTTP or HTTPS and includes the dashboard link (i.e. http://mysiteurl.com/dashboard).
PayPal_AutoReturn

In your PayPal account, set up the Instant Payment Notification.  This is a good tool for troubleshooting any payment issues and is done in Profile > Selling Preferences > Instant Payment Notification Preferences.  The correct format is your site’s URL with the appropriate HTTP or HTTPS; it should not include the /dashboard or /?memberdeck_notify=pp (deprecated).
PayPal_IPN

Once you’ve set up your payment gateway(s), you will probably want to perform some test transactions to make sure everything is working properly. For some tips on testing your payments gateway(s), see our documentation page called Payment Gateway Testing.

PayPal Adaptive Handshake Error (effective June 17, 2016)

This error frequently looks like

error:14094410:SSL routines:SSL3_READ_BYTES:sslv3 alert handshake failure

This error is due to the web host’s server security not meeting PayPal’s requirements.  The web host needs to upgrade their server security to SHA-256 algorithm and discontinue use of the VeriSign G2 Root Certificate and upgrade to G5.  For more information, please see PayPal’s SSL Certificate Upgrade Guidelines.