Skip to content

Commit

Permalink
improve app subscription docs
Browse files Browse the repository at this point in the history
  • Loading branch information
Lulalaby committed Sep 26, 2023
1 parent 2a70af3 commit 46c45d9
Show file tree
Hide file tree
Showing 4 changed files with 12 additions and 10 deletions.
2 changes: 1 addition & 1 deletion docs/monetization/App_Subscriptions.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ Currently, you can only have one published subscription SKU for your app, so you

## Configuring App Subscriptions

Once you have an idea what type of subscription you want to offer your app, you can create and [customize your SKU](#DOCS_MONETIZATION_SKUS/customizing-your-skus) to reflect the premium features that you are adding to your app. This is a good place to outline the benefits your users will receive from having an app subscription.
Once you have an idea what type of subscription you want to offer for your app, you can create and [customize your SKU](#DOCS_MONETIZATION_SKUS/customizing-your-skus) to reflect the premium features that you are adding to your app. This is a good place to outline the benefits your users will receive from having an app subscription.

Once an app has a published SKU, there are 4 ways users will be able to subscribe:

Expand Down
1 change: 0 additions & 1 deletion docs/monetization/Entitlements.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,6 @@ Entitlements in Discord represent that a user or guild has access to a premium o
| guild_id? | snowflake | ID of the guild that is granted access to the entitlement's sku |
| application_id | snowflake | ID of the parent application |
| type | integer | [Type of entitlement](#DOCS_MONETIZATION_ENTITLEMENTS/entitlement-object-entitlement-types) |
| consumed | boolean | Not applicable for App Subscriptions. Subscriptions are not consumed and will be `false` |
| starts_at? | ISO8601 timestamp | Start date at which the entitlement is valid. Not present when using test entitlements. |
| ends_at? | ISO8601 timestamp | Date at which the entitlement is no longer valid. Not present when using test entitlements. |

Expand Down
2 changes: 1 addition & 1 deletion docs/monetization/Overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ Only team owners can enable monetization for an app. When a team owner enables m
- App belongs to a developer team
- Team owner must be at least 18 years old
- Team must have verified emails and 2FA set up
- App uses slash commands, or has been approved for the Message Content privileged intent
- App uses slash commands, or has been approved for the privileged `Message Content` intent
- App has a link to your Terms of Service
- This document is an agreement between you and users governing the use of your app.
- App has a link to your Privacy Policy
Expand Down
17 changes: 10 additions & 7 deletions docs/monetization/SKUs.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,13 +6,14 @@ SKUs (stock-keeping units) in Discord represent premium offerings that can be ma

###### SKU Structure

| Field | Type | Description |
|----------------|-----------|-------------------------------------------------------------|
| id | todo | ID of SKU |
| type | integer | [Type of SKU](#DOCS_MONETIZATION_SKUS/sku-object-sku-types) |
| application_id | snowflake | ID of the parent application |
| name | string | Customer-facing name of your premium offering |
| slug | string | System-generated URL slug based on the SKU's name |
| Field | Type | Description |
|----------------|-----------|-----------------------------------------------------------------|
| id | snowflake | ID of SKU |
| type | integer | [Type of SKU](#DOCS_MONETIZATION_SKUS/sku-object-sku-types) |
| application_id | snowflake | ID of the parent application |
| name | string | Customer-facing name of your premium offering |
| slug | string | System-generated URL slug based on the SKU's name |
| flags | integer | The sku's [flags](#DOCS_MONETIZATION_SKUS/sku-object-sku-flags) |

###### SKU Example

Expand Down Expand Up @@ -43,6 +44,8 @@ For subscriptions, SKUs will have a type of either `SUBSCRIPTION` represented by
| SUBSCRIPTION | 5 | Represents a recurring subscription |
| SUBSCRIPTION_GROUP | 6 | System-generated group for each SUBSCRIPTION SKU created |

###### SKU Flags

For subscriptions, there are two types of access levels you can offer to users:

- **Guild Subscriptions**: A subscription purchased by a user and applied to a single server. Everyone in that server gets your premium benefits.
Expand Down

0 comments on commit 46c45d9

Please sign in to comment.