Skip to main content

MySchoolBucks Management (iiQ Ticketing & iiQ Assets Modules)

MySchoolBucks Management (iiQ Ticketing & iiQ Assets Modules)

This knowledge base guide pertains to the enhanced writeback functionality of MySchoolBucks, which is only supported in the iiQ Ticketing and iiQ Assets modules.

If you are integrating MySchoolBucks with any other modules, please refer to the appropriate knowledge base guide for installation instructions.

​​​​​

This is an iiQ Premium App.

Integrating with MySchoolBucks simplifies the registration of fees and payments for users, tickets, and assets. This allows for easy generation of statements and checking balances. Through this integration, parents can view and pay technology fees and fines for their students when they log into the MySchoolBucks portal. Any payments made via MySchoolBucks will be automatically recorded in Incident IQ, ensuring that your records remain accurate and up-to-date.

Streamlined Payment Processing for Parents: Enable parents to view and pay all fees/fines in MySchoolBucks, simplifying payment and improving collection rates.

  • Improved Communication: Enable parents to opt-in to receive notifications for unpaid fees/fines through MySchoolBucks, reducing manual effort and improving communication.

  • Increased Efficiency and Transparency: Provide a unified view of fees/fines and payments for both schools and parents, improving transparency and efficiency.

  • Enhanced Financial Tracking and Reporting: Map fees/fines directly to General Ledger (GL) Account Codes, enabling more accurate financial reporting, simplifying reconciliation, and supporting better alignment with district accounting practices.

Important Considerations

  • The MySchoolBucks integration only supports Technology fees/fines for Students in the iiQ Ticketing or iiQ Assets modules.

  • Any payments for fees and fines in other modules (e.g. iiQ Events, iiQ Facilities, iiQ HRSD, and iiQ Resources) will continue to use the legacy integration in IncidentIQ that utilizes a shopping cart/checkout flow via a MySchoolBucks Store.

  • Additionally, any fees/fines in iiQ for staff or other non-student users will not appear in MySchoolBucks and will need to be marked as paid manually in Incident IQ.


Getting Started with MySchoolBucks

A couple of steps need to be taken before your district is ready to apply fines and fees using the MySchoolBucks integration.

Step 1: Contact MySchoolBucks

To begin, you will need to contact MySchoolBucks, email sales@heartlandschoolsolutions.com, and request that the Enhanced Incident IQ Integration be enabled for student Technology fees and fines.

  • A Business Development representative from MySchoolBucks will follow up to schedule a call with their implementation team. During this call, they will collect the information needed to initiate a project and configure the necessary fee/fine mapping.

Step 2: Create a MySchoolBucks API Service User

In your Incident IQ site:

Create a new user account specifically for the MySchoolBucks API (recommended username: MySchoolBucks_API_Service)

This user should not be tied to a real person and should have only the permissions required for the API to access fees, invoices, and payments.

Best Practice: Assign the minimum necessary permissions to the API user to reduce risk and maintain security.

Step 3: Generate an API Key

For the MySchoolBucks API Service User you just created:

  • Collect the following information to share with your MySchoolBucks rep:

    • API Key

    • API Key Expiration Date

    • User ID

    • Site ID

    • Product ID

    • API URL


Step 4: Complete Setup with MySchoolBucks

Your MySchoolBucks rep will complete the integration setup using the credentials and information you provided. Once they confirm that the integration is active, you’re ready to switch.



Settings Tab

You can set the number of days before a fee becomes overdue. There is an option to filter users, assets, or tickets with outstanding balances.



Item Category

Item Categories are the fines or fees categories (i.e., course fees, library fines, device insurance, athletics). Click on the Item Categories tab. Then click Add New Item Category. Enter the Title of the category, along with the Description. Click Save.

UVoY2b3iF9QSpsZBWil5RpOVsJwN5LDfyrdf59QnEPsqRp6N3G5N5MgpZjqQ28OSOk_X8yblIY5QZyzLq9ymldhWiZjjdVtC3fUHCDUL0_qruZuJOUMiZYJMiyOpfLUdrDkzmextuCijmlhJ6Q

When adding or editing an item category, you need to Re-Build Payment Data after making all your changes. Re-Build Payment Data is updating existing data for your grid column payment data to be displayed correctly. Click on Re-Build Payment Data.

jyElnohueacEgUqTsxjvW6sgI4FgYOnp-3_c5xlAxQscG0KpG14snpuKczTLoqlJzNSBYRlXjthXE2a9prnkdAKmNbiR-0YS7NqkCqI4-h3F8WljvHr9QNRCq314VdlOHJXxSH5FvFSlxGArJQ

You can Edit or Delete the category to the right.

PJLyPISeOGg3h1b9sriBimNlLLrL601d9P5LAL4xBmOXFda08_1SJMUmy0VpYY7Mx1qe3DFLfrc9IadohTOHRxWhn8zTiiOGAWtcdHYbdc0Kt0FWmO5aJyaHHowVARyR4qALfST5LFR1rOMfvg

Setting Up A Category Payment

You can pay a whole fee Category at once (including several fee types). First, you must create a fee Category and several Fee types belonging to the same Category. Fee Categories are set up on the Payment app > Item Categories tab. For example, a Room Rental Overages Category was created under which different room rental overage fees can be grouped.

AD_4nXdgqqX4OuJgKg_v7SMBdDyDLNmsjCrc4OagilPPh__fdMTB7G1tPFoIRXAIRnSC4J-ECeYKP4MAtJFBHyPXlGZ02RTK4v1uHkKI6VXE6nt8fL3Zc0VAdRija2llVPwF77wcK9f7_g?key=JZZKjZht5flYQTkSreEAfg

On the Item Types tab, you can create different fee types but assign them to the same Category.

In this example, three types of fees were created: Additional Hours—Tier 1, Additional Hours—Tier 2, and Additional Hours—Tier 3, and they were grouped under one Category: Room Rental Overages.

AD_4nXdiMRqvVVD4mxQG59DDrxHn_MhVtabHtErR0_B8O-cgqjMxiuJ-F4Gfeq2p8Ml9dXdHIjF440a81IfwWT24uC5qbtYNsHvxaRg-rz46nNXO2Mz0ZLeVusOOOV-OBCQ-Hx-dk6n4?key=JZZKjZht5flYQTkSreEAfg



Item Types

Item Types are the fees, payments, or adjustments associated with the Item Category. For example, under the Item Category library fines, you can have item types: overdue, damaged, lost.

Click on the Item Types tab. Then click Add New Item Type.

Next, you will need to fill out the following fields:

  • Sku*: required to enter the item has a Sku.

  • Title*: required to enter the item’s title.

  • Description: enter a description of the item.

  • Category*: required to select which category the item is associated with.

  • Type*: required to select the type: fee, fine, payment, adjustment.

    • Fines are punitive and are in response to something like damages. Such as broken chromebook

    • Fees are voluntary such as technology fees, club fees, and field trips.

  • Default Amount: enter the default amount. This can be changed when issuing the payment or fee.

Click Save.

You can Edit or Delete the item type to the right.


Export Tab

On the Export tab, you can Export All Transactions. This will generate an excel file containing all the transactions and information needed (SKU, category, name, description, amount, due date, and more.)

k4BLLo3F3ddxX3E1c2VHgLT7ijxR44WS-G70cyQQEt0Io6VM_TmKyzVx_BnyyZFW6FQn1Lg4GXHDZXslVrkGmXorHivuSddhvuoGm_qSn1ac_HyfLzCH_6D1h8AO7yjA7QoN-DXIl_njqtG8LA


Import Tab

On the Import tab, you can import fee data into the MySchoolBucks integration.

AD_4nXdTZyjL3pC_eC-1M8Gr91XyQMVkOXPmmM4ncgRzuxCeaZVKjLwqt08Cr1sbVIXapg2WjpK83U4CtbFTbyqbzBWV4-imU_rdRwtqp4q18Wjq-hV5zU8DUC6HNOzHq3Frf5aHCzHlx_QGuAqMNoo_wqCLKeKx?key=wcfkiwbtbkFvtgaE5AWIUA

Limit of 524,288 characters for input.

To import fee data, download the import template by selecting "Download import template."

Sku, SchoolId, and Email are required columns.

  • SKU is case-sensitive

  • Amount - If the amount is left blank, a $0 fee will be added instead of the default amount.

  • Due Date

    • If left blank, the date will be set to one month from the created date.

    • The due date needs to be validated; if the created date is later than the due date, the fee will be considered overdue upon import.

  • Created date - If left blank, it will be set to the import date.

AD_4nXdukXVS2XMuDMy4jM8CDt6ZzQnltG2e4nvkv9B6YnMVZV3e5mpeKVUgkv2O1UcvUUo6k548wgZTraIwFuyc1A_QuDQgIbWGXUckNoQnUqCafguVxSB4yHPhqXuhOE1bhBNBo1UwCnZFBpSoVXtoPJklpXd-?key=wcfkiwbtbkFvtgaE5AWIUA

Copy and Paste the data from the template into iiQ. Selecting Parse will configure/analyze the data.

AD_4nXfnZk0UcWTehqml1ZhJQMnoiXeVhbDwMHo0aAVzWXT4BlxJ3ypxDgkt9Nlm-IpTREnMTATTCZY4YcvWcMWwlASmmX1H1W6uTb-yTQ5jR47o4RpE1inmuoDFmhD749vF-N43Y25AAPKm1_MYO8dVxMec58Pv?key=wcfkiwbtbkFvtgaE5AWIUA

After you Parse the data, you will be taken Step 2, where selecting Pre-process will validate whether the line items can be created.

AD_4nXe33R-lUIsGQz4q5iEpTaPU9_bUgLsZM0h_8eZ9N8VnKLWNb9uNpXcilOZwGbWAHFhqUoEt4ypM-QhtZCP4awYaB-wnBqyrtJafmIeDyHciqq7NVpd2jYFMH3JYs5bPhUdElvu9pf65qX0Zt0G7b8TvVWcI?key=wcfkiwbtbkFvtgaE5AWIUA

If the line items can be imported you will see a green check to the right of the line, selecting Import will import the fee data. You will see the confirmation window at the top of the screen, and you will click Ok.

AD_4nXdgi4kXxrbVNQNVkF6skqWGJfZmSBLgzC28RnA_8in5FzqafGIykFULii2YqgL0JgDZUrpW53ZtUonI0uAEWOFLP484IwgjkUKaUQ5iBxx_Med0bRxlO_9IG6V1lXyVkSUnbNRjqFSm9ysY5BJnYYX-O-df?key=wcfkiwbtbkFvtgaE5AWIUA


Customize MySchoolBucks Emails

In MySchoolBucks Payments email statements, you can include district-specific details and use variable data points to personalize the emails sent to parents, students, and other recipients. To do this, you will go to the MySchoolBucks Payments app and navigate to the Customize Emails tab.

This feature is product-specific, meaning the changes the user makes in the MySchoolBucks Payments statement in Facilities, for example, will not affect it in Ticketing.

The WYSIWYG editor will prevent users from saving messages that contain malicious script tags. It will display an error prompting users to remove any HTML script tags.

Email Preview

The full list of supported data points can be found in the linked article below:

The email will include any variables or content added in the Customize Email Statements section.

If no variable data points or content is added in the Customize email statements sections, the email sent will look like this.

AD_4nXefoYSKI_9mYAeBc_eu1iPbtxAP7F2LSjV6r0W-XDgUrUNML0dH8haCSSiOdgbVoM_aEZe8oMbNzlouhz3rSom-v_OC-qUbDgOGldkNIu8hsORhlZbk0LM_1WdjFRTKwB027hnBiw?key=V3huu8PNzDTnIy6BOjtiYg


Permissions

Under the Permission tab, you have access to limit which users can:

  • Create Payment or Fee

  • Delete Payment or Fee

  • Edit Payment or Fee

---

Hannah Bailey - Director, Customer Engagement

Did this answer your question?