Paypal Website Payments Pro

Updated on 14-December-2016 at 4:25 PM

Business Catalyst End of life announcement - find out more details.

Setting up PayPal Website Payment Pro Setup

To integrate this gateway, all you need to do is obtain Username, Password and an API signature from PayPal and paste that information into your website's Admin under eCommerce > Payment Gateways.

Here are the steps you need to take in order to obtain those details from PayPal:

1. Go to the PayPal website and log in.

2. Go to My Account -> Profile

3. Click on Request API credentials

4. Under Option 1 - PayPal API, click on Set up PayPal API credentials and permissions

5. Under Option 2 - Request API credentials to create your own API username and password, click on View API Certificate.

6. Now, select Request API signature and click Agree and Submit.

Site Admin setup

Once you have obtained the above information, log into your site and navigate to eCommerce > Payment Gateways, and select the Paypal (Website Payments pro) gateway.

Then, simply copy the information from the above screen and add it to afore mentioned page on your website.

Setting up for Recurring Billing (If required)

If you are using this gateway to process the recurring billing transactions, you will not to opt-in for a 'Fraud Management' package or your recurring orders will not work.

Setting up 3D Secure (Cardinal Centinel)

  1. Log into your Cardinal Centinel Production profile: using your paypal email address and password (If you have not previously logged in you may be prompted to accept license agreement, please do so to continue)

  2. Select Manage Profile from Main Menu:

  3. Select Manage Profile Information:

  4. Set your transaction password in the field provided. This is not a pre-defined password, you are creating the password by entering it into this field:

  5. Hit Enter button to Save. The CardinalCommerce set-up is now complete.

Setting up Cardinal Centinel in the admin of your site

  1. Login to your website and navigate to the eCommerce -> Payment gateways page. If you have not already done so, select the country ?United Kingdom? and the ?Paypal Website Payments Pro Gateway?. You will notice that this now displays the payment gateway details fields as well as the Cardinal Centinel details fields. Fill in these fields as provided by Cardinal Centinel in the above section.
  2. You will need to add the below code to the Admin > More customization options > Online shop layouts > Registration (buy) layout:
    <div id="ErrMsg" style="display: none;"> <div class="system-error-message">
                <h2>Credit Card Payment Failed</h2> <p>There was an error processing
                your credit card. Please correct this or choose another form of payment.<br
                /> <strong>{module_error}</strong> </p>
                </div> </div> <script type="text/javascript"> ExecuteMessage();
                function ExecuteMessage() { if (&#39;{module_error}&#39;
                == &#39;&#39;) document.getElementById("ErrMsg").style.display = "none";
                else document.getElementById("ErrMsg").style.display= "block"; } </script>{%
                endraw %}
    It is recommended that this is placed at the top of your layout as this is used to display the returned message such as any errors that may occur.




 Error Message -- "Gateway Response: (10501) This transaction cannot be processed due to
 an invalid merchant configuration"

 Error Message -- "Gateway Response: (10561) There's an error with this transaction. Please
 enter a complete billing address."

 Error Message -- "Gateway Response: (10002) Security header is not valid."

 Error Message -- "Gateway Response: (15005) This transaction cannot be processed."

If you encounter any that you feel may be useful to list here, please contact the support team with details of the issue and the solution you found, so that we may share this with people who may encounter the same issue in future.