PayPal Payments Pro

FoxyCart is proud to be a PayPal Gold Partner.

To use PayPal with FoxyCart you'll need to have PayPal's Payments Pro. There are only a few steps you'll need to take to use PayPal's Payments Pro with FoxyCart. These instructions are for configuring PayPal Payments Pro with FoxyCart, using the LIVE gateway. If you haven't activated your FoxyCart store yet and do not have access to the “live” option on your payment settings, you'll need to view the “sandbox” instructions below.

1. Set up a PayPal account with Payments Pro (US, Canada, or others where supported). Other countries PP WPP systems may work following the same instructions, or they may require the Payflow Pro method.
2. Ensure your PayPal account is showing “Virtual Terminal” in your main navigation, like this:
   
3. Go to your Profile tab and look in your “Account Information” column (If you are using the new Paypal format, it's located by going to “profile>more options>my selling tools” and then the API access is located under “selling online”)
   
4. If you see “API Access” in that column, click it and proceed to Step 5.
5. If you see “Request API Credentials”, click it and proceed to Step 5.
   • If you don't see anything like this you probably need to VERIFY your account. An unverified account will not have API access.
6. Click “Grant API permissions” or “Add or edit API permissions”. It should be at the bottom of the “Option 1” box on the left.
   
7. Enter billing_api1.foxycart.com, check all the checkboxes except “Consolidate funds from two or more accounts to a master account.”, and submit. (Or, if you already have another API permission granted, click “Add new permission”, then do the preceding.)
8. Go to your FoxyCart admin, edit your Payment Gateway settings (in the “Store” menu item), set it to PayPal, Live Server, and enter the primary email. It must be the primary email on the PayPal account, or this will not work.
9. If you're using PayPal Express for subscriptions, be sure to setup your IPN as described here.

Testing is always a very good idea. You can use the default FoxyCart sandbox account for testing (in your “Payment Gateway” settings), but this won't allow you to see all the transaction details. When it's necessary to test things more thoroughly, you should set up your own PayPal Sandbox account.

While you're using a PayPal Sandbox, you can run test transactions using the test card number 4242424242424242, with any expiration date in the future. NOTE: This card number is for testing and will not work on a live PayPal account.

If you'd like to test things more completely you can set up your own PayPal Sandbox account. Setting this up is NOT trivial. It's confusing, prone to error, and generally not recommended unless you have some time to kill. Once you do set up a sandbox account, follow the steps above but grant API permission to sandbox_api1.foxycart.com rather than the billing_api1.

• 4242424242424242

By default, PP WPP requires the CSC (card security code) to be sent with the payment details. PayPal Payments Pro will not usually give you access to the CSC settings by default. This option is available on a case-by-case basis for an additional $30/mo, but PayPal might not allow your account access to the CSC settings depending on your business history. Read this page for more information.

If you have no business history, bad credit, or a history that includes bankruptcies this setting will likely be unavailable to you, and you will probably have to use a different gateway in order to use subscriptions with FoxyCart.

UPDATE as of 2010.12.07 PayPal WPP accounts may now have access to this setting without advanced fraud filters.

1. Login to your PayPal account
2. Go to My Account
3. Go to Profile
4. Click “Risk Controls”.
5. Find the “Card Security Code Filter” area, hit that corresponding radio button and click the “Edit” button.
6. From there, set it to “Accept” and save.
7. Test.

Paypal Payments Pro may not be available for merchants who are outside the US Mainland, that includes the U.S. Virgin Islands. ie. If you're in California, you can use PP WPP and accept payments from all over the world. If you're in the US Virgin Islands, however, PayPal might not give you a WPP account, so you cannot accept payment from anybody. Please make sure your location is actually supported by PayPal before pursuing the Payments Pro option.

If you have tips, experience, or helpful notes related to this gateway that would benefit others, please add them below, including your name and the date. We reserve the right to edit or remove comments that don't add value to this page.

• In Europe, PayPal offer Payments Pro in the UK only (although this may have changed by the time you read this, so double-check). FoxyCart integration with UK WPP works just fine.