💳 MSR90 Card Reader Setup for ClickBid Butler (Stripe.js Optimized)

This guide walks you through how to configure the MSR90 card reader for use with ClickBid’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

1. Download the MSR90 ConfigTools v2.22 from the Deftun Software page.

2. Install the tool on a Windows computer.

   • (A Mac configuration tool may be available in the future.)

     
3. Plug in your MSR90 card reader via USB (ClickBid card Reader)

📂Open MsrReader ConfigTools v2.22 after download

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

💳 2. Enable Only ISO Card Type

1. In the CARD_TYPE_ENABLE section:

   • Check: ISO Format

   • Uncheck: AAMVA, IBM, JIS-II, CADMV

⌨️ 3. Set the Keypress Mode

1. 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 ⬇️)

1. Under the Add ENTER dropdown:

   • Select: none

2. Optionally, check Beep: Enable if you want a sound after swiping. 

⚠️ 6. Handle Track Errors Gracefully

1. Under Send Data when TrackError, select:

   • Send Good Track Data only

🧩 7. Add a Pre-Card String

1. Go to the General Tab → STRING_DEFINE

2. Set PRE_CARD_STRING to: !@#$%^&*

3. Leave the following fields blank:

   • POST_CARD_STRING

   • EMPTY_MSG_STRING

   • ERROR_MSG_STRING

1. Go to the General Tab → TRACK_ID_ENABLE

2. Set each to Enable:

   • TK1 → Enable

   • TK2 → Enable

   • TK3 → Enable

💾 9. Save the Configuration

1. Click Download to apply the settings to the MSR90.

2. Wait for the confirmation message:

   • Programming flash ....................OK! 

🧪 Final Step: Test in ClickBid Butler

1. Open Butler and select any bidder profile to edit.

2. Click into the card number field.

3. Swipe a card.

4. Confirm that:

   • The card number appears correctly.

   • No extra characters spill into other fields.