Set up

Prerequisites

Before you start building with Forage JS, make sure that you’ve done the following, if you haven't already:

  1. Sign up for a Forage account
  2. Register an app
  3. Generate an authentication token and a session token

You'll need a session token and your FNS number, to initialize Forage JS.

🚧

Authentication tokens should only be used on the client side during testing and development. Do not use them in production on the client. Authentication tokens can be used safely for any API requests originating from your backend server.

📘

For more information on authenticating with Forage, check out the authentication guide.

Include Forage JS

Add a <script> tag

Include the below Forage JS <script> tag on every page that handles an EBT checkout operation:

<script type="text/javascript"
    src="https://prod-forage-sdk.s3.us-west-2.amazonaws.com/versions/1.1.1/sdk.js"
    charset="utf-8">
</script>

If you’re using a frontend library like React or a framework like Vue, then you most likely only need to include the tag once in your index.html file.

Or, install the npm package

From your project directory, run:

npm install forage-js-sdk