====== Setting Up PayPal Payments Pro US for FoxyCart ======


===== Website Payments Pro US =====

To use PayPal with FoxyCart you'll need to have PayPal's [[https://www.paypal.com/cgi-bin/webscr?cmd=_wp-pro-overview-outside|Website Payments Pro]]. There are only a few steps you'll need to take to use PayPal's Website Payments Pro with FoxyCart:


==== Setting it up ====

  - Set up a PayPal account **with Website Payments Pro** (US)
  - Go to your ''Profile'' tab and click ''API Access'' in the "Account Information" column.
  - Click "Grant API Permission". If you've already granted API access to another service, click the "View or Change API Permissions" link, then .
  - Enter ''billing_api1.foxycart.com'', check all the checkboxes, and submit. (Or, if you already have another API permission granted, click "Add new permission", then do the preceding.)
  - Go to your [[https://www.foxycart.com/admin|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.

==== Testing Things (Sandbox) ====

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 [[https://www.paypal.com/IntegrationCenter/ic_sandbox.html|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.

=== Setting up your own PayPal Sandbox account ===
If you'd like to test things more completely you can set up your own [[https://www.paypal.com/IntegrationCenter/ic_sandbox.html|PayPal Sandbox]] account. It's a bit involved, but once you set up a sandbox account, follow the steps above but grant API permission to ''sandbox_api1.foxycart.com'' rather than the ''billing_api1''.