When a payment is returned or fails after it has already been recorded, you can handle the correction in Spraye using a simple two-step process: delete the failed payment record to revert the invoice to unpaid, and apply a custom fee using a negative coupon modifier.


Follow the step-by-step instructions below to update your records.


Step 1: Delete the Returned Payment


Removing the recorded payment will instantly restore the customer's balance due on that specific invoice.

  1. Click on the specific Invoice Number on the Active Invoices page to edit the invoice.
  2. Inside the invoice view, scroll down the left-hand side panel to the Recorded Payments section.
  3. Locate the payment that was returned and click the Waste Basket (Delete) icon next to it.
  4. Confirm the deletion.




Note: The invoice status will automatically revert back to Unpaid, making it active for collection again.


Step 2: Add a Returned Payment Fee


Spraye allows you to pass along return fees by using a unique "negative coupon" function, which adds a set dollar amount to the invoice total rather than discounting it. This option can be used to recoup the amount if you were charged a Returned Payment Fee by your card processor. 


Create the Fee in Your Settings (One-Time Setup)


If you haven't created a return fee coupon yet, set it up globally so you can use it anytime:

  1. Navigate to Global Settings from your main dashboard menu.
  2. Select Coupons and click Create Coupon.
  3. Name the coupon clearly (e.g., "Returned Payment Fee" or "NSF Fee").
  4. In the amount field, enter the fee as a negative number (for example: $-25).
  5. Save the coupon.


Apply the Return Fee to the Invoice

  1. Return to the unpaid invoice where you just deleted the payment.
  2. Locate the Coupon dropdown selector on the invoice.
  3. Select your Returned Payment Fee (e.g., $-25) from the list.
  4. Save or update the invoice.


The system will interpret the negative value as an additional charge, successfully adding the fee to the customer's total amount due.