Connected Performance
Payments

Credits

Sell and manage session credits: credit packages, buying and granting credits, how credits are spent on bookings, expiry rules, refunds and the credit history ledger.

Overview

Credits are prepaid session tokens. An athlete buys a bundle of credits, then spends them booking sessions that accept credits.

Every credit movement is recorded in a ledger, so you can always trace where a balance came from.

Credits can be switched off entirely for an organization, which hides the Credit Packages menu, the credit section on athlete billing, and credit packages on the Marketplace.

How To

Create a credit package

  1. Go to Payments > Credit Packages and click Create package.
  2. Set:
    • Name and description
    • Credits — how many credits the buyer gets
    • Price
    • Type — One-time or Recurring (with an interval)
    • Expiry — days until the credits expire, or blank for no expiry
    • Features — bullet points for the checkout card
    • Locations — used for revenue reporting only
    • Status (Active / Draft) and Show on Marketplace

Credits themselves carry no restrictions: a credit is a credit anywhere in your organization. The locations on a package only affect how revenue is attributed in reports.

Sell credits

There are four ways an athlete ends up with credits:

RouteHow
MarketplaceThe athlete buys the package themselves. Requires a saved payment method.
Checkout linkCopy the package's public link and share it. A parent can pay and the credits land on the child's record.
MembershipPlans can include credits per billing cycle, granted on every successful charge.
Manual grantAdmin adds credits from the customer's Credits tab.

Note: paying a credit package invoice does not automatically grant credits. Sell credits through the Marketplace or a package link, or grant them manually after the invoice is paid.

Grant credits manually

  1. Open Payments > Customers, pick the customer, open the Credits tab.
  2. Click Add Credits, enter a positive number and an optional description.
  3. Save.

Manually granted credits never expire.

Set up a session to accept credits

On the availability block (session), turn on Accept credits and set the credit cost — how many credits one booking costs. Both are required; a session with one but not the other won't accept credits.

Credits are deducted immediately when the booking is made, not at session time.

Understand how credits are spent

  • A booking costs the block's fixed credit cost.
  • Spending is all-or-nothing by default: an athlete short by even one credit gets "Not enough credits. This session requires N credits." and the booking is refused.
  • If your organization allows overage, the booking goes through, all available credits are consumed, and the shortfall becomes a dollar amount owed, left as unpaid for the facility to collect.
  • Equipment rental fees are never payable with credits — they're always dollars on top. A fully credit-covered booking with an equipment add-on will still show as unpaid for the rental amount.
  • If a membership already covers the session, that wins and no credits are used.
  • Booking a series consumes credits per session, one deduction each. If the athlete runs out partway through, the sessions they could afford are still booked.

Understand expiry

Expiry is set per grant, at the moment credits are issued:

SourceExpiry
Credit packageThe package's expiry days, or never if blank
Membership, rollover offEnd of the current billing cycle (an explicit expiry can only make it sooner)
Membership, rollover onThe plan's expiry days, or never if blank
Manual admin grantNever
Booking refundNever

Credits are always consumed oldest grant first, so the batch closest to expiring is used up before newer ones.

Expired credits are removed by a nightly job and recorded in the ledger as an "expired" entry. No warning email is sent before expiry — the only visibility is the "Expire On" tile on the customer's Credits tab and the athlete's Billing page.

Changing a package's expiry setting doesn't retroactively change credits that were already granted.

Refund credits

  • Booking cancelled → all credits used for that booking are returned automatically, with no penalty and no proration. Returned credits never expire. The athlete's cancellation email mentions the returned credits.
  • Credit package refunded → the credits are clawed back, but only the ones that are still unspent. If the athlete already used half the package, only the remaining half comes back.
  • Expiry and manual grants can't be reversed; issue a new manual grant instead.

Staff (admins and coaches) can cancel a booking inside the cancellation window; athletes and parents can't. Either way, the credit refund is the same full amount.

Read the credit history

  • Customer detail > Credits tab — Credits available, Used, and next Expire On, plus the 10 most recent ledger entries.
  • See the full history opens the Credit History page: Date, Description, Type, Expires and Amount, with grants in green and debits in red.
  • For parent records, Credits held by linked athletes shows each child's balance with a details view.

Ledger entry types you'll see: package purchase, package refund, membership grant, session use, expiry, refund and manual adjustment.

Where athletes see their balance

  • Billing page — a Credit usage card with Total, Used and Remaining, a progress bar, and a Buy credits button.
  • Marketplace — a banner showing available credits.
  • Booking modal — the credit option shows "N available (costs M)" and is disabled if they can't afford it.

Tips

  • Set an expiry on packages you sell at a discount and leave rollover off on membership credits — otherwise balances accumulate indefinitely and become a liability.
  • Because credits are consumed oldest-first, an athlete holding both an expiring package and a never-expiring manual grant will spend the expiring one first. That's the behavior you want.
  • Cancelling and rebooking converts expiring credits into never-expiring credits. Watch for this if you see unusual cancellation patterns.

Troubleshooting

"This session does not accept credit bookings." The session is missing either the Accept credits toggle or a credit cost.

"No payment profile found. Cannot use credits." The athlete has no billing record yet. One is created the first time they're billed, or you can create it from Customers.

"Not enough credits." Credits are all-or-nothing unless overage is enabled for your organization.

An athlete paid for credits and the balance didn't change. If the purchase was made through an invoice, credits aren't granted automatically — add them manually. If it was a Marketplace or link purchase, note the transaction ID and contact support so the charge can be checked.

Credits never expire in our test environment. The expiry job only runs in the live environment. That's expected.

The "Expire On" date looks wrong. That tile is calculated from the most recent 20 ledger entries. On a very busy account an older batch about to expire can be missed. Open the full credit history for the complete picture.

Credits landed on the parent instead of the athlete (or vice versa). Which record receives credits depends on the purchase route. Checkout links can target a specific child; Marketplace purchases go to the buyer. Use the "Credits held by linked athletes" section to see both.

A cancelled booking didn't return credits. The refund runs after the cancellation and is not retried if it fails. Grant the credits back manually and report it.

A refunded package clawed back fewer credits than it granted. Only unspent credits are recoverable. The difference is a real cost — consider refunding the cash difference or leaving the balance as-is.

  • Booking Payments
  • Plans & Memberships
  • Customers & Payment Methods

Referenced by

On this page