1. Credits
Bardge API (V3)
  • Introduction
  • Authentication
  • Errors
  • Idempotent Requests
  • Pagination
  • Passes
    • Introduction
    • Get All Reseller Passes
      GET
    • Issue a pass
      POST
    • Update user's pass
      POST
    • Update user's pass expiry
      POST
    • Get User Pass Details
      GET
  • Providers
    • Introduction
    • Get providers
      GET
    • Get providers for a pass
      GET
  • Access Codes
    • Introduction
    • Generate dynamic access code
      POST
  • Bookings
    • Introduction
    • Get class categories
      GET
    • Get classes
      GET
    • Get class with instances
      GET
    • Initiate a class booking
      POST
    • Confirm a class booking
      POST
    • Initiate a spa booking
      POST
    • Confirm a spa booking
      POST
    • Get client bookings
      GET
    • Get booking status
      GET
    • Cancel a booking
      POST
  • Co-pay
    • Introduction
  • Credits
    • Introduction
    • Purchase credits
      POST
    • Get credit packages
      GET
  • Lookup
    • Introduction
    • Get issuers
    • Initiate a lookup
    • Verify a lookup
    • Get a client
    • Get client credits
  • Schemas
    • PasscodeV3Request
    • PurchaseSpaCoPayV3Request
    • LookupInitiateV3Request
    • ResellerV3PasscodeResponse
    • ErrorDetail
    • ResellerV3ErrorResponse
    • LookupV3Response
    • ResellerV3SpaCoPayPurchaseResponse
    • LookupVerifyV3Request
    • SpaCoPayQuoteV3Request
    • IssuePassV3Request
    • PassRef
    • ResellerV3SpaCoPayQuoteResponse
    • CategoryDetails
    • ResellerV3IssuedPassResponse
    • UpdateIssuedPassExpiryV3Request
    • ResellerV3IssuedPassMessageResponse
    • UpdateLookupEnabledRequest
    • UpdateIssuedPassV3Request
    • PurchaseGymCoPayV3Request
    • PurchaseCoPayPackageV3Request
    • PurchaseCreditsV3Request
    • ResellerV3GymCoPayPurchaseResponse
    • ResellerV3CreditPurchaseResponse
    • ResellerV3CoPayPurchaseResponse
    • RescheduleBookingV3Request
    • RefundInfo
    • PasscodeInfo
    • ResellerV3BookingResponse
    • BookSpaV3Request
    • ResellerV3SpaBookingInitiateResponse
    • BookClassV3Request
    • CopayOption
    • ResellerV3ProviderResponse
    • ResellerV3ClassBookingInitiateResponse
    • ResellerV3ServiceResponse
    • ConfirmClassBookingV3Request
    • ResellerV3SpaResponse
    • AccessCodeV3Request
    • ServicePreview
    • ResellerV3AccessCodeResponse
    • ResellerV3ListResponse
    • ResellerV3AccessCodeSessionResponse
    • ResellerV3AvailabilityResponse
    • ConfirmAccessCodeV3Request
    • ResellerV3ClientResponse
    • CategoryDetail
    • ResellerV3CreditsResponse
    • ResellerV3PassResponse
    • ResellerV3ClassInstanceResponse
    • ResellerV3ClassResponse
    • ResellerV3BookingStatusResponse
  1. Credits

Introduction

Credits are a pre-purchased balance that a client can spend on any service in the Bardge network — gym visits, spa appointments, and classes. Rather than paying per session, a client holds a credit balance that is drawn down with each booking. The Credits section lets you discover available credit packages for your business account, purchase credits on behalf of a client, and check a client's current balance.

What you can do#

List available credit packages
Purchase a credit package for a client

Key concepts#

What credits are
Credits are a monetary unit denominated in the business's configured currency. A client with 50 credits can spend those credits across any gym or spa provider in the Bardge network that accepts credit-based payment.
Credits are not tied to a specific provider or service type — they are a flexible balance the client can use for gym visits, spa services, or classes.
Credit packages
Credit packages are pre-defined bundles sold at a fixed price. A package specifies the number of credits granted and the amount charged. The available packages for your business account are returned by GET /credit_packages.
Purchase flow
1.
List available credit packages with GET /credit_packages
2.
Present the options to the client
3.
Call POST /credit_purchases with the client ID and the selected package ID after collecting payment
4.
Credits are added to the client's balance immediately upon successful purchase
The purchase response includes the updated credit balance for the client.
Balance and consumption
Credits are consumed in two ways:
At booking time — when a client books a spa appointment or class priced in credits. If the client has insufficient credits, the booking request is rejected with a 400 validation error.
At gym check-in — when a client logs a visit at a gym, credits are deducted at the point of check-in.
To check a client's current balance before initiating a purchase or booking, use the Lookup section.
Idempotency
Always include an Idempotency-Key on credit purchase requests. Credits are financial transactions — a duplicate charge is hard to reverse and a network timeout can leave the transaction state ambiguous.

Related sections#

Bookings — credits are consumed when a gym visit, spa appointment, or class is booked
Lookup — retrieve a client's current credit balance before purchase or booking
Modified at 2026-05-19 13:21:52
Previous
Introduction
Next
Purchase credits
Built with