> For the complete documentation index, see [llms.txt](https://docs.perkville.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.perkville.com/integrations/integration-reference/hapana.md).

# Hapana

Use Hapana attendance, package and member data for loyalty earning.

## Integration at a glance <a href="#capabilities-and-use-cases" id="capabilities-and-use-cases"></a>

* **Attendance** — Reward facility and session check-ins.
* **Membership tier rewards** — Offer points, instant rewards, or both for qualifying active membership tiers, including when members join at a higher tier or upgrade. Each tier is earned once. See [Membership tiers](https://docs.perkville.com/features/earning-rules/membership-tiers.md) for setup.

Uses names from active packages in the Memberships category and the mapped status. Confirm the resulting type when a customer holds multiple packages. Memberships and tier rewards must be enabled in Perkville, with the qualifying membership types and active statuses syncing from your system.

* **Other earning rules** — Configured sign-up, anniversary and new-member challenge rules remain separate; active-package eligibility still applies.

{% hint style="warning" %}

* **Limits** — Purchase earning, pre-booking and automatic redemptions are not included in the listed integration.
  {% endhint %}

## Supported data and use cases

Hapana supplies the member, site, package and activity information used by Perkville's configured earning and eligibility rules. The integration is described as **close to real time**, but that is not a guaranteed processing interval.

| Data or action                                | Direction                                 | Perkville use case                                                               | Requirements or limitations                                                                                                                                     |
| --------------------------------------------- | ----------------------------------------- | -------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Client and site records                       | Hapana → Perkville                        | Match members and participating locations to their loyalty activity.             | Confirm the member and site identifiers with your Customer Success Representative.                                                                              |
| Facility check-ins                            | Hapana → Perkville                        | Award points for qualifying visits.                                              | Requires an enabled earning rule and an eligible member/location.                                                                                               |
| Session attendance / check-ins                | Hapana → Perkville                        | Award points for qualifying attended sessions.                                   | Booking a session in advance is not a supported earning event through this integration.                                                                         |
| Packages and active-package status            | Hapana → Perkville                        | Restrict earning eligibility to members with selected active packages.           | Which packages qualify is configured for each business; an inactive or unmatched package may prevent earning.                                                   |
| Membership tiers and other membership rewards | Hapana → Perkville                        | Reward qualifying active membership tiers with points, instant rewards, or both. | Confirm the type derived from active Memberships-category packages. Separate sign-up, anniversary and new-member challenge rules retain their own requirements. |
| Reward redemption                             | Perkville; fulfillment handled separately | Members can redeem rewards according to the Perkville program.                   | The listed Hapana integration does **not** automatically apply coupons, credits or other reward fulfillment in Hapana.                                          |

This is a backend data integration, not a native Perkville experience inside a Hapana mobile app. The listed integration does not pull referral relationships from a Hapana app. A Perkville referral program and any configured completion activity should be assessed separately from lead delivery or app functionality.

## Setup

Contact [Perkville Support](https://docs.perkville.com/overview/support.md) or your Customer Success Representative to confirm access, participating locations, data matching and the workflows for your program. Test the agreed use cases before launch.

## Launch checklist

1. Contact [Perkville Support](https://docs.perkville.com/overview/support.md) or your Customer Success Representative to authorize and confirm the Hapana connection and applicable setup requirements.
2. Confirm participating Hapana sites and member matching, including external site and client identifiers.
3. Select qualifying attendance, membership and package-related earning rules. If eligibility depends on an active package, confirm exactly which Hapana packages count.
4. Review business and [location activation settings](https://docs.perkville.com/guides/onboarding/set-up-and-activate-locations.md), including [transaction-date cutoffs](https://docs.perkville.com/features/settings/loyalty-activity-controls/activation-and-transaction-dates.md), before enabling historical or new activity.
5. Test representative facility and session check-ins, eligible and ineligible package holders, and any configured signup or milestone rule. Check the corresponding Perkville transactions and dates before launch.

## FAQ

### Can active packages control eligibility?

Yes. Confirm which active packages should qualify with your Perkville representative. Check that the member is matched to the correct Hapana client and has a currently qualifying package before troubleshooting an earning rule.

### Why didn't a member receive points for attendance?

Confirm that the visit or session was recorded as a supported check-in or attendance event in Hapana, that the client and site match the Perkville records, and that the relevant earning rule is enabled. Check the member's active-package eligibility, location activation and transaction-date restrictions. Activity processing is described as close to real time, not instantaneous. If the transaction is still missing, contact [Perkville Support](https://docs.perkville.com/overview/support.md) with the member, site, activity type and date.

### Can a member earn points for booking before attending?

Not through the listed standard integration. Session check-ins are supported; pre-booking earning is not.

### Can members earn points on purchases or redeem rewards automatically in Hapana?

General purchase earning and automatic reward fulfillment are not listed as supported. Membership tier rewards and configured package or membership sign-up milestones are separate from general purchases. A redemption recorded in Perkville does not automatically create a Hapana credit or apply a coupon.

## Resources

* [Perkville now integrates with Hapana for referral and retention programs](https://info.perkville.com/blog/perkville-now-integrates-with-hapana-for-referral-and-retention-programs) — Perkville's April 2026 announcement with examples of attendance and member-milestone loyalty programs.
* [Hapana partner profile](https://partners.perkville.com/partners/hapana) — Integration capability summary; the setup and limitations above provide customer-facing detail.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.perkville.com/integrations/integration-reference/hapana.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
