---
updatedAt: 2026-07-16T20:00:00.000Z
agentTools:
  projectIndex: https://docs.joinforage.app/llms.txt
---

# Introduction

Add EBT payments to your iOS app

<Callout icon="📘" theme="info">
  ### Looking for the Forage mobile app?

  Get instant EBT balance checks and access to exclusive grocery deals—download Forage on [iOS](https://apps.apple.com/us/app/forage-ebt-balance-savings/id6742527220) or [Android](https://play.google.com/store/apps/details?id=com.foragetechnologycorp.forage) and start saving today.
</Callout>

***

You can use the Forage iOS SDK to process EBT payments in your iOS app.

<Image src="https://files.readme.io/3f86014-iOS.png" alt="Two iPhone screens, one that prompts for an EBT PIN to process a payment, another that prompts for it to check a balance" align="center" />

## Features

* Native UI component for collecting and tokenizing a customer's EBT Card number (also called the card PAN)
* Native UI component for collecting a customer's EBT PIN
* Built-in EBT Card number validation
* Control over the styling of a native EBT checkout experience
* API methods that collect and tokenize an EBT Card number, perform a balance check, and capture a payment

## Requirements

Before you can use the Forage iOS SDK, make sure that you have:

* Met all [prerequisites for working with Forage](https://docs.joinforage.app/docs/overview#prerequisites)
* Signed up for an account. [Contact us](https://www.joinforage.com/contact) if you don't yet have one.
* Your app is built on the following:
  * iOS 13+
  * Swift 5

For more information, see:

* [Forage iOS Quickstart Guide](https://docs.joinforage.app/docs/ios-quickstart)
* [Forage iOS SDK on GitHub](https://github.com/teamforage/forage-ios-sdk)

## Starter code

After [setting up your development environment](https://github.com/teamforage/forage-ios-sdk#integration) and importing and initializing the SDK, include either or both of the UI components in your application's views.

For example, the following snippet adds the EBT Card number element `ForagePANTextField`:

```swift
private let foragePanTextField: ForagePANTextField = {
    let tf = ForagePANTextField()

    tf.borderColor = .black
    tf.borderWidth = 3
    tf.clearButtonMode = .whileEditing
    tf.cornerRadius = 4
    tf.font = .systemFont(ofSize: 22)
    tf.placeholder = "EBT Card Number"

    return tf
}()
```

Then, call the relevant method. The below snippet calls the method to tokenize an EBT PAN:

```swift
// Usage

ForageSDK.shared.tokenizeEBTCard(
    foragePanTextField: foragePanTextField,
    customerID: "<unique_id_for_your_customer>",
    reusable: true
) { result in
    // Handle result and error here
}
```

## Next steps

* Check out the [forage-ios-sdk](https://github.com/teamforage/forage-ios-sdk) GitHub repository for full installation instructions and a demo app

<br />

# Sibling pages

* [Quickstart](https://docs.joinforage.app/docs/ios-quickstart.md)
* [Style iOS Elements](https://docs.joinforage.app/docs/forage-ios-styling-guide.md)