Introduction

A Hosted integration embeds Forage-hosted EBT screens into your existing checkout flow. Each screen is one server-side API call and one redirect. Today you can add a balance check and PIN entry.

With a Hosted integration, you keep your existing credit/debit processor and handle split tender. You're also responsible for handling taxes and complex associated error scenarios independently of Forage.

Hosted is the best integration type for merchants that want to use Forage for EBT payments while minimizing changes to their existing checkout flow.

Features

• UI component for collecting an EBT Card PIN for a balance check or payment capture
• Error handling for EBT-related failures
• Customizable logo field

How it works

Tokenize an EBT PAN (card number)

Check the balance of an EBT account

⚠️

Balance Inquiry Restrictions

Customers checkout out as a guest are not permitted to perform balance checks by FNA regulation. Ensure you pass a cusomter_id when creating a balance session.

Capture a payment

Requirements

In addition to the universal prerequisites for working with Forage, if you're building a Hosted integration, then you're responsible for building the following features into your app:

• Collecting the customer's EBT card number
• UI for a customer to set EBT SNAP and EBT Cash amounts
• Credit/debit card processing
• Split tender
• Sales tax calculation that exempts the SNAP tendered amount

Coming Soon

Benefits summary, adjusting benefits, and benefits receipt are all in active development. This will enable Hosted Checkout to provide more functionality to shoppers while alleviating more of the compliance and maintenance burden from merchants.

Next steps

• Build a Hosted Checkout integration