Custom

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.

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

📘

UI Customization Options

The logo is the only part of the UI you can customize. For full control over the PIN collection experience, use a Forage SDK.

How it works

Tokenize an EBT PAN (card number)

Check the balance of an EBT account

⚠️

Balance Inquiry Restrictions

If your site offers a guest checkout option, skip this step of the Custom checkout flow. FNS prohibits balance inquiries on sites with guest checkout.

If guest checkout isn’t offered, adding a balance check is optional. No FNS regulations apply.

Capture a payment

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

• Build a Custom Checkout integration
• Consider other integration types: Fully Hosted, Forage JS