PayPal
On this page
Supported features
- Standard checkout
- PayPal Fastlane, on the checkout payment step and as express checkout on the cart page
Payment provider configuration
StoreConnect uses PayPal’s Smart Payment Buttons.
To generate your credentials, follow these instructions from PayPal: Set Up Your Development Environment
- In StoreConnect go to the Payment Providers list.
- Select New and enter details for PayPal. See below.
- Select Save.
| StoreConnect Field | Usage |
|---|---|
| Provider | PayPal |
| API Mode | sandbox / production |
| API Key | Client ID |
| API Secret | Secret |
| API Options |
PayPal Fastlane
Fastlane is PayPal’s faster checkout for returning shoppers. A shopper PayPal recognizes by email confirms a one-time passcode sent to that email, then pays with a card they have already saved with PayPal, without being sent to paypal.com to sign in. Their saved shipping address is filled in for them.
A shopper PayPal does not recognize sees nothing different. The Fastlane section does not appear at all, and they check out with the standard PayPal buttons.
Before you start
- Ask PayPal to enable Fastlane and Vault on your PayPal business account. Vault is what lets PayPal store a shopper’s card against their profile for reuse, so Fastlane cannot recognize anyone without it.
- Contact PayPal to confirm that Fastlane is available for your shoppers’ region. PayPal decides which regions Fastlane is offered in, and the list changes over time. At the time of writing it covers the United States, the United Kingdom and Australia, on desktop and mobile web. Shoppers outside a supported region see the standard PayPal buttons whatever you configure.
Turn Fastlane on
- Open the Payment Providers list and select your PayPal record.
-
Add this line to API Options:
```yaml
fastlane_enabled: true ```
-
If you want Fastlane on the cart page as well as at checkout, add this line too:
```yaml
express_checkout_enabled: true ```
- Select Save.
Fastlane now appears on the checkout payment step for recognized shoppers, and in the cart’s express checkout section if you added the second option.
:::note
To show Fastlane on the cart page, turn on both options. With express_checkout_enabled on and fastlane_enabled off, PayPal’s express checkout section on the cart renders nothing at all.
:::
What the shopper does
- At the checkout payment step, a recognized shopper sees their email with the Fastlane watermark and a Continue with Fastlane button. On the cart page they type their email into the express checkout section instead, and the button appears if PayPal recognizes it.
- They select Continue with Fastlane and enter the one-time passcode PayPal emails them.
- Their saved shipping address is applied to the order. Change opens PayPal’s own address picker, which offers only addresses in countries your store ships to. Changing the address refetches your shipping rates and shows a shipping method picker, keeping the service they had selected where it is still offered.
- Their saved card is shown in PayPal’s own component. Change opens PayPal’s card picker, where they can choose another saved card or add one. Card details stay inside PayPal and never reach your store or your Salesforce org.
- They select Pay Now, which completes the order.
If the shopper closes the passcode window, or the passcode check fails, the Continue with Fastlane button is removed and they see “PayPal Fastlane isn’t available for this email. Please use another payment method.” PayPal does not reopen the passcode window for that email until the page is reloaded, so the shopper finishes with another payment method: the standard PayPal buttons or another provider at checkout, or another wallet or the Checkout button on the cart page. Entering a different email that PayPal recognizes brings the button back.
To use a different email, the shopper edits their contact details at the customer information step.
To change the wording of the “PayPal Fastlane isn’t available for this email” message, add a Locale Translation (s_c__Locale_Translation__c) to your theme’s locale with the Key checkout.gateways.fastlane.errors.auth_unavailable and your text as the Value.
Limitations
- Fastlane covers the checkout payment step and the cart page. It is not offered in the mini-cart dropdown or on product pages.
- Shoppers PayPal does not recognize cannot enter card details through Fastlane. Inline card fields for guests are not available, so those shoppers use the standard PayPal buttons.
- Nothing changes for standard PayPal payments, refunds, or the standard buttons.
Was this article helpful?
Thanks for your feedback! It helps us improve our docs.