plaid-microservice

A Node access layer integration with Plaid for linking U.S. bank accounts.

Usage no npm install needed!

<script type="module">
  import plaidMicroservice from 'https://cdn.skypack.dev/plaid-microservice';
</script>

README

npm (scoped) NPM

plaid-microservice

A Node access layer integration with Plaid for linking U.S. bank accounts.

Tech

  • Node
  • Express
  • Plaid API

Config

Create a Plaid account and get your Plaid OAuth keys and define your redirect-uri's.

Environment

Copy .env.example to an .env file and add your Plaid OAuth keys and redirect-uri.

cp .env.example .env

Add your Plaid OAuth keys and redirect-uri's to the .env file.

# Get your Plaid API keys from the dashboard: https://dashboard.plaid.com/account/keys
PLAID_CLIENT_ID=your_client_id
PLAID_SECRET=your_secret
# Use 'sandbox' to test with fake credentials in Plaid's Sandbox environment
# Use 'development' to test with real credentials while developing
# Use 'production' to go live with real users
PLAID_ENV=sandbox
# PLAID_PRODUCTS is a comma-separated list of products to use when
# initializing Link, e.g. PLAID_PRODUCTS=auth,transactions.
# see https://plaid.com/docs/api/tokens/#link-token-create-request-products for a complete list
# Important: When moving to Production, make sure to update this list with only the products 
# you plan to use. Otherwise, you may be billed for unneeded products.
PLAID_PRODUCTS=auth,transactions
# PLAID_COUNTRY_CODES is a comma-separated list of countries to use when
# initializing Link, e.g. PLAID_COUNTRY_CODES=US,CA.
# see https://plaid.com/docs/api/tokens/#link-token-create-request-country-codes for a complete list
PLAID_COUNTRY_CODES=US,CA
# Only required for OAuth:
# Set PLAID_REDIRECT_URI to 'http://localhost:3000/plaid-redirect'
# The OAuth redirect flow requires an endpoint on the developer's website
# that the bank website should redirect to. You will need to configure
# this redirect URI for your client ID through the Plaid developer dashboard
# at https://dashboard.plaid.com/team/api.
PLAID_REDIRECT_URI=http://localhost:3000/plaid-redirect

Docker

Make sure Docker is running on your local dev environment.

docker -v

Build and run the Docker image with Make.

make up
  • TODO: Add Docker Image to Docker Hub.

CI/CD

  • TODO: Add full CI/CD
stages:
  - build
  - test
  - qa
  - staging
  - deploy