Log In

Initialize Forage JS


Forage(ForageConfig) creates a Forage instance. A Forage instance interacts with the Forage server. You need a Forage instance before you can create an EBT Element and perform EBT checkout operations.

The constructor requires a ForageConfig object as its only parameter.

ForageConfig fields



stringA unique Merchant ID that Forage provides during onboarding onboarding preceded by "mid/". For example, mid/123ab45c67. The Merchant ID can be found in the Forage Sandbox or Production Dashboard.


stringThe session token that your backend generates to authenticate your app against the Forage Payments API. The token expires after 15 minutes.


stringA unique ID for the end customer making the payment.

If you use your internal customer ID, then we recommend that you hash the value before sending it on the payload.
appearance?objectA set of global styles that is applied to every EBT Element. Supported values include:

* variables (parent key):
- borderRadius
- boxShadow
- colorBackground
- colorPlaceholderText
- colorText
- fontFamily
- fontLineHeight
- fontSizeBase
- fontWeightNormal
- padding

Example: Create a Forage instance

const forage = Forage({
  merchantId: 'mid/123ab45c67',
  // NOTE: The following line is for testing purposes only and should not be used in production.
  // Please replace this line with a real hashed customer ID value.
  customerId: btoa(Math.random().toString()),
  appearance: {
    variables: {
      borderRadius: '8px'