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 XXXX9999XX XXXX XXXX XXXX9999XX XXXX XXXX XXX XX9999XX 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 4456 | Credit card failure |
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. |
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 |
👉 For more information on error handling and transaction simulation, refer to the Forage API errors documentation.
Updated 3 days ago