Overview
A membership card identifies a customer as a member of your club or program, granting them specific privileges. Think of it like a VIP lounge at an airport — members get access to enhanced services that non-members don't.
Membership cards can be free or paid. When connected to Stripe, you can collect recurring payments (daily, weekly, monthly, quarterly, or yearly) with auto-renewal, or charge a one-time fee for lifetime access. You can also offer free trial periods to let potential members try your services before committing.
When the card is scanned, the scanner shows the cardholder's identity and membership status (valid or invalid). You can also track visits by writing off check-ins from the card.
For example, a gym could offer a Basic membership at $35/month with 30 visits included, and a Premium membership at $70/month with 90 visits. Members install the card, subscribe through Stripe, and use their digital membership card for check-ins.
Key benefits
Collect recurring subscription payments through Stripe with auto-renewal
Create multiple membership tiers with different pricing, limits, and benefits
Offer free trial periods (up to 30 days) to attract new members
Display the member's photo and name on the front of the card for identification
Track visits and check-ins through the scanner
View subscription analytics including MRR, LTV, ARPU, and churn
How to create a membership card
Step 1: Open the cards module
Log in to your Perkstar account.
Navigate to the left-hand menu.
Click the Cards icon to open the Cards module.
You can either create a card using a pre-loaded template or build one from scratch. This guide walks through creating a card from scratch.
Click From Scratch to begin the membership card creation workflow.
A card is created by completing five sections: Card Type, Settings, Design, Information, and Save & Preview.
Step 2: Select card type
From the available card types, click Membership.
Click Continue to move to the Settings section.
Important: The card type cannot be changed after the card is activated. We also do not recommend changing the card type after selecting it, as the card mechanics may not work correctly. Create a new card instead if needed.
Step 3: Configure settings
Barcode type
Choose the barcode type that determines how the card is scanned and recognized by the system.
Payment collection
Choose whether to collect payments for the membership:
Yes (Collect payments) – Enable recurring or one-time payments through Stripe. You must connect your Stripe account first
No – The membership card will be free. Customers can install the card immediately without being redirected to a payment page. You can also use Membership V1, which is a free card option with no tiers or limits
When payment collection is disabled, you can still track visits through the scanner. If you want to collect cash payments instead of using Stripe, you can enable the Purchase amount when charging toggle — your staff will enter the purchase amount manually with each transaction.
What is Membership V1? Membership V1 is a simple member/participant card (club pass) that doesn't use points or rewards. It tracks membership status (active/expired) and lets you log visits via the scanner, but has no points or reward logic. Setup takes about 5 minutes.
Tip: Free membership cards are also a great way to collect customer data and build your customer base without requiring any payment.
Connecting Stripe
To collect payments, connect your Stripe account:
Navigate to your Stripe dashboard and copy your public key.
In Perkstar, click Connect and paste the public key.
Return to Stripe, copy your secret key, and paste it in Perkstar.
Click Connect account and wait approximately one minute for the connection to confirm.
Important: If you're testing, use Stripe's test keys first. Switch to production (live) keys only when you're ready to charge real customers. To switch, disconnect the test account in Perkstar, toggle Stripe from test mode to live mode, create a new secret key, and reconnect with the production keys.
Auto-renewal
Enable auto-renewal – Customers are charged automatically on a recurring basis (daily, weekly, monthly, quarterly, or yearly)
Disable auto-renewal – Customers pay once for lifetime membership access
Membership expiration date
If auto-renewal is enabled, set the expiration date based on the paid period — the expiration aligns with the billing cycle automatically.
If auto-renewal is disabled, choose from the standard options:
Unlimited – The card has no expiration date
Fixed term – The customer cannot use the card after the specified date
Fixed term after card issuing – Select the number of days after card installation until expiry
Note: Regardless of the period the customer has paid for, the card will cease to be valid after the expiration date.
Membership tier unit measure name
Set the label for the units shown on the membership card (e.g., "Visits," "Washes," "Classes," "Massages," "Access"). This is a display label only (e.g., "Available: 8 Visits") and does not change pricing or logic.
Trial period
Set a free trial period for new members, between 0 and 30 days. During the trial, customers must enter their payment card details through Stripe. Stripe authorizes the card (less than $0.50) to validate it before granting trial access. After the trial ends, the regular subscription charge begins.
Membership tiers
Create multiple membership levels. At least one tier is required. Each tier includes:
Name – The tier name (e.g., "Gold's Gym Basic Membership")
Description – Explain what the tier includes
Pricing – Set prices for each billing period (daily, weekly, monthly, yearly). You can disable periods you don't want to offer. Mark one period as Recommended to highlight it on the pricing page
Limits – Set the number of visits or uses included per period (e.g., 30 visits/month)
Benefits – Add non-countable perks for subscribers (e.g., "24/7 access to the gym," "Free water and towels," "Free access to the spa," "3 personal trainings with coach")
Tip: Don't hesitate to use emojis in your benefits list to make the pricing page more visually appealing.
Tip: For free memberships, set the limit to 0 to skip visit tracking limits. The system will still track visits but won't enforce a cap. You can also disable the limits field on the card's front view in the Design section if it's not relevant.
Important: Once the promotion is activated, prices cannot be changed.
You can create up to 6 tiers. Click Add Tier or copy an existing tier and customize it. You can also disable a tier if you don't want to sell a specific subscription level (e.g., daily).
Note: If payment collection via Stripe is disabled, cards issued through the general link will default to the minimum tier and recommended period. If you issue cards in bulk, you can manually assign the tier and period. You can also change the tier in the customer's profile.
Card issuing form
Define the fields customers fill out when installing the card.
A phone number or email is required
Enable the Required toggle to make a field mandatory
Enable the Unique toggle for phone numbers and optionally email to avoid duplicates
Important: For membership cards, the email field is mandatory. You can also add a photo field to display the customer's photo on the front of the card — useful for identifying members at your location.
Locations
Enter the location(s) of your business to trigger push notifications. Customers with the card installed in Apple Wallet receive a notification when they are within 100 meters. You can add 1 location on the Starter plan, 3 on Growth, and up to 10 on the Scale plan.
Language
Select the language for your membership card from the dropdown.
Date format
Choose how the date is displayed on the card. If the card has no expiration date, this setting is irrelevant.
Thousands separator and decimal separator
For membership cards, this setting is irrelevant since this card type has no points.
Purchase amount when charging
For membership cards, this setting is generally not needed since you already know how much customers pay through Stripe. You can skip this step.
Note: This applies only to transactions made via the scanner. It's more relevant for card types like stamp cards where purchase amounts aren't tracked automatically.
UTM tags
Create channel links for analytics tracking. Perkstar generates a unique URL and QR code for each tag. You can share your membership card across digital channels like your Facebook group, Instagram, or TikTok using different UTM links to track which performs best.
Tip: You can create customer segments based on UTM tags. We recommend setting this up from the very beginning.
Phone mask
Select which country prefix appears by default in the card issuance form. Customers can choose a different country if needed.
Privacy policy
Enable or disable the toggle next to Privacy Policy to show or hide consent on the card installation form. You can edit the privacy policy text as needed.
Enable Consent to the processing of personal data to add a marketing consent checkbox. When customers agree, you can send them text messages in addition to push notifications.
Installation options
Choose where customers can install the card. This setting is flexible and can be changed at any time.
Google Wallet installation button – When enabled, Android users can add their card to Google Wallet
PWA installation button – When enabled, customers can install the card as a web app
Tip: For Android users, we recommend using PWA cards over Google Wallet, because Google Wallet does not currently support push notifications natively.
Limit the number of cards issued
Control how many cards can be distributed. Set to 0 for unlimited.
Tip: For free memberships, consider setting a specific limit (e.g., 20 cards) to control the size of your promotion.
Limit the number of customer check-ins per day
Control how many times a cardholder can check in per day. For example, a gym might set this to 2 check-ins per day.
Note: If you already set visit limits within your membership tiers, you may want to leave this as unlimited to avoid double-limiting.
Analytics
Add custom analytics scripts (such as Facebook Pixel or Google Tag Manager) to track card installs and related user actions.
Once all fields are configured, click Continue to move to the Design section.
Step 4: Configure design
Logo
Click Select File to upload a logo displayed on the card and the release form. Follow the file size and weight recommendations.
Icon
Click Select File to upload an icon displayed in push messages. Follow the file size and weight recommendations.
Background of the central part
Click Select File to upload a background image for the center of the card. Follow the file size and weight recommendations.
Tip: If you enable the member photo display, consider removing the background image for better readability of the name and photo on the card.
Colors
Set colors for card background, text color, and background color of the central part.
Note: If you uploaded a custom background image, the background color setting is overridden by the image.
Member photo and name display
If you collect photos through the card issuing form, enable these two toggles to display the cardholder's photo and name on the front of the card. This helps identify members at your location.
Field names
Use the Field dropdown to select which fields appear on the front of the card. Default fields include membership tier and available limits. Use the Field Name column to rename how fields appear on the card.
Card issuing form appearance
Enable Show logo at card issuing form to display your logo on the form
Enable Show background color on card issuing form to apply the background color to the form
Once all design choices are made, click Continue to move to the Information section.
Step 5: Fill in card information
Card description
Enter a short description of the card (your membership program name).
Company name
Enter the name of your business. This name appears in push notifications.
Active links
Add links displayed on the back of the card:
Select the link type from the Type dropdown (URL, Phone, Email, or Address).
Enter the link in the Link field.
Enter display text in the Text field.
There is no limit on the number of active links. Click Add Link to add more.
Note: For iPhone users, links may not be clickable in the card's quick view. Customers should open the card through the Apple Wallet app to access them.
Feedback links
Add links for customer reviews. These links are not displayed on the back of the card — customers only see them after rating their visit (after selecting stars).
You can use popular platforms (Google Maps, Facebook, Yelp, Foursquare) or custom links (Typeform, Google Forms) for feedback collection.
Terms of use
Enable the toggle to include terms of use on the card. The default text is auto-generated based on your card settings and includes variables. You can customize the text, but the variables should be left unchanged or removed entirely.
Tip: For membership cards, it's especially important to clearly describe your subscription terms and conditions to avoid regulatory issues. If you have a subscription agreement on your website, add the link in the Link to full terms and conditions field.
Issuer information
Enter your company name, email, and contact number. These details appear on the back of the card for customers who need support.
Once all details are filled in, click Finish.
Step 6: Save, preview, and activate
After clicking Finish, the Preview popup appears.
Scan the QR code to preview the card on your device.
Review the card and make any changes before activation.
Important: Before activating, you can issue up to 10 test cards. Once you activate the card, the main settings cannot be changed. You will see a list of locked settings in the activation window.
Click Activate Card to make the card live.
After activation, you can download promotional materials in PDF format (A5 or A4) for printing and placement at your business location.
How to distribute membership cards
Sharing the installation link
Copy the card's installation link and share it on your website, social media, or in-store QR code. Customers open the link, choose their tier and billing period, enter their details, and subscribe through Stripe.
Bulk card issuance
Navigate to the Clients section.
Select the customers you want to issue cards to.
Click Card Issuance and select the membership card template.
Select the tier and period — the payment method is assigned automatically based on the template's payment collection settings.
Write a message for the mailing and add a card installation link using placeholders.
Select sending channels: SMS and/or email.
Important: Connect Mailgun and/or Twilio for messages to be delivered.
Promo codes
A promo code field is available on the membership card checkout page. Customers can click Add code and enter a valid promo code when subscribing.
Card statistics
To view statistics, go to the card template and navigate to the Information section. If payment collection via Stripe is enabled, you can view:
Revenue – Total revenue generated
MRR (Monthly Recurring Revenue) – Calculated as number of customers multiplied by average monthly revenue per customer
LTV (Members Lifetime Value) – Average Revenue Per Subscriber divided by Subscriber Churn Rate. When churn is 0%, a default rate of 1.67% is assumed
ARPU (Average Revenue Per User) – Total MRR divided by the number of active subscribers
The payments section shows graphs for revenue generated, active members, LTV, new members, and churned members. You can filter by time period for more detailed insights. Below the graphs is a table of individual payments.
FAQs
Can I create a free membership card without Stripe?
Yes. Set Collect payments to No in the settings. The membership card will be free — customers install the card immediately without being redirected to a payment page. You can still track visits through the scanner. If you want to accept cash payments, enable the Purchase amount when charging toggle so your staff can enter amounts manually. Setup takes about 5 minutes.
What happens if a customer's membership expires?
The card remains on the customer's phone but shows as invalid when scanned. If auto-renewal is enabled, Stripe automatically charges the customer and renews the membership. If auto-renewal is disabled, you can manually renew the membership in the customer's profile.
Can I change prices after activation?
No. Once the card is activated, prices cannot be changed. Make sure your tier pricing is finalized before activating.
How do I switch from Stripe test keys to production keys?
In Perkstar, disconnect the test Stripe account.
In Stripe, switch from test mode to live mode.
Copy your live public key and paste it in Perkstar.
Create a new secret key in Stripe (under Developers > API Keys) and paste it in Perkstar.
Click Connect and wait approximately one minute for confirmation.
Why can't I activate my membership card?
Check your membership tier settings. At least one tier must be active with a set price and limit. Make sure the tier is created, described, and has an active pricing option.
