Skip to content

Conversation

@bc-Vince
Copy link
Contributor

@bc-Vince bc-Vince commented Dec 19, 2025

Created guide article from original PayPal team Google Doc

DEVDOCS-6611

What changed?

  • The Dev Center now includes a guide to integrating Fastlane by PayPal in older versions of Open Checkout.

Release notes draft

  • We've created a guide to integrating Fastlane by PayPal with your custom checkout. This provides requirements and setup steps for configuring Fastlane in earlier versions of checkout-js.

Anything else?

ping @bc-terra @nkostohryz

…eckout

Created guide article from original PayPal team Google Doc
@bc-Vince bc-Vince added ready for review This PR is complete and awaiting a review. need-SME-review A subject matter expert is needed to review. labels Dec 19, 2025
Copy link

@github-actions github-actions bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Remaining comments which cannot be posted as a review comment to avoid GitHub Rate Limit

remark-lint

docs/storefront/cart-checkout/integrating-fastlane.mdx|83 col 138| Fastlane is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|100 col 26| De-initialize is misspelt; did you mean Reinitialize? retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|114 col 37| Fastlane is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|118 col 45| Fastlane is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|120 col 15| Fastlane is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|122 col 55| Fastlane is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|124 col 24| Fastlane is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|126 col 14| Fastlane is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|126 col 117| Fastlane is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|126 col 363| Hard to read sentence (confidence: 4/7) retext-readability retext-readability
docs/storefront/cart-checkout/integrating-fastlane.mdx|126 col 228| Fastlane is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|128 col 62| Fastlane is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|130 col 45| Fastlane is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|130 col 117| Fastlane is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|130 col 139| CustomerFastlaneData is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|182 col 32| Fastlane is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|184 col 13| Fastlane is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|184 col 51| Fastlane is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|219 col 32| Fastlane is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|225 col 26| De-initialize is misspelt; did you mean Reinitialize? retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|237 col 237| de-initialization is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|241 col 37| Fastlane is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|245 col 45| Fastlane is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|247 col 15| Fastlane is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|249 col 14| Fastlane is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|251 col 22| Fastlane is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|253 col 38| Fastlane is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|253 col 94| Fastlane is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|253 col 228| Fastlane is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|260 col 49| Fastlane is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|262 col 22| Fastlane is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|264 col 42| Fastlane is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|269 col 11| Fastlane's is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|269 col 94| Fastlane is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|269 col 146| Fastlane is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|269 col 325| Fastlane is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|273 col 170| Fastlane is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|303 col 78| Fastlane is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|318 col 32| Fastlane is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|320 col 56| Fastlane is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|332 col 32| Fastlane is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|334 col 82| Fastlane is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|334 col 135| Fastlane is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|336 col 13| 4a is misspelt; did you mean 4, a, ca, ea, fa, ha, la, ma, pa, ta, ya? retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|336 col 27| Fastlane is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|351 col 13| 4b is misspelt; did you mean 4, b, ab, db, lb, ob, tb, vb? retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|357 col 13| 4c is misspelt; did you mean 4, c, ac, cc, dc, kc? retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|357 col 34| Fastlane is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|361 col 26| De-initialize is misspelt; did you mean Reinitialize? retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|363 col 70| de-initialize is misspelt; did you mean reinitialize? retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|369 col 74| de-initialization is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|373 col 61| Fastlane's is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|375 col 15| Fastlane is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|377 col 14| Fastlane is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|379 col 15| Fastlane is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|381 col 14| Fastlane is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|383 col 15| Fastlane is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|385 col 14| Fastlane is misspelt retext-spell retext-spell

Copy link

@github-actions github-actions bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Remaining comments which cannot be posted as a review comment to avoid GitHub Rate Limit

remark-lint

docs/storefront/cart-checkout/integrating-fastlane.mdx|262 col 22| Fastlane is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|264 col 42| Fastlane is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|269 col 11| Fastlane's is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|269 col 94| Fastlane is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|269 col 146| Fastlane is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|269 col 325| Fastlane is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|273 col 170| Fastlane is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|303 col 78| Fastlane is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|318 col 32| Fastlane is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|320 col 56| Fastlane is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|332 col 32| Fastlane is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|334 col 82| Fastlane is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|334 col 135| Fastlane is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|336 col 13| 4a is misspelt; did you mean 4, a, ca, ea, fa, ha, la, ma, pa, ta, ya? retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|336 col 27| Fastlane is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|351 col 13| 4b is misspelt; did you mean 4, b, ab, db, lb, ob, tb, vb? retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|357 col 13| 4c is misspelt; did you mean 4, c, ac, cc, dc, kc? retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|357 col 34| Fastlane is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|361 col 26| De-initialize is misspelt; did you mean Reinitialize? retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|363 col 70| de-initialize is misspelt; did you mean reinitialize? retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|369 col 74| de-initialization is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|373 col 61| Fastlane's is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|375 col 15| Fastlane is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|377 col 14| Fastlane is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|379 col 15| Fastlane is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|381 col 14| Fastlane is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|383 col 15| Fastlane is misspelt retext-spell retext-spell
docs/storefront/cart-checkout/integrating-fastlane.mdx|385 col 14| Fastlane is misspelt retext-spell retext-spell


### Step 2: Initialize the customer step

To load the payment method configuration and initialize the Fastlane SDK for use across the entire checkout page, call `checkoutService.initializeCustomer` when a shopper opens the customer step.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ [remark-lint] reported by reviewdog 🐶
Fastlane is misspelt retext-spell retext-spell

});
```

### Step 5: De-initialize the customer step

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ [remark-lint] reported by reviewdog 🐶
De-initialize is misspelt; did you mean Reinitialize? retext-spell retext-spell


### Default customer step example

The images below depict the Fastlane by PayPal customer step as it appears in the default checkout.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ [remark-lint] reported by reviewdog 🐶
Fastlane is misspelt retext-spell retext-spell


![The customer step of checkout](https://storage.googleapis.com/bigcommerce-production-dev-center/Fastlane-Guide/default-customer-step.png)

*The customer step of checkout with Fastlane implemented*

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ [remark-lint] reported by reviewdog 🐶
Fastlane is misspelt retext-spell retext-spell


*The customer step of checkout with Fastlane implemented*

![The Fastlane authentication modal](https://storage.googleapis.com/bigcommerce-production-dev-center/Fastlane-Guide/fastlane-authentication.png)

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ [remark-lint] reported by reviewdog 🐶
Fastlane is misspelt retext-spell retext-spell


*The Fastlane shipping component with several saved addresses*

## Configure Fastlane in the billing step

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ [remark-lint] reported by reviewdog 🐶
Fastlane is misspelt retext-spell retext-spell


## Configure Fastlane in the billing step

The only required change for Fastlane by PayPal in the billing step is to render the Fastlane logo under the billing address. The logo should only appear if the selected billing address is associated with the shopper's Fastlane account. This is how the logo appears in the billing step of the default checkout.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ [remark-lint] reported by reviewdog 🐶
Fastlane is misspelt retext-spell retext-spell


## Configure Fastlane in the billing step

The only required change for Fastlane by PayPal in the billing step is to render the Fastlane logo under the billing address. The logo should only appear if the selected billing address is associated with the shopper's Fastlane account. This is how the logo appears in the billing step of the default checkout.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ [remark-lint] reported by reviewdog 🐶
Fastlane is misspelt retext-spell retext-spell


## Configure Fastlane in the billing step

The only required change for Fastlane by PayPal in the billing step is to render the Fastlane logo under the billing address. The logo should only appear if the selected billing address is associated with the shopper's Fastlane account. This is how the logo appears in the billing step of the default checkout.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ [remark-lint] reported by reviewdog 🐶
Fastlane is misspelt retext-spell retext-spell

In [step 2](#step-3-render-the-fastlane-by-paypal-watermark) of the Customer Step instructions, we provided an example of how you can render the logo SVG file. You can also review the Checkout JS repository for examples of how to:

* [Render the logo in the billing address component](https://github.com/bigcommerce/checkout-js/blob/3ed0ee63a9fc789e18672c93e4f18734ee3402ae/packages/core/src/app/billing/StaticBillingAddress.tsx#L39)
* [Conditionally display the logo under Fastlane addresses](https://github.com/bigcommerce/checkout-js/blob/3ed0ee63a9fc789e18672c93e4f18734ee3402ae/packages/paypal-fastlane-integration/src/is-paypal-fastlane-address.ts#L31)

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ [remark-lint] reported by reviewdog 🐶
Fastlane is misspelt retext-spell retext-spell

Copy link

@nkostohryz nkostohryz left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Approved. Reviewdog left a couple of fixes, please check.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

need-SME-review A subject matter expert is needed to review. ready for review This PR is complete and awaiting a review.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants