Troubleshooting and FAQsanchor

Error condition How to handle
Authorization error while initializing fastlane This error indicates that your merchant account and your client credentials may not be fully provisioned for Fastlane. Talk to your account team for assistance.
Fastlane members not having cards or addresses
    • New cards should be added to the buyer's Fastlane profile.
    • Complete the order.
    • The Payment should be completed successfully with the new card.
FastlaneCardComponent.getPaymentToken() does not return a payment token Ensure that you are passing the required parameters formatted appropriately to the method.
The following methods return undefined: identity.triggerAuthenticationFlow(), profile.showShippingAddressSelector(), profile.showCardSelector() Fastlane has been disabled from within the PayPal dashboard.

Disablement Flow

If Fastlane has been disabled by the merchant, the Fastlane client SDKs are built such that the SDK will revert to the guest experience without the ability to opt-in to creating a Fastlane profile. This will ensure there is no interruption to your buyers.

In the event of Fastlane being disabled from the Braintree control panel, note that the following methods will return undefined.

  • identity.triggerAuthenticationFlow()
  • profile.showShippingAddressSelector()
  • profile.showCardSelector()

If you specify subdomains, wildcards, or protocols, the system generates an error.

FAQsanchor

How do I integrate Fastlane if I have store pick-up?

If the buyer is picking up an item from a store-front, then the shipping type should be modified accordingly.

Ensure shipping method is set to pickupInStore or shipToStore to ensure that the buyer profiles don’t get created with the address of your store as their shipping address.

How do I vault transactions with Fastlane?

  • Transact and Vault:

If you wish to vault the paymentToken returned by the Fastlane SDK at the time of transaction, you can do so by using the store_in_vault_on_success boolean in the transaction.sale() request on your server. Please see the Braintree Transaction Sale API request for reference.

  • Vault and transact:

If you wish to vault the paymentToken returned by the Fastlane SDK and transact later, you can do so by using the customer create API request or payment method create API request.

Is there any directive I need to include in my Content Security Policy (CSP)?

Add *.paypal.com to your CSP (skip if using Hosted Card Fields)

CSP is a feature of web browsers that mitigates cross-site scripting and other attacks. By limiting the origins of resources that may be loaded on your page, you can maintain tighter control over any potentially malicious code. While browser support is relatively limited, we recommend considering the implementation of a CSP when available. Include the following directive in your policy:

Sandbox Production
frame-src *.paypal.com *.paypal.com

Also, review Braintree's best practices and troubleshooting guide.

Will Fastlane work if I vault payer's payment methods?

Yes, the paymentToken that is returned to the client can vaulted. Be aware that we only support vaulting when using the store_in_vault_on_success boolean in the transaction.sale() request.

Fastlane does not support a flow where a customer or payment_method is created prior to a transaction. We hope to support this in a future release.

How long is a paymentToken valid for?

A paymentToken is valid for 3 hours from the time of issuance.

What if the payer's shipping address is in a location that my site does not ship to?

When you initially call braintree.fastlane.create() you have the option of passing in a list of allowed locations using the addressOptions object. Please see the reference types section for details.

How should I handle cases where a payer navigates away from the checkout page to add or remove items?

It is best practice to call the triggerAuthenticationFlow() method every time the checkout page is reloaded. There is internal logic within our SDK that will determine whether we will require the payer to authenticate via OTP again or simply restore the session. In either case, the method will return the authenticatedCustomerResult . This will also include a new paymentToken.

I am located outside the US, can I test Fastlane?

Fastlane is only available to payers in the US. If you are located outside the US, you will need to use a VPN to test the payer flows.

What are the best practices that I should adhere to when integrating Fastlane with PayPal

Please refer to our Fastlane Best Practice Guide for details on creating the best buyer experience.

When should I use quick-start Payment integration vs. Flexible integration?

The following table outlines the differences between the two payment integration patterns:

Payment Integration Flexible Payment Integration
What is this integration What is this integration
Payment Integration loads a PayPal pre-built template form to collect payments Flexible Payment Integration allows you to customize the form per your webpage layout and styling.
When to use this pattern When to use this pattern
You prefer light integration effort You want to handle billing address on your own.
Payment component UI does not fit your page layout / styling.
You will need to handle the following You will need to handle the following
Integrate the PaymentComponent Integrate the PaymentComponent
Rendering the selected card and “Change card”, Fastlane watermark Rendering the selected card and “Change card”, Fastlane watermark
Conditional logic to determine when to show card fields.
Render form fields to collect billing address and pass it to the transaction.

Explore: Best Practice Guide