Premium Apps: One-Time Purchase SKUs + Managing Your Store #6820
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
MCausc78
reviewed
Apr 24, 2024
| ] | ||
| ``` | ||
|
|
||
| ## Consume an Entitlement % POST /applications/{application.id#DOCS_RESOURCES_APPLICATION/application-object}/entitlements/{entitlement.id#DOCS_MONETIZATION_ENTITLEMENTS/entitlement-object}/consume | ||
|
|
||
| For One-Time Purchase consumable SKUs, marks a given entitlement for the user as consumed. The entitlement will have `consumed: true` when using [List Entitlements](#DOCS_MONETIZATION_ENTITLEMENTS/list-entitlements). |
There was a problem hiding this comment.
does that fires any events? such as ENTITLEMENT_UPDATE?
There was a problem hiding this comment.
Will check on this!
shaydewael
approved these changes
Apr 24, 2024
Comment on lines
+5
to
+8
| - Create a SKU | ||
| - Add a SKU image and benefits | ||
| - Implement the SKU into your app | ||
| - Publish a SKU to your store view with the click of a button. |
There was a problem hiding this comment.
are these sequential steps that need to be taken? should it be a numbered list instead of bulleted?
| Developers now have the ability to set up a Store page in the Developer Portal. To set up your Premium App's Store view take the following steps: | ||
|
|
||
| - Create a SKU | ||
| - Add a SKU image and benefits |
There was a problem hiding this comment.
should this link to https://discord.com/developers/docs/monetization/skus#customizing-your-skus ?
Comment on lines
+22
to
+25
| - SKU Image | ||
| - Name | ||
| - Product Description | ||
| - Price |
There was a problem hiding this comment.
i think this just can be inline—this is taking up a lot of vertical space and i dont think it needs to be—just "you can configure the SKU's name, image, description, and price" or something
|
|
||
| ## Publishing Your One-Time Purchases | ||
|
|
||
| Once you have configured your SKU, you can publish the SKU to either just the API or the API and your Store. Learn more about [Managing Your Store](#DOCS_MONETIZATION_MANAGING_YOUR_STORE) to curate what items you make available to your users. |
There was a problem hiding this comment.
if it's just published to the store, what does it mean for end users?
There was a problem hiding this comment.
will revisit some of this with more detail after its live 😎
Comment on lines
+39
to
+41
| - Working with Entitlements | ||
| - Handling Gateway Events for Entitlements | ||
| - Handling Entitlements for Consumable SKUs |
There was a problem hiding this comment.
Suggested change
| - Working with Entitlements | |
| - Handling Gateway Events for Entitlements | |
| - Handling Entitlements for Consumable SKUs | |
| - Working with Entitlements | |
| - Handling Gateway Events for Entitlements | |
| - Handling Entitlements for Consumable SKUs |
|
|
||
| #### Entitlement HTTP Endpoints | ||
|
|
||
| For apps requiring background processing, keeping track of entitlements is essential. You can utilize the [List Entitlements](#DOCS_MONETIZATION_ENTITLEMENTS/list-entitlements) endpoint to list entitlements. Your app can filter entitlements by a specific user or set of SKUs by using the `?user_id=XYZ` or `?sku_ids=XYZ` query params. |
There was a problem hiding this comment.
Suggested change
| For apps requiring background processing, keeping track of entitlements is essential. You can utilize the [List Entitlements](#DOCS_MONETIZATION_ENTITLEMENTS/list-entitlements) endpoint to list entitlements. Your app can filter entitlements by a specific user or set of SKUs by using the `?user_id=XYZ` or `?sku_ids=XYZ` query params. | |
| For apps requiring background processing, keeping track of entitlements is essential. You can use the [List Entitlements](#DOCS_MONETIZATION_ENTITLEMENTS/list-entitlements) endpoint to list entitlements. Your app can filter entitlements by a specific user or set of SKUs by using the `?user_id=XYZ` or `?sku_ids=XYZ` query params. |
There was a problem hiding this comment.
should this just be "the user_id and sku_id query params"
There was a problem hiding this comment.
It is user_id and sku_ids
Co-authored-by: shay <swdewael@gmail.com>
Co-authored-by: shay <swdewael@gmail.com>
Co-authored-by: shay <swdewael@gmail.com>
Co-authored-by: shay <swdewael@gmail.com>
1 task
7 tasks
3 tasks
KubaZ2
added a commit
to NetCordDev/NetCord
that referenced
this pull request
Apr 27, 2024
Nihlus
added a commit
to Remora/Remora.Discord
that referenced
this pull request
Apr 29, 2024
shaydewael
added a commit
to Jupith/discord-api-docs
that referenced
this pull request
May 14, 2024
) * Added docs for One-Time Purchase + Store * Update docs/monetization/One-Time_Purchases.md Co-authored-by: shay <swdewael@gmail.com> * Update docs/Change_Log.md Co-authored-by: shay <swdewael@gmail.com> * Update docs/monetization/Managing_Your_Store.md Co-authored-by: shay <swdewael@gmail.com> * Update docs/monetization/One-Time_Purchases.md Co-authored-by: shay <swdewael@gmail.com> --------- Co-authored-by: shay <swdewael@gmail.com>
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
One-time purchases are here, along with Stores for Premium Apps.
consumedfield on the Entitlement resource