IgnitionDeck Documentation

PayPal Adaptive for IDE

PayPal Adaptive, unlike PayPal Standard, allows IgnitionDeck Enterprise 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“.

For the basic set up of the PPA gateway, please see the IDC PayPal Adaptive documentation.  This documentation will cover the PPA application specifically for IDE.

 

  1. Log into developer.paypal.com and create an App in Dashboard > My Apps & Credentials > Create and manage NVP/SOAP API apps.
  2. You will automatically be navigated to PayPal-apps.com, provide your PayPal credentials again, and then click on the New Application button.
  3. Fill out the App information and Industry for your business.  Open the Adaptive Payments tab.
    PPA_AdaptivePayments
  4. Enable Chained Payments if you wish to permit project creators to capture their own funds and to charge a crowdfunding fee.  Your settings should look like the screenshot:
    PPA_ChainedPayments
  5. Enable Preapprovals if you wish to offer 100% threshold and/or subscription funding options to your project creators; preapprovals are in addition or instead of Immediate Capture (please see Funding Options documenation for further information).  If you are offering 100% threshold (no subscription option) select the One-time Payments.  If you wish to offer subscriptions select the Subscription Payments; this will still permit the one-time payment required for the threshold funding option as well as subscriptions.
    PPA_Preapprovals
  6. Adaptive Accounts, 3rd Party Permissions, and Invoicing are not required for the IgnitionDeck use.
  7. When PayPal has approved your App (usually in 24-72 hours), you will be able to retrieve your live App ID from developer.paypal.com > Dashboard > Applications > Create and Manage Classic API apps.
  8. Enter your App ID in yoursite.com/wp-admin > IDC > Gateways > PayPal.
  9. 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.”
  10. Check the “Enable for Creators” if you want project creators to be able to capture funds directly regardless of funding type, and you wish to charge a crowdfunding fee.
  11. 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.  To set up the auto-return from PayPal, this needs to be done in the PayPal account and will be found under Profile > Selling Preferences > Website Payment Preferences > Auto Return:
PPA_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.  If this isn’t possible, you may need to switch to dedicated hosting in order to install your own SSL certificate in order to comply with PayPal security requirements.