MSR90 Card Reader Setup for HelloFund

This guide walks you through how to configure the MSR90 card reader for use with HelloFund’s Butler tool and Stripe.js. It ensures that card swipes are clean, secure, and formatted correctly for processing donations or check-in actions during your event.

This setup disables unnecessary data tracks, adds specific formatting, and prevents unwanted characters from interfering with Butler’s input fields.

🛠️ 1. Install the MSR90 Configuration Tool

Download the MSR90 ConfigTools v2.22 from the Deftun Software page.
Install the tool on a Windows computer.
- (A Mac configuration tool may be available in the future.)
Plug in your MSR90 card reader via USB (HelloFund card Reader)

📂Open MsrReader ConfigTools v2.22 after download

Open the file in your downloads
Select "Extract all"
Select the application
Open MsrReader ConfigTools v2.22

💳 2. Enable Only ISO Card Type

In the CARD_TYPE_ENABLE section:
- Check: ISO Format
- Uncheck: AAMVA, IBM, JIS-II, CADMV

⌨️ 3. Set the Keypress Mode

In the KEYPRESS_MODE section:
- Select: KEY_MAP (For USA Keyboard)
- Set Key Delay Time (ms) to: 1

🧾 4. Configure Track Settings (ISO Tab)

🚫 Track 1 — Disable Completely

Uncheck:
- Start Sentinel
- End Sentinel
- LRC Data
Leave PREFIX and SUFFIX blank

✅ Track 2 — Enable with Custom Prefix

Check:
- Track 2
Uncheck:
- Start Sentinel
- End Sentinel
- LRC Data
Set PREFIX to: ^^^^^^^^ (8 of them)
Leave SUFFIX blank

🚫 Track 3 — Disable Completely

Uncheck:
- Start Sentinel
- End Sentinel
- LRC Data
Leave PREFIX and SUFFIX blank

All boxes together it will look like this ⬇️

🔔 5. Set Beep and Enter Key Options (See image below ⬇️)

Under the Add ENTER dropdown:
- Select: none
Optionally, check Beep: Enable if you want a sound after swiping.

⚠️ 6. Handle Track Errors Gracefully

Under Send Data when TrackError, select:
- Send Good Track Data only

🧩 7. Add a Pre-Card String

Go to the General Tab → STRING_DEFINE
Set PRE_CARD_STRING to: !@#$%^&*
Leave the following fields blank:
- POST_CARD_STRING
- EMPTY_MSG_STRING
- ERROR_MSG_STRING

⚙️Go to the General Tab → TRACK_ID_ENABLE

Set each to Enable:
- TK1 → Enable
- TK2 → Enable
- TK3 → Enable

💾 9. Save the Configuration

Click Download to apply the settings to the MSR90.
Wait for the confirmation message:

🧪 Final Step: Test in HelloFund Butler

Open Butler and select any bidder profile to edit.
Click into the card number field.
Swipe a card.
Confirm that:
- The card number appears correctly.
- No extra characters spill into other fields.