---
updatedAt: 2025-12-17T21:39:10.000Z
agentTools:
  projectIndex: https://docs.joinforage.app/llms.txt
---

# Test Cards

Simulate EBT and HSA/FSA transactions in your Forage integration with this complete list of test card numbers for sandbox validation and error handling.

Use this guide to simulate EBT and HSA/FSA transactions in the Forage sandbox environment. These test cards help developers verify transaction flows, validate error handling, and confirm integration behavior for both successful and failed scenarios.

# EBT Test Cards

Forage SDKs include built-in EBT Card Number validation in both sandbox and production environments.

> ⚠️ Sandbox Use Only
>
> These test cards are for sandbox use only. Do not use them in production.

## Valid EBT Test Cards

Use any 16-, 18-, or 19-digit number starting with `9999` to simulate a successful EBT transaction:

* `9999 XXXX XXXX XXXX`
* `9999XX XXXX XXXX XXXX`
* `9999XX XXXX XXXX XXX XX`
* `9999XX XXXXXXXXXXXXX`

> 📘 Sandbox Balances
>
> All valid test cards include $1000 SNAP and $1000 EBT Cash. These balances reset one hour after the last transaction.

## Invalid EBT Test Cards

Use these to trigger specific failure scenarios.

### Balance Inquiry Exceptions

| EBT Test Card Number  | Description                                        |
| --------------------- | -------------------------------------------------- |
| `5555 5555 5555 5514` | Invalid card number                                |
| `5555 5555 5555 5554` | Expired card                                       |
| `6543 21XX XXXX XXXX` | $0 EBT Cash balance (simulate non-EBT Cash states) |

### Fully Hosted Exceptions

| EBT Test Card Number  | Description                             |
| --------------------- | --------------------------------------- |
| `3333 3333 3333 3345` | EBT succeeds, credit card portion fails |

### Payment Capture Exceptions

| EBT Test Card Number  | Description             |
| --------------------- | ----------------------- |
| `4444 4444 4444 4414` | Invalid card number     |
| `4444 4444 4444 4443` | Lost/stolen card        |
| `4444 4444 4444 4451` | Insufficient funds      |
| `4444 4444 4444 4454` | Expired card            |
| `4444 4444 4444 4455` | Invalid PIN             |
| `4444 4444 4444 4462` | Card restricted (fraud) |

### Refund Exceptions

| EBT Test Card Number  | Description             |
| --------------------- | ----------------------- |
| `4333 3333 3333 3311` | EBT Cash refund failure |
| `4333 3333 3333 3309` | SNAP refund failure     |

### PIN Validation Exception

| EBT Test Card Number  | Description                                         |
| --------------------- | --------------------------------------------------- |
| `6777 7777 7777 XXXX` | Use any `XXXX`. Incorrect PIN will trigger failure. |

### SDK Validation Exception

| EBT Test Card Number  | Description                                                                        |
| --------------------- | ---------------------------------------------------------------------------------- |
| `1111 1111 1111 1111` | Triggers SDK input validation error. See [input validation](https://docs.joinforage.app/reference/input-validation). |

### Miscellaneous Validation Exceptions

| EBT Test Card Number   | Description             |
| ---------------------- | ----------------------- |
| `1234 1234 1234 12345` | Unsupported card length |

***

# HSA/FSA Test Cards

Simulate successful and failed HSA/FSA transactions using these test cards in the sandbox.

> ⚠️ Sandbox Use Only
>
> These test cards are for sandbox use only. Do not use them in production.

## Valid HSA/FSA Test Cards

| Debit Card Number     | Description                              |
| --------------------- | ---------------------------------------- |
| `4000 0512 3000 2839` | Valid HSA/FSA card                       |
| `4000 0584 0000 0071` | Valid HSA/FSA card with partial approval |

## Invalid HSA/FSA Test Cards

| Debit Card Number     | Description                       |
| --------------------- | --------------------------------- |
| `4242 4242 4242 4242` | Valid format, not an HSA/FSA card |
| `4000 0000 0000 0069` | Expired card                      |
| `4000 0000 0000 0127` | Incorrect CVC                     |
| `4000 0000 0000 0341` | Authorization failure             |

***

:point\_right: For more information on **error handling** and **transaction simulation**, refer to the [Forage API errors documentation](https://docs.joinforage.app/reference/errors).

# Sibling pages

* [Classify Your Product Catalog](https://docs.joinforage.app/docs/catalog-assistant.md)
* [Defer EBT Payment Capture and Refund Completion to the Server](https://docs.joinforage.app/docs/capture-ebt-payments-server-side.md)
* [Process EBT SNAP refunds](https://docs.joinforage.app/docs/ebt-refunds.md)
* [Platform Settlement](https://docs.joinforage.app/docs/platform-settlement.md)
* [Receipts and Confirmation Screens](https://docs.joinforage.app/docs/receipts.md)
* [Restrict Forms of Tender](https://docs.joinforage.app/docs/supported-benefits.md)
* [Taxes](https://docs.joinforage.app/docs/about-taxes.md)
* [Navigating the EBT Chip Card Transition with Forage](https://docs.joinforage.app/docs/ebt-chip-card-transition.md)