Unlock Guides


Recurring Memberships

Making your memberships automatically recurring is a critical step to reduce friction for your members while at the same time increase your revenues.

When you create your lock, you will be prompted for a base duration for each membership. When your members purchase their memberships, their “keys” will be set to expire based on that duration. After that, depending on how you setup your checkout URL and depending on how you configure your lock, these memberships could be automatically recurring!

Not all locks are eligible for recurring memberships and not all memberships can be renewed automatically. It should also be noted that members can stop their recurring membership(s) at any point.


First, the lock needs to be an ERC20 lock. This means that the lock needs to be “priced” in a token that supports the approval mechanism. In order to be renewed, the member will explicitly approve the lock contract to spend their ERC20 tokens for an amount that correspond to the total amount to be spent for all the renewal. If you want to create recurring memberships in any chain’s native currency, you will need to use the “wrapper” version of that token, like WETH, or WXDAI or WMATIC.

For example, let’s consider a lock uses USDC as its currency and the keys are sold for 5 USDC for 30 days. As a lock manager, you can ask users to approve a total of 60 USDC if you want the memberships to be automatically renewed for 1 year (5 x 12 = 60).

Additionally, the lock should include a gas refund. When configuring a lock, a lock manager can set an amount of tokens that should be paid back to the sender of a transaction. This creates an economic incentive for miners to execute the renewal transaction, as long as the gas refund itself exceeds in value the amount of gas paid.

It is also important to note that the price AND duration of the memberships on a lock need to be stable. If the price or duration are changed, all the existing memberships that would have succeeded will fail.


First of all, only memberships that have been explicitly bought once by their owner can be renewed. It means that it is not possible to renew a membership that was airdropped or one that was initially transferred from another member.

Then, the membership needs to be in an “expired” state in order to be renewed. That means that if a user purchases a membership today for 30 days, the renewal transaction cannot be triggered until it has been expired, or 30 days from today.

Finally, the owner of the membership needs to have approved a large enough amount of the ERC20 used by the lock, and still own enough of that ERC20 when the renewal transaction will be sent. If their balance or approval amount are less than the price of the memberships, the renewal will not be triggered.

Importantly, the user does not need to have the full balance of ERC20 available at the time of the first purchase, or at the renewal time. They only need to have the sufficient balance for a single membership.

How to enable recurring memberships

If your lock follows the pre-requisites stated above, it can be enabled with recurring memberships. The dashboard includes a link to enable recurring transactions:

Keys on this lock cost 1 USDC per day. Clicking on the "Enable Recurring" will enable recurring memberships.
Once enabled, you can easily build checkout urls that include the attribute recurringPayments inside of a lock’s configuration (see Configuring Checkout). This value is the number of times you want the membership to be renewed and the users will approve the lock to spend a total of recurringPayments multiplied by the current key price.

Any user who goes through that process will be then prompted to approve the total amount. After that, you are all set.

For users opting to pay via cards, we create a subscription object using recurringPayments attribute on the backend to keep track of how many times the user wishes to renew the key and store all the details surrounding the purchase.

Due to the volatile nature of many crypto-currencies, fiat prices can swing drastically between two payments. To avoid this and protect the users, we lock in the fiat price at the time of subscription for further renewals. This means if the user purchased an NFT for 0.1 tokens valued at $10 at the time of purchase, further renewals would only cost that $10, even if the price of the token is now much higher or much lower. We use the subscription object to renew keys when they expire.

Managing recurring memberships

We are working on adding features to the dashboard so that a creator can easily view if memberships are renewable and if they failed to renewed.
Similarly, we are adding capabilities for members themselves to manage their memberships (through the keychain) as well as stop or change any recurring memberships.

Decentralization and economic incentives

The Public Lock contract now includes a function called renewMembershipFor that can be called by anyone to renew an existing membership. This function will only succeed if the price and duration on the lock are unchanged from when the owner of that membership purchased it for themselves, as well as if the key is actually expired.

If it succeeds, this function will withdraw from the key owner’s ERC20 balance, and extend the expiration for that specific key. The lock will issue a token transfer to the sender in order to cover the gas spent. Additionally, that function also takes a referrer argument and will yield UDT token to that address in order to distribute ownership and governance of the protocol.

Unlock Inc. is already running a worker to issue transactions that will renew expired memberships. We expect other actors to issue similar workers. In that instance, and if 2 transactions are emitted to renew an expired key, only the first one to be mined will succeed (as the 2nd one will try to extend a key that is not expired anymore), resulting in a waste of gas. Using flash-bots and other MEV mechanisms provides the ability to avoid wasting gas in these scenarios.

Was this article helpful?

Not all locks are eligible for recurring memberships and not all memberships can be renewed automatically. It should also be noted that members can stop their recurring membership(s) at any point.

Table of Contents