Monetization

With Seyfert you can now control the latest Discord monetization features.

This section will show the basic creation of premium buttons, events and commands.

Note

First you need to activate the monetization in your bot for all this to work, learn how to do it here

Entitlements

Entitlements in Discord represent that a user or guild has access to a premium offering in your application, with this you can know if a user is subscribed to your application and give him the benefits you want.

Receiving Events

Currently there are 3 events for entitlements:

entitlementCreate(entitlement: Entitlement)

Emitted whenever an entitlement is created.

entitlementDelete(entitlement: Entitlement)

Emitted whenever an entitlement is deleted. Entitlements are not deleted when they expire. This is only triggered when Discord issues a refund or deletes the entitlement manually.

entitlementUpdate(entitlement: Entitlement)

Emitted whenever an entitlement is updated - i.e. when a user’s subscription renews.

entitlementCreate.ts

events/entitlementCreate.ts

export default createEvent({
    data: { name: 'entitlementCreate' },
    async run(entitlement, client) {
        const subscribedUser = await client.users.fetch(entitlement.userId);
        client.messages.write('LOG_CHANNEL_ID', {
            content: `${subscribedUser.globalName} (${subscribedUser.id}) has been subscribed to ${entitlement.skuId}`,
        });
    },
});

entitlementDelete.ts

events/entitlementDelete.ts

export default createEvent({
    data: { name: 'entitlementDelete' },
    run(entitlement, client) {
        client.messages.write('LOG_CHANNEL_ID', {
            content: `Refund or subscription deleted (${entitlement.skuId}) [${entitlement.type}]`,
        });
    },
});

entitlementUpdate.ts

events/entitlementUpdate.ts

export default createEvent({
    data: { name: 'entitlementUpdate' },
    async run: (entitlement, client) => {
        const subscribedUser = await client.users.fetch(newEntitlement.userId);
        client.messages.write('LOG_CHANNEL_ID', {
            content: `Subscription (${newEntitlement.skuId}) renewed by ${subscribedUser.globalName}`,
        });
    },
});

Premium Button

Now you can create a Button that redirects to any item in your store, such as a subscription, consumable, etc.

This type of button does not need a CustomID or Label, but it does need a SkuID, which you can get from your store menu at https://discord.com/developers/applications/{APP_ID}/skus

import { Button } from 'seyfert';
import { ButtonStyle } from 'seyfert/lib/types';

new Button()
.setSKUId('STORE_ITEM_SKU_ID')
.setSyle(ButtonStyle.Premium)

Learn more

For more information about the premium buttons visit the discord documentation here

Commands / Interactions

In each Interaction you can also get all the active entitlements, with them you can detect if the user has any subscriptions, consumables, etc.

Example:

commands/premium.ts

import { Declare, Command, type CommandContext, ActionRow, Button } from 'seyfert';
import { ButtonStyle } from 'seyfert/lib/types';

@Declare({
  name: 'premium',
  description: 'Premium command',
})
export class PremiumCommand extends Command  {
  run(ctx: CommandContext) {
    const isPremium = ctx.interaction.entitlements.length;

    const row = new ActionRow()
    .setComponents(
        new Button()
        .setSkuId('STORE_ITEM_SKU_ID')
        .setSyle(ButtonStyle.Premium)
    );

    if (!isPremium) return ctx.editOrReply({
        content: 'Click to subscribe and get access to the command!',
        components: [row]
    });

    // Premium code
  }
}