Subscription or Membership Fee (Unlock Protocol)

Provide subscription- or membership-based access to specific roles and permissions

Overview

Hats has integrated with Unlock Protocol to allow organizations to set up recurring subscriptions or one-time membership fees for roles. When you add a subscription or membership fee to a role, a unique claim page is automatically generated for fee collection and onboarding.

Once a subscription or membership is active, the new member immediately gains all associated role powers, such as access to workspaces, communication channels, and voting rights. If the subscription is canceled or expires, access is automatically revoked.

The module's code is open source and is available here.

Video guide

Adding the module to a hat

  • Go to the tree that includes the hat you wish to create the module for

  • Select "Edit Tree"

  • Locate and select the hat

  • Open the "Revocation & Eligibility" section

  • Choose "Add Module". This will open the module creation form

  • Choose "Subscription Eligibility (Unlock Protocol v14)" in the module type

  • Fill in the module-specific parameters, shown below

  • NOTE: Turn the subscription into a one-time purchase by setting the subscription period to 10 or more years

  • Choose "Deploy & Return" to deploy the module and return to the hat edit form. The module address will be automatically updated on the hat's eligibility property in the form. Once you deploy these changes, the hat's eligibility will be updated.

Sharing the Subscription/Fee Payment Page

Once deployed, exit from edit mode and return to the hat that you have added this subscription eligibility module to. In the hat's details, you will now see a "Pay the subscription" link.

Follow this link to see a unique claim page that is automatically generated for fee collection and onboarding.

Once a subscription or membership is active, the new member automatically claims the hat and immediately gains all associated role powers, such as access to workspaces, communication channels, and voting rights. If the subscription is canceled or expires, access is automatically revoked.

Viewing the hat's eligibility criteria

Once the module is attached to the hat, you can view the hat's updated eligibility criteria:

  • Select the hat

  • In the eligibility section, you can view:

    • The module's general description

    • The module's live parameters

    • Useful links including the module's source code on GitHub

Last updated