Both sides previous revisionPrevious revisionNext revision | Previous revision |
gateways:paypal:express_checkout [2020/07/09 10:49] – [Running Test PayPal Express Checkout Transactions] adam | gateways:paypal:express_checkout [2022/03/25 21:03] (current) – [PayPal Express Checkout] marija |
---|
---- dataentry gateway ---- | ---- dataentry gateway ---- |
type : gateway # do not change this line | type : gateway # do not change this line |
| name : PayPal Express Checkout # |
| countries : 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, 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 # |
| support-removed : # |
| supports-3dsecure : yes # |
| supports-multicurrency : yes # enter "yes" or "no" (without quotes) |
| gateway_url : http://www.paypal.com/ # |
| ---- |
| |
# Add the full name of the gateway after the colon below. | |
name : PayPal Express Checkout | |
| |
# Supported Countries. Please use 2-character ISO Country Codes available at | |
# http://www.iso.org/iso/english_country_names_and_code_elements | |
# Separate multiple country codes by commas. | |
countries : 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 | |
| |
# Enter the FoxyCart versions where support was added or removed (if applicable). | |
# Version numbers should include applicable decimals, such as "0.7.0" and not "070" | |
support-added : 0.6.0 | |
support-removed : | |
supports-3dsecure: yes | |
supports-multicurrency : yes # enter "yes" or "no" (without quotes) | |
| |
# Gateway URL | |
gateway_url : http://www.paypal.com/ | |
---- | |
| |
| |
[[https://www.paypal-marketing.com/emarketing/partner/directory/directory.page#m=p&n=24657428861|{{:gateways:paypal:pp_partner_logo_rgb.jpg?nolink |FoxyCart is a PayPal Gold Partner }}]] | [[https://www.paypal-marketing.com/emarketing/partner/directory/directory.page#m=p&n=24657428861|{{:gateways:paypal:pp_partner_logo_rgb.jpg?nolink |FoxyCart is a PayPal Gold Partner }}]] |
FoxyCart is proud to be a [[https://www.paypal-marketing.com/emarketing/partner/directory/directory.page#m=p&n=24657428861|PayPal Gold Partner]]. | FoxyCart is proud to be a [[https://www.paypal-marketing.com/emarketing/partner/directory/directory.page#m=p&n=24657428861|PayPal Gold Partner]]. |
| |
| <WRAP center round important 100%> |
| **Version 2.0**: Note that we no longer recommend using the PayPal Express Checkout option for PayPal-hosted payment, except in very specific cases. Our **PayPal Checkout** option under the [[gateways:paypal:commerce_platform#paypal_checkout|PayPal Commerce Platform]] option provides an updated version of the PayPal-hosted option. |
| </WRAP> |
| |
===== What It Is ===== | ===== What It Is ===== |
{{ :gateways:paypal:screen_shot_2016-10-03_at_3.33.05_pm.png?nolink&600 |}} | {{ :gateways:paypal:screen_shot_2016-10-03_at_3.33.05_pm.png?nolink&600 |}} |
| |
FoxyCart currently has two different integrations for PayPal Express Checkout in FoxyCart 2.0 - "PayPal Express Checkout (Reference Transactions)" and "PayPal Express Checkout (Legacy)". Generally speaking, you will want to use the "Reference Transaction" integration for your store. The main difference between the two integrations is how subscriptions are handled - with the Reference Transactions integration providing a superior experience for customers and store administrators. For FoxyCart versions 1.1 and older, the single PayPal Express Checkout integration is the same as our "Legacy" integration in 2.0. | FoxyCart currently has two different integrations for PayPal Express Checkout in FoxyCart 2.0 - "PayPal Commerce Platform" and "PayPal Express Checkout (Legacy)". Generally speaking, you will want to use the "Commerce Platform" integration for your store. The main difference between the two integrations is how subscriptions are handled - with the Commerce Platform integration providing a superior experience for customers and store administrators. For FoxyCart versions 1.1 and older, the single PayPal Express Checkout integration is the same as our "Legacy" integration in 2.0. |
| |
When using PayPal to sell subscriptions with the Reference Transactions integration, it does require enabling a feature within your PayPal account that isn't available in all countries. Review the subscriptions section below for more details on this. If you're not sure, please reach out to us and we'll be happy to help you out. | When using PayPal to sell subscriptions with the Commerce Platform integration, it does require enabling a feature within your PayPal account that isn't available in all countries. Review the subscriptions section below for more details on this. If you're not sure, please reach out to us and we'll be happy to help you out. |
==== Setting Up Your Currency ==== | ==== 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 "settings" page, through the "store locale" option. Otherwise it may default to the USD, which may not be what you're after. | 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 "settings" page, through the "store locale" option. Otherwise it may default to the USD, which may not be what you're after. |
If you are selling subscriptions or recurring billing products through FoxyCart and are offering PayPal as a payment option, <wrap important>you must complete the steps here</wrap>. | If you are selling subscriptions or recurring billing products through FoxyCart and are offering PayPal as a payment option, <wrap important>you must complete the steps here</wrap>. |
| |
<wrap important>FoxyCart's legacy PayPal Express Checkout integration has some limitations regarding subscriptions which you should be aware of.</wrap> Because of these limitations, the PayPal Express Checkout integration in FoxyCart version 1.1, and the PayPal Express Checkout (Legacy) integration in version 2.0, does not allow users to modify their carts via the ''sub_token''. You also can not have a subscription with a start date in the future if you're using the legacy Express Checkout integration. Beginning with 2.0, our new PayPal Express Checkout (Reference Transactions) integration does support native FoxyCart subscriptions, meaning you can use the ''sub_token'' to work with PayPal subscriptions. Here are some additional limitations as described in PayPal's documentation: | <wrap important>FoxyCart's legacy PayPal Express Checkout integration has some limitations regarding subscriptions which you should be aware of.</wrap> Because of these limitations, the PayPal Express Checkout integration in FoxyCart version 1.1, and the PayPal Express Checkout (Legacy) integration in version 2.0, does not allow users to modify their carts via the ''sub_token''. You also can not have a subscription with a start date in the future if you're using the legacy Express Checkout integration. Beginning with 2.0, our new PayPal Commerce Platform integration does support native FoxyCart subscriptions, meaning you can use the ''sub_token'' to work with PayPal subscriptions. Here are some additional limitations as described in PayPal's documentation: |
| |
* To be able to create a recurring payments profile for the buyer, you must ensure that the buyer's PayPal account includes an active credit card. | * To be able to create a recurring payments profile for the buyer, you must ensure that the buyer's PayPal account includes an active credit card. |
* You can increase the profile amount by only 20% in each 180-day interval after you create the profile. | * You can increase the profile amount by only 20% in each 180-day interval after you create the profile. |
* For recurring payments with the Express Checkout API, PayPal does not allow certain updates, such as billing amount, within 3 days of the scheduled billing date. | * For recurring payments with the Express Checkout API, PayPal does not allow certain updates, such as billing amount, within 3 days of the scheduled billing date. |
| |
| There is also an additional limitation if you have subscriptions that are only intended to run once and never renew. For example, a subscription add to cart URL that looks like ''&sub_frequency=1m&sub_enddate=1m'', meaning the subscription will end on the same day that it is meant to next renew. In these instances, PayPal won't cancel that subscription correctly, but will instead continue to renew the subscription indefinitely. It will instead need to be cancelled manually. |
| |
<WRAP important round> | <WRAP important round> |
=== Part 3: Enable "Reference Transaction" Support === | === Part 3: Enable "Reference Transaction" Support === |
| |
<wrap important>This step is required only for the "PayPal (Reference Transactions)" payment option</wrap> | <wrap important>This step is required only for the "PayPal Commerce Platform" payment option</wrap> |
| |
Reference Transactions is PayPal functionality that allows FoxyCart to create a billing agreement with your store's customers who wish to pay with PayPal, to allow us to continue to charge your subscription customers at each renewal. It's not enabled by default though for your account, and so you need to contact PayPal to ask for it to be enabled. | Reference Transactions is PayPal functionality that allows FoxyCart to create a billing agreement with your store's customers who wish to pay with PayPal, to allow us to continue to charge your subscription customers at each renewal. It's not enabled by default though for your account, and so you need to contact PayPal to ask for it to be enabled. |
| |
For more details about recurring payments, please see [[https://developer.paypal.com/webapps/developer/docs/classic/express-checkout/integration-guide/ECGettingStarted/|PayPal's documentation]]. | For more details about recurring payments, please see [[https://developer.paypal.com/webapps/developer/docs/classic/express-checkout/integration-guide/ECGettingStarted/|PayPal's documentation]]. |
| ==== Authorize Only ==== |
| |
| If you would like to only authorize payments from customers, and then manually capture the funds later, this can be enabled using the "authorize only (do not capture funds)" checkbox. |
| |
| Note that enabling this option requires that you also grant API permissions for Foxy to be able to authorize payments on behalf of your account. Review the "[[#subscriptions_and_recurring_billing_with_paypal_express_checkout|Subscriptions and Recurring Billing with PayPal Express Checkout]]" section above, and in particular Part 2, for details on doing that. |
| |
==== PayPal Credit ==== | ==== PayPal Credit ==== |
| |