Adding PayPal Fastlane to Your Custom Checkout
Introduction
PayPal Fastlane accelerates checkout by auto-filling user information for millions of guest shoppers—no store or PayPal account required.
Important Considerations
Integrating Fastlane may require minor structural changes to your custom checkout. These adjustments generally enhance the checkout experience but should be considered when implementing:
Email Field: Move the email input to the top of your checkout UI, as it drives all Fastlane functionality. This prevents users from unnecessarily filling out information before Fastlane autofill kicks in.
Shipping and Billing Information: Replace existing address blocks with Fastlane components, as Fastlane provides pre-filled shipping and billing details, similar to Apple Pay or Google Pay.
Payment Information: Wrap existing payment inputs in a Checkout Condition, since Fastlane provides its own payment options, allowing users to select cards on file.
Fastlane Setup Instructions
Step 1: Position Email Field & Fastlane Activation
Move the Checkout Email element to the top of your checkout UI, or at least before any shipping/payment fields.
Checkout Email Settings:
Suppress PayPal Fastlane: No
Step 2: Add the PayPal Fastlane Watermark
Insert the CHECKOUT PAYPAL FASTLANE WATERMARK element near the email field, ideally in a panel, column, or flex element. This element (24px by 122px) informs users about Fastlane availability and is required.
Checkout PayPal Fastlane Watermark Settings:
Include Additional Info: Yes (adds an info icon linking to Fastlane details and privacy policy)
Download StoreFronts CJSON structure to import into your Custom Checkout
Step 3: Wrap Shipping Fields in Checkout Condition
Fastlane replaces user-input shipping fields. Therefore, wrap existing shipping fields in a Checkout Condition to hide them when users authenticate with Fastlane.
Note: Even though you are hiding these fields, Fastlane will pass the customer information into UltraCart so it can be used for shipping, billing and added to the customer data.
Wrap these fields if they exist in your checkout:
Checkout Shipping First Name
Checkout Shipping Last Name
Checkout Shipping Full Name
Checkout Shipping Title
Checkout Shipping Company
Checkout Shipping Address 1
Checkout Shipping Address 2
Checkout Shipping City
Checkout Shipping Country
Checkout Shipping State
Checkout Shipping Postal Code
Checkout Shipping Day Phone
Checkout Shipping Evening Phone
Checkout Condition Settings:
Matches: No
Condition: PayPal Fastlane authenticated
Download StoreFronts CJSON structure to import into your Custom Checkout
Step 4: Add Fastlane Shipping Address Element
Create a new Checkout Condition immediately before or after the condition hiding your shipping fields. This new condition shows only when users authenticate via Fastlane.
Checkout Condition Settings:
Matches: Yes
Condition: PayPal Fastlane authenticated
Inside this condition, add the Checkout PayPal Fastlane Shipping Address element to display the user’s selected address from Fastlane. Format it to blend seamlessly with your checkout design.
Also include a button element for users to edit their Fastlane address (choose a different address or add a new one).
Button Settings:
Button Action: PayPal Fastlane Address Book
Optional: Add another PayPal Fastlane Watermark here (without additional info icon) to clarify the address source.
Checkout PayPal Fastlane Watermark Settings:
Include Additional Info: No
Step 5: Wrap Billing Fields or Toggles in Checkout Condition
Billing information is provided by Fastlane, so hide any billing address fields or "billing address different" toggles when Fastlane is authenticated.
Checkout Condition Settings:
Matches: No
Condition: PayPal Fastlane authenticated
Step 6: Wrap Credit Card Fields in Checkout Condition
Fastlane handles payments, so existing payment method inputs must be hidden when authenticated.
Checkout Condition Settings:
Matches: No
Condition: PayPal Fastlane authenticated
Step 7: Add Fastlane Credit Card Element
Create another new Checkout Condition before or after your hidden payment fields condition. Display this condition when users authenticate with Fastlane.
Checkout Condition Settings:
Matches: Yes
Condition: PayPal Fastlane authenticated
Inside, add the Checkout PayPal Fastlane Credit Card element. This displays the user’s default credit card from Fastlane and allows switching to another stored card, along with the Fastlane logo.
Final Notes
These steps may vary slightly based on your checkout's customization level, but they outline the essential structure for integrating PayPal Fastlane into your custom checkout process smoothly.