Notify patron of fee/fine payment received

Scenario 1

Given a payment of a manual fee/fine charge
Allow the administrator to decide whether or not to notify the patron of payment received
Display checkbox with label "Notify patron"

—

Scenario 2

Given a checked "Notify patron" on a payment received modal
Allow the administrator to add a message for patron to be included on payment received notice (receipt)
Display additional field below checkbox, specifically a text input (multiple lines) labeled "Additional information for patron"
*Not displayed unless the user checks "Notify patron"

—

Scenario 3 Split to separate story UIU-944

Given a checked "Notify patron" on a new fee/fine charge
Send payment received (action) notice to patron (use notice defined by administrator in settings, see UIU-713)
Important note: Actual process for sending notice is still being determined--see issue UXPROD-1588!

—

Context

If the user selects "Charge and pay now" from a charge new manual fee/fine, then modal appears for Pay fee/fine.
The Pay fee/fine modal also appears via options from Fees/Fines History (button and ellipsis) and Fee/Fine Details (button).

~~~~~~~~~~~~~~~~~~~~~~~~~~~

DESCRIPTION

Background
When library staff creates a new manual fee/fine charge, the patron may not be present. In these cases, the patron needs to be notified that they have been charged a new fee/fine. For example, in a case where the patron has returned a book in a drop-off bin, and the book is later discovered to be damaged, the manual charge for damages may be a surprise to the patron. The library must notify the patron that they have been charged a fee for damages. In other situations, such as if the patron walks up to a desk to purchase a USB drive or SD card, or to rent a library carrel or locker, they will most likely pay at that moment and the transaction will be completed. The patron requested the manual charge and made the payment, so they don't need to be notified about the charge.

Similarly, the library also needs to be able to send a notice indicating receipt of payment or other action, such as waive, refund and/or transfer. (See stories UIU-710 and UIU-711 for reference.) The "Notify patron" checkbox on those screens (charge and pay) trigger a notice being sent and which notice is sent is setup on this settings screen. In the example above of the patron walking up to the desk to purchase a USB drive or SD card, or to rent a library carrel or locker, despite not needing a notice that they were charged a fee, the patron may be sent a notice that they paid the fee.

The patron notice templates are created in Settings=>Circulation=>Patron Notice Templates. When a patron notice template is created, it is assigned a "Category." This user story is concerned with patron notices that have a "Category" of "fee/fine action."

As part of UIU-713, the Fee/Fine Manual Charges table has been updated to add several new values (as show in attached mock-up Manual_Charge_Settings_NEW.png):
* Each "Fee/Fine Type" may have a "Charge notice" associate with it. The charge notice is what should be sent to the patron if the patron is charge that particular fee/fine.
* Each "Fee/Fine Type" may have a "Action notice" associate with it. The action notice is what should be sent to the patron if the patron is pays that particular fee/fine.
* Each "Fee/Fine Owner" may have a "Default charge notice" that should be used if the "Fee/Fine Type" does not have an associated "Charge notice."
* Each "Fee/Fine Owner" may have a "Default action notice" that should be used if the "Fee/Fine Type" does not have an associated "Action notice."
(This user story is concerned with "Action notice" and "Default action notice" only.)

Details
When the user invokes the "Pay fee/fine" modal, one of the following 3 options will apply...
1. If there IS an "Action notice" associated with the "Fee/Fine Type" in the Manual Charges table, display the "Notify patron" option as on and display the optional "Additional information for patron" box (as shown in attached screen mock-up Pay_Charge_NEW2.jpg).
2. If there IS NOT an "Action notice" associated with the "Fee/Fine Type" in the Manual Charges table, but there IS a "Default action notice" set for the "Fee/Fine Owner", display the "Notify patron" option as on and display the optional "Additional information for patron" box (as shown in attached screen mock-up Pay_Charge_NEW2.jpg).
3. If there IS NOT an "Action notice" associated with the "Fee/Fine Type" and there IS NOT a "Default action notice" set for the "Fee/Fine Owner", do not display the "Notify patron" option or optional "Additional information for patron" box (as shown in attached screen mock-up Pay_Charge_NEW3.jpg).

If the user de-selects the "Notify patron" option, display screen as show in attached mock-up Pay_Charge_NEW1.jpg.
If the user selects a different "Fee/fine type", follow the rules for the new "Fee/fine type".

If the user enters "Additional information for patron", it should be stored separately, but in the same location as "Additional information for staff."

Important note: Actual process for sending notice is still being determined--see issue UXPROD-1386!