README.md

Fastlane Sample Application

This sample app demonstrates how to integrate with Fastlane using PayPal's REST APIs.

Before You Code

1. Setup a PayPal Account

   To get started, you'll need a developer, personal, or business account.

   Sign Up or Log In

   You'll then need to visit the Developer Dashboard to obtain credentials and to make sandbox accounts.

2. Create an Application

   Once you've setup a PayPal account, you'll need to obtain a Client ID and Secret. Create a sandbox application.

How to Run Locally

1. Clone the repository by running the following command in your terminal:

   git clone https://github.com/paypal-examples/fastlane-sample-application.git
   

2. Copy the .env.example file from the server folder and paste it into the folder for the server technology you want to use as .env. For example (substitute node for the technology of your choice):

   cd fastlane-sample-application/server
   cp .env.example node/.env
   cd node
   

   To run this application, you will need this folder and the shared folder. The other folders under server can be safely deleted or ignored.
3. Open the .env file in a text editor and replace the placeholders with the appropriate values.
4. To run the server, follow the instructions in your chosen folder's README.
5. To view the application in your browser, choose a front-end implementation from the client folder at the root of this repository and follow the instructions in that folder's README.

Client Integrations

Quick Start Integration

Overview

Fastlane Quick Start Integration uses PayPal's pre-built UI for payment collection, thereby allowing you to integrate quickly and easily. The Fastlane Payment Component will automatically render the following:

1. Customer's selected card and "Change" link which allows users to choose a different saved card or use a new card (for Fastlane members)
2. Credit card and billing address fields (for Guest users or for Fastlane members who don't have an accepted card in their profile)

Key Features

• Quickest way to integrate Fastlane
• Pre-formatted display to show Fastlane members their selected payment method
• Payment form including billing address for Guest users
• Data Security: Quick Start Integration is PCI DSS compliant, ensuring that customer payment information is handled securely

Flexible Integration

Overview

Fastlane Flexible Integration allows you to customize and style your payment page according to the look and feel of your website. The Fastlane Card Component renders input fields for Guest users to enter their credit card details, while the Card Selector provides an interface for Fastlane members to choose a different saved card or use a new card. You will be responsible for:

1. Showing the selected payment method, the Fastlane watermark, and a button to open the Card Selector (for Fastlane members)
2. Collecting billing address information and rendering the Fastlane Card Component (for Guest users and Fastlane members who don't have an accepted card in their profile)

Key Features

• Further customize the behavior and experience of your checkout
• Data Security: Flexible Integration is PCI DSS compliant, ensuring that customer payment information is handled securely

Running on Codespaces

Follow below steps to use Codespaces.

1. Click "New with options..." to open a page where you can choose the Dev container to run.

2. Choose the Dev container to run

3. Client ID and Client Secrets are required for running the application in codespace.

Link to codespaces

Application	Codespaces Link
Angular + Dotnet
Angular + Java
Angular + Node
Angular + PHP
Angular + Python
Angular + Ruby
HTML + Dotnet
HTML + Java
HTML + Node
HTML + PHP
HTML + Python
HTML + Ruby
Vue + Dotnet
Vue + Java
Vue + Node
Vue + PHP
Vue + Python
Vue + Ruby

Learn more

You can read more about codespaces in the PayPal Developer Docs.

Feedback

• To report a bug or suggest a new feature, create an issue in GitHub.
• To submit feedback, go to PayPal Developer Docs and select the "Feedback" tab