Troubleshooting and FAQs

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.

FAQs

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:

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:

Explore: Best Practice Guide