PayPal Website Payments Pro 3.0

PayPal’s Website Payments Pro 3.0 is the original Pro package that PayPal offered. It works on the DoDirectPayment API and is being slowly deprecated since the launch of Payments Pro 2.0 that works on the PayFlow API. You need to be sure that your account is setup for this version of Pro before configuring this payment gateway or you will end up with errors when people attempt to pay you via credit card.

For more details on this, see The History of PayPal Payments Pro.

Setup Steps

1. Navigate to WooCommerce -> Settings.

WooCommerce Settings

WordPress Admin Panel -> WooCommerce -> Settings

2. Click on the Checkout tab.

WooCommerce Checkout Settings

WooCommerce Checkout Settings

3. Click the PayPal Website Payments Pro (DoDirectPayment) link to enter the settings page.

WooCommerce PayPal Website Payments Pro 3.0 DoDirectPayment Settings

WooCommerce PayPal Pro DoDirectPayment Settings

4. Set each option according to your needs.

Enable / Disable

Check this box to enable the payment gateway. Leave unchecked to disable it.

Title

This controls the label the user will see for this payment option during checkout.

Description

This controls the description the user will see for this payment option during checkout.

PayPal Payments Pro Title and Description

WooCommerce PayPal Pro DoDirectPayment Title and Description

Invoice ID Prefix

This allows you to set a value to be used as the prefix on invoice IDs generated by WooCommerce.

  • This can help to resolve duplicate invoice issues that may arise if you’re using PayPal Payments Pro on multiple websites where the same invoice IDs can get used. A prefix is required to avoid declined payments when this happens.
Card Icon

Set the image you would like to use for the credit card icons on the WooCommerce checkout page.

Error Email Notifications

Enable this to receive an email any time a PayPal Payments Pro failure occurs.

  • This can help you track overall failure rate of transactions on your site, as well as diagnose issues that could potentially be fixed by adjusting settings in your PayPal account.
Test Mode

Check this box to enable test mode so that all transactions will hit PayPal’s sandbox server instead of the live server. This should only be used during development as no real transactions will occur when this is enabled.

PayPal Sandbox API Username, Password, Signature
  • Sandbox API Username – This is the API username value for a sandbox account you would like to test with.
  • Sandbox API Password – This is the API password value for a sandbox account you would like to test with.
  • Sandbox API Signature – This is the API signature value for a sandbox account you would like to test with.
PayPal Live API Username, Password, Signature
  • Live API Username – This is the API username value for your live account to process real payments with.
  • Live API Password – This is the API username value for your live account to process real payments with.
  • Live API Signature – This is the API username value for your live account to process real payments with.
Error Display Type

Detailed displays actual errors returned from PayPal. Generic displays general errors that do not reveal details and helps to prevent fraudulent activity on your site.

Payment Action

This allows you to adjust how the original transaction is processed.

  • Sale – Captures the payment immediately and moves the money into your PayPal account when the order is placed.
  • Authorization – Authorizes the funds on the buyer account, but does not fully capture or move any money.
Send Item Details

Enable this option to include line item details in the PayPal payment request.  Doing this will include the details in the PayPal transaction details so that they show up in the PayPal account.

PayPal Payments Pro DoDirectPayment Line Items

PayPal Payments Pro DoDirectPayment Line Items

Enable PayPal IPN

By default, if IPN is enabled in your PayPal account profile the data will be sent to the URL specified there.  If you would like to override this value so that IPNs from this site are sent to a different URL then you can set that URL here.

Enable Tokenized Payments

Enable this option to give buyers the ability to save their payment method for future reference so that they can checkout more quickly.  With the payment method saved, next time they buy something on your site they will be able to select the saved payment method and checkout instantly without filling in credit card details.

Fraud Management Filters

Set how you would like to handle orders that are flagged by your Fraud Management Filters in your PayPal account.

Enable Cardholder Name

Enable this option to add additional fields to the checkout page for Cardholder Name.  These fields will be separate from the Billing and Shipping Name.

AVS / CVV2 Results in Admin Order Email

Enable this option to include details about Address Verification and Card Security Code results in the order email sent to the site admin.

NOTE:  This information will not be included in the buyer’s receipt email.

Credit Card Statement Name

Set the value you would like to be displayed on your buyer’s credit card statement.  This is typically your company name.

Credit Card Month Format

Set how you would like to display values for the Credit Card Month.  You can choose to display full names of each month or just display the month numbers.

Credit Card Year Format

Set how you would like to display the Credit Card Year on the WooCommerce checkout form; either 2 digits or 4 digits.

Debug Log

Check this box to enable logging for DoDirectPayment API calls. These logs will be saved under /wp-content/uploads/wc-logs/.

5. Click the Save Changes button to submit your changes.

Looking for Live Help?

Schedule a live meeting with Drew Angell, PayPal Certified Developer, and get all of your questions or concerns answered.