Skip to main content

Why "Pay by Package" Isn't Appearing (and How to Fix It)

Understand and Resolve the Most Common Causes of a Missing Pay by Package Option

Written by Mari Bern

INTRODUCTION

Feature Summary: When a package is configured correctly, CourtReserve automatically presents the Pay by Package option after you (if processing on the admin side) or the member clicks Pay on an eligible transaction. This article walks through why the option might not appear even when a member clearly has punches remaining, and how to fix each possible cause.

Use Cases:

  • Troubleshoot a missing Pay by Package option at checkout

  • Confirm a package, activity, and member are correctly configured to allow punch redemption

  • Identify the two most commonly missed causes: Fee Responsibility settings and extra items on the transaction


OVERVIEW

The Pay by Package option only appears when a specific set of conditions is met at the same time. If even one condition is not satisfied, the option will not render on the payment screen, regardless of whether the package itself looks correctly set up.

Work through the checklist below in order. The last two causes are the ones most often missed, so do not stop early.


Troubleshooting Checklist

Confirm all of the following. The option only appears when every one is true:

  1. The member has a valid package with at least one punch remaining. A package showing 0 of X used will not appear.

  2. The package is paid for, or Allow Package to be Used While Unpaid is enabled on the package.

  3. The activity (court time, lesson, or event category) is listed in the package's Eligible Items, and the event category name matches exactly.

  4. Today's date falls within the package's active window (after the Start Date, before expiration).

  5. You are on the payment step. The option only appears after you click Pay, not before.

  6. The transaction contains only that one eligible activity and no other items (for example, no point-of-sale items).

  7. The package is assigned to the member attempting to use it (or to their family, if it is family-eligible).

  8. The activity's Fee Responsibility is not set to Each Player Equally.

If all eight are true and the option still does not appear, see Still Having Issues below.


The Two Most-Missed Causes

Most package troubleshooting stalls because these two conditions are easy to overlook. Check them first if the obvious things (punches, paid, eligible) already look correct.

1. Fee Responsibility is set to "Each Player Equally"

Packages will not redeem for reservation or event types where Fee Responsibility is set to Each Player Equally. They also will not redeem if the setting is Allow player to pay full or split equally and the member chooses the split-equally option.

This is a hard rule in the platform, not a configuration mistake. If the activity uses either of those fee settings, Pay by Package will never appear, no matter how the package is set up.

Note: To check, open the event or reservation type and review the Fee Responsibility setting. If it is Each Player Equally, that is why the option is missing. To allow package redemption, the activity needs a fee responsibility that assigns the full fee to the player, such as Reservation Owner or Player Pays.

2. The transaction includes more than one item

The Pay by Package option only appears when the transaction contains the single eligible activity by itself. If anything else is on the same transaction, such as a point-of-sale item like a drink, towel, or piece of merchandise, the package option will not show.

Note: To check, open the transaction and confirm the event or reservation is the only line item. Remove or process any point-of-sale items separately, then return to pay for the eligible activity on its own.


Detailed Fixes by Cause

Fix 1: Confirm remaining punches

Go to the member profile and click Billing > Packages. Click the Punches link to see total, used, and remaining punches. If it shows 0 remaining, the package is fully used.

Note: When a package reaches 0 punches remaining, it is automatically moved to Used/Expired, so it will no longer appear under the member's active packages or as a payment option. Check the Used/Expired tab to confirm, then add punches back or sell a new package before trying again.

Fix 2: Confirm the package is paid (or usable while unpaid)

Go to Settings > Billing Settings > Packages and open the package. If Allow Package to be Used While Unpaid is off, the member must pay for the package before punches can be redeemed. Either collect payment for the package or enable that setting.

Fix 3: Confirm eligibility and exact category-name match

Open the member's package details and review Eligible Items. Confirm the activity you are registering for is listed. Two things must line up here:

  • Exact name match: For events, the event category on the package must match the event's category name exactly, including spacing, hyphens, and capitalization. For example: a package eligible for "Red Ball Beginner" will not redeem for an event category named "Red ball - Beginner."

  • Matching duration: For court time and lessons, eligibility is set per type and duration combination. A package configured for a 60-minute booking will not redeem against a 90-minute booking of the same type. Each duration the package should cover must be added as its own row under the Court Time or Lessons tab. If a member is booking a duration that was never added to the package, Pay by Package will not appear even though the type matches.

If either the name or the duration does not match, edit the package to add the correct category or duration row under the appropriate tab, save, then use Update Existing Packages so the change applies to already-sold packages.

Fix 4: Confirm the active date window

Open the package and check the Package has a Start Date? and Package can Expire? settings. Confirm today's date, and the activity's date, fall inside that range.

Note: A package labeled for a given month is not necessarily active on the day you are testing if its start date or expiration says otherwise. For auto-assigned packages set to Assigned Month Only, punches expire at the end of the assigned calendar month.

Fix 5: Confirm you are at the payment step

On the admin side, go to Transactions, locate the member, and click Pay. The Pay by Package option only renders on the payment screen after clicking Pay. It does not appear on the registration or event list view beforehand.

Fix 6: Confirm the transaction has no other items

Make sure the eligible activity is the only line item on the transaction. Process any point-of-sale items separately.

Fix 7: Confirm assignment

In the member's Billing > Packages view, check the Assignment column. If the package was sold to an individual, only that member can redeem it. If it was sold to a family, only linked family members listed there can redeem it, and the package must have Eligible to Assign by Family enabled.

Fix 8: Confirm Fee Responsibility

Open the activity and confirm Fee Responsibility is not Each Player Equally, and that the member is not choosing a split-equally option. See The Two Most-Missed Causes above for detail.


Confirming it Worked

After a successful package payment, the transaction table shows the number of punches used and a Payment Type of Punch. You can also confirm this on the member's Billing > Packages screen, where the used-punch count updates and the Usage section lists the event, date, and punches deducted.

Note: If a member cancels an activity that was paid with a punch, the punch is not returned automatically. It appears under Transactions > Refunds > Pending Refunds and must be accepted by an admin to return the punch to the member. Once a pending refund is either accepted or refused, it no longer populates in the Refunds section. Accepted refunds can be tracked in the player's profile. Refused refunds cannot be tracked at this time.


Still Having Issues?

If all eight conditions are confirmed and Pay by Package still does not appear, capture a screenshot of the payment screen, the package's Eligible Items, and the activity's Fee Responsibility setting, then escalate to the CourtReserve support team so it can be investigated further.

Did this answer your question?