HomeGuidesReference
Log In
Guides

A Custom integration embeds a UI component into your website or app that collects an EBT Card PIN to perform a balance check and/or process EBT SNAP and EBT Cash payments.

With a Custom integration, you use Forage for EBT only. You need to integrate a separate credit/debit card TPP, like Stripe, to process credit/debit payments and to handle split tender. You're also responsible for handling taxes and complex associated error scenarios independently of Forage.

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

949

An example EBT PIN collection component for a balance inquiry

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

💡

The logo is the only customizable part of the UI. To have complete control over the look and feel of the PIN collection experience, use one of the Forage SDKs.

How it works

Tokenize an EBT PAN (card number)

A diagram of the process to tokenize an EBT Card with Forage

Check the balance of an EBT account

🚧

FNS prohibits balance inquiries on sites that offer guest checkout.

Skip this step of the Custom checkout flow if your site offers a guest checkout option.

If your site doesn't offer guest checkout, then it's up to you whether or not to add a balance inquiry feature. No FNS regulations apply.

A diagram of the process to create a Forage Balance Session

Capture a payment

A diagram of the Forage Custom Payment Capture session

Requirements

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

  • Field 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

Next steps