type:
gateway
name:
PayPal Express Checkout
countrie:
AF, AX, AL, DZ, AS, AD, AO, AI, AQ, AG, AR, AM, AW, AU, AT, AZ, BS, BH, BD, BB, BY, BE, BZ, BJ, BM, BT, BO, BA, BW, BV, BR, IO, BN, BG, BF, BI, KH, CM, CA, CV, KY, CF, TD, CL, CN, CX, CC, CO, KM, CG, CD, CK, CR, CI, HR, CU, CY, CZ, DK, DJ, DM, DO, EC, EG, SV, GQ, ER, EE, ET, FK, FO, FJ, FI, FR, GF, PF, TF, GA, GM, GE, DE, GH, GI, GR, GL, GD, GP, GU, GT, GN, GW, GY, HT, HM, VA, HN, HK, HU, IS, IN, ID, IR, IQ, IE, IM, IL, IT, JM, JP, JO, KZ, KE, KI, KP, KR, KW, KG, LA, LV, LB, LS, LR, LY, LI, LT, LU, MO, MK, MG, MW, MY, MV, ML, MT, MH, MQ, MR, MU, YT, MX, FM, MD, MC, MN, MS, MA, MZ, MM, NA, NR, NP, NL, AN, NC, NZ, NI, NE, NG, NU, NF, MP, NO, OM, PK, PW, PS, PA, PG, PY, PE, PH, PN, PL, PT, PR, QA, RE, RO, RU, RW, SH, KN, LC, PM, VC, WS, SM, ST, SA, SN, CS, SC, SL, SG, SK, SI, SB, SO, ZA, GS, ES, LK, SD, SR, SJ, SZ, SE, CH, SY, TW, TJ, TZ, TH, TL, TG, TK, TO, TT, TN, TR, TM, TC, TV, UG, UA, AE, GB, US, UM, UY, UZ, VU, VE, VN, VG, VI, WF, EH, YE, ZM, ZW
support-added:
0.6.0
gateway:
http://www.paypal.com/

PayPal Express Checkout

FoxyCart is a PayPal Gold Partner FoxyCart is proud to be a PayPal Gold Partner.

What It Is

PayPal Express Checkout is what most people think of when they think of PayPal. Using Express Checkout the customer leaves your site and goes to PayPal.com to login and pay. If you want to allow the user to pay by credit card without leaving your site then you'll need a “real” gateway, as PayPal Express Checkout cannot process payments outside of PayPal.com. (Think about entering your PayPal password on a site that isn't PayPal.com. Big, big no-no there.)

Is Express Checkout the same as PayPal Standard? The short answer is, “Yes, you can use PayPal Express Checkout with your standard PayPal account.” But it's a good question. PayPal “Standard” is a type of account, where as PayPal Express Checkout is a way to use that account. So you can't get a PayPal Express Checkout account, but you can use PayPal Express Checkout with any type of PayPal account. (PayPal Standard is somewhat similar to Express Checkout, but it's standalone and does not integrate in the same way as Express Checkout.)

Setting Up PayPal Express Checkout for FoxyCart

Typically all you'll have to do is enter your email address in your FoxyCart Admin's “payment” section.

Setting Up Your Currency

Because PayPal Express Checkout (unlike most gateways) can accept a variety of currencies, it's important to set your currency in your FoxyCart admin's “language” section. Otherwise it may default to the USD, which may not be what you're after.

Allowing Non-PayPal Users to Pay via Credit Card (through PayPal)

Your customer who choose PayPal as a payment method will be taken to a screen that allows a login, but in some cases may also allow payment with a credit card without requiring the customer to create a PayPal account. This is not universally available, however. It is only available if:

  • The store's PayPal account is a Verified Business Account.
  • The customer is in a country or region that allows payment without a PayPal account. (China, for instance, does not seem to have this option.)
  • The customer doesn't have existing PayPal cookies that may change their options.

These criteria are controlled by PayPal, and FoxyCart has no control over whether or not a customer is allowed to pay through PayPal without creating an account. For more info please see PayPal's developer forum.

Subscriptions and Recurring Billing with PayPal Express Checkout

If you are selling subscriptions or recurring billing products through FoxyCart and are offering PayPal as a payment option, you must complete the steps here.

Please note: 1. These steps require a Premier or Business account. You will not be able to complete them if you have a Personal account.
2. Again, you must complete the steps here. Failure to properly configure your IPN will cause subscriptions in FoxyCart to be out of sync with PayPal. Your customers may not be charged or if they are charged, FoxyCart won't have any record of it. Please ensure this is setup correctly before going live.

Part 1: Set up the IPN

FoxyCart's integration with PayPal's recurring payments system requires the use of PayPal's Instant Payment Notification (IPN) system in order to keep our system and their system in sync after each transaction is processed (or fails to process). Follow these steps to activate your IPN:

  1. Login to the PayPal.
  2. Go to More→ Settings.
  3. Go to your Profile→My Selling Tools.
  4. Under “Getting Paid and managing my risks” click the “Update” to the right of “Instant payment notifications”.
  5. Click the “Choose IPN Settings” button.
    paypal_ipn_step3.jpg
  6. Replace “yourdomain.foxycart.com” (as seen on the image) with your full FoxyCart store domain. If you're using a remote store domain like store.example.com then use that.
    paypal_ipn_step4.jpg

Part 2: Set up the API Access

  1. 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”)
  2. If you see “API Access” in that column, click it and proceed to Step 5.
  3. 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.
  4. Click “Grant API permissions” or “Add or edit API permissions”. It should be at the bottom of the “Option 1” box on the left.
  5. 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.)
  6. 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.

Part 3: Testing

  1. Test by signing up for a subscription and ensuring it processes as desired. You can use PayPal's sandbox (details below) if you need.

For more details about recurring payments, please see PayPal's documentation .

Errors?

If you're doing subscriptions via PayPal Express or if you see the following error in your store's error logs:

Error: There was an error processing your payment: (10002 Authentication/Authorization Failed) You do not have permissions to make this API call

You'll have to follow the Setting It Up instructions for PayPal's Payments Pro, as your account has been set to block 3rd parties from making PayPal requests on your behalf.

Testing

Obtaining a Test Account

Testing PayPal Express Checkout is a little different than normal, as PayPal has a fully functional sandbox system. It's slightly cumbersome and confusing at first, but it does work very well once you figure it out.

Running Test PayPal Express Checkout Transactions

  1. First, set up a sandbox account as directed from the link above.
  2. Once your sandbox account is created, you'll need to create a test buyer and a test seller account.
  3. Enter your test seller account in your FoxyCart admin settings for both the PayPal Express Checkout email address and the PayPal Payments Pro email value as well. (See the image to the right for an example.)
  4. Attempt a checkout FoxyCart's PayPal Express Checkout from the same browser that you are already logged into the PayPal Sandbox from. Use the test buyer email address to complete the payment. Again, because you have to be logged into the PayPal Sandbox to process a test transaction it will not work unless you're both logged into the sandbox and attempting your FoxyCart checkout flow in the same browser.

Test Card Numbers

Review the test account you created (above). All test information should be there. Know more? Feel free to edit this page with info.

Important Notes and Caveats

User Notes and Experiences

Please note that, If you are using Multiship, only the first address will be sent as the shipping address to PayPal.

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.

Site Tools