PayPal Website Payments Pro

Introduction

PayPal’s Website Payments Pro is a great solution for American, Canadian, and British businesses with large volumes of monthly payments who want a seamless integration - the ability for customers to pay on your website. Website Payments Pro does require that you have a Premier or Business PayPal account, and the application can take a couple of days to process.

If you’re looking for a more basic payment solution, the we recommend looking at our PayPal Website Payments Standard integration, which can be set up minutes. For more information about the difference between Website Payment Standard and Website Payments Pro, please view PayPal’s comparison chart.

If your company is not American, Canadian, or British, or if you would like to use your own merchant account, we recommend taking a look at our PayPal Payflow Pro integration, which offers seamless integration and a comparable feature set to Website Payments Pro.

The User Experience

The user experience for the PayPal Website Payments Pro and Wufoo integration consists of two major processes.

Complete Wufoo Form

The user will complete your Wufoo form just like they would any Wufoo form. This form will validate for any errors, and when a form validates and is submitted, the user will redirected to the integrated Wufoo payment form to initialize the payment process.

Complete Integrated Wufoo Payment Form

When the user is redirected to the integrated Wufoo Payment form they will be asked to fill out their credit card details, a billing address, and a shipping address (if specified). If the transaction fails for any reason an error message will appear in the integrated payment form, much like a normal Wufoo form. If the transaction succeeds the user will be redirected to the form’s confirmation page.

If the user chooses the PayPal option they will be redirected to PayPal in order to pay with their PayPal account. They will be redirected to your confirmation page after completing the purchase.

Configuring Wufoo

Before configuring Wufoo please ensure that you have the proper PayPal account and can accept PayPal Payments Pro transactions. If you are unsure whether or not your PayPal account is correct please read our instructions on how to set up a PayPal Payments Pro account.

Payments Pro requires a username, password, and API signature to be configured in your Merchant Setup Section. Please note that neither of these items are the login or password that you use to log into PayPal. They are completely separate from logging into your account and can be obtained by following these steps:

• Go to the PayPal website and log in to your account.
• Click “Profile” at the top of the page.
• Click “API Access” in the Account Information column.
• Click “View API Certificate or Request API Credentials”.
• Select “Request API signature.”
• Click “Agree,” and then click “Submit”.
• Write down your API username, API password, and API Signature information. This is the information you will need to enter into Wufoo in order to configure the integration successfully.
• Click “Done.”

• Log into Wufoo and enter your credentials into your merchant setup are as explained at http://wufoo.com/docs/payment-settings/

• If you forget your API credentials after completing the previous steps you can re-access them by clicking Profile->API Access->View API Certificate->Request API signature. Copy the credentials and enter them into Wufoo.

To set up Express Checkout, an option that is always included in your payment form, follow these steps:

• Go to the PayPal website and log in to your account.
• Click “Profile” at the top of the page.
• Click “API Access” in the Account Information column.
• Click the “Enable Express Checkout Link”.
• Select the choice to “Accept PayPal payments before API permissions or credentials are set up” and hit “Submit”.

Why is there a credit card option with the PayPal logo?

PayPal requires that shopping cart solutions integrated with Payments Pro also have the option to also make their purchase using Express Checkout. If your users choose the PayPal option they will be redirected to PayPal.com to continue the payment through their PayPal account. They will be returned to your confirmation page after a successful transaction.

What type of PayPal account do I need for this to work?

You will be required to have either a Premier or Business account with PayPal. You will also be required to apply for the use of Website Payments Pro, which can take 48 hours to process and requires a credit check. The easiest way to learn about the costs involved and how set up an PayPal Payments Pro account is to take a look at their introductory tour located at www.paypal.com/us/cgi-bin/?cmd=_wp-pro-overview-outside.

Do you store credit card data?

Wufoo does not store any credit card data including card numbers, billing addresses, and shipping addresses. Wufoo sends all credit card information securely to PayPal.com for processing. PayPal.com then returns the status of the payment transaction, which Wufoo records in the system.

What does the “Security header is not valid” error mean?

This means your account is not properly configured to process express checkout and/or payment pro transactions. Please make sure that you have the correct PayPal and Payments Pro account by following the instructions at http://wufoo.com/docs/merchant/paypal-pro/#configWufoo.

If you are 100% certain that your API information is being entered correctly into Wufoo, please try re-keying your PayPal API credentials by taking the following steps:

• Click Profile
• Click API Access
• Click View API Certificate
• Click the Remove button

After deleting your current API information, try resetting your API by following these steps.

What does the “Invalid Merchant Configuration” error mean?

It could be one of two things according to the paypal api error codes

• Occurs when you have not agreed to the billing agreement.
• Occurs when the billing agreement is disabled or inactive.

In either case you will want to contact PayPal and ensure that your account is set up to process Website Payments Pro transactions and that the billing agreement is accepted. You can also search PayPal’s forums for information specific to this error code.

Why am I receiving an error message?

There are a lot of reasons why your integration could be failing, and all of the possible error messages and the reasons for why they happen can be found on PayPal’s integration documentation.

If you are receiving an error message stating, “The seller accepts encrypted website payments only. You cannot pay the seller through un-encrypted buttons. ”, please look at the PayPal documentation to research and fix the issue.