GHEC version (#20947)
Co-authored-by: Matt Pollard <mattpollard@users.noreply.github.com> Co-authored-by: Grace Park <gracepark@github.com> Co-authored-by: Steve Guntrip <12534592+stevecat@users.noreply.github.com> Co-authored-by: Robert Sese <sese@github.com> Co-authored-by: Peter Bengtsson <peterbe@github.com> Co-authored-by: Rachael Sewell <rachmari@github.com>
This commit is contained in:
Laura Coursen
@@ -4,6 +4,7 @@ intro: Guidelines for creating an app that will be easy to use and understand.
|
||||
shortTitle: Customer experience best practice
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghec: '*'
|
||||
topics:
|
||||
- Marketplace
|
||||
redirect_from:
|
||||
|
||||
@@ -3,6 +3,7 @@ title: Creating apps for GitHub Marketplace
|
||||
intro: 'You can list free and paid tools for developers to use in {% data variables.product.prodname_marketplace %}.'
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghec: '*'
|
||||
topics:
|
||||
- Marketplace
|
||||
children:
|
||||
|
||||
@@ -11,6 +11,7 @@ redirect_from:
|
||||
- /developers/github-marketplace/requirements-for-listing-an-app
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghec: '*'
|
||||
topics:
|
||||
- Marketplace
|
||||
shortTitle: Listing requirements
|
||||
@@ -21,7 +22,7 @@ The requirements for listing an app on {% data variables.product.prodname_market
|
||||
|
||||
## Requirements for all {% data variables.product.prodname_marketplace %} listings
|
||||
|
||||
All listings on {% data variables.product.prodname_marketplace %} should be for tools that provide value to the {% data variables.product.product_name %} community. When you submit your listing for publication, you must read and accept the terms of the "[{% data variables.product.prodname_marketplace %} Developer Agreement](/articles/github-marketplace-developer-agreement/)."
|
||||
All listings on {% data variables.product.prodname_marketplace %} should be for tools that provide value to the {% data variables.product.product_name %} community. When you submit your listing for publication, you must read and accept the terms of the "[{% data variables.product.prodname_marketplace %} Developer Agreement](/free-pro-team@latest/github/site-policy/github-marketplace-developer-agreement)."
|
||||
|
||||
### User experience requirements for all apps
|
||||
|
||||
@@ -73,7 +74,7 @@ When you are ready to publish the app on {% data variables.product.prodname_mark
|
||||
|
||||
Your app does not need to handle payments but does need to use {% data variables.product.prodname_marketplace %} purchase events to manage new purchases, upgrades, downgrades, cancellations, and free trials. For information about how integrate these events into your app, see "[Using the {% data variables.product.prodname_marketplace %} API in your app](/developers/github-marketplace/using-the-github-marketplace-api-in-your-app)."
|
||||
|
||||
Using GitHub's billing API allows customers to purchase an app without leaving GitHub and to pay for the service with the payment method already attached to their {% data variables.product.product_name %} account.
|
||||
Using GitHub's billing API allows customers to purchase an app without leaving GitHub and to pay for the service with the payment method already attached to their account on {% data variables.product.product_location %}.
|
||||
|
||||
- Apps must support both monthly and annual billing for paid subscriptions purchases.
|
||||
- Listings may offer any combination of free and paid plans. Free plans are optional but encouraged. For more information, see "[Setting a {% data variables.product.prodname_marketplace %} listing's pricing plan](/marketplace/listing-on-github-marketplace/setting-a-github-marketplace-listing-s-pricing-plan/)."
|
||||
|
||||
@@ -9,6 +9,7 @@ redirect_from:
|
||||
shortTitle: Security best practice
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghec: '*'
|
||||
topics:
|
||||
- Marketplace
|
||||
---
|
||||
|
||||
@@ -9,6 +9,7 @@ redirect_from:
|
||||
- /developers/github-marketplace/viewing-metrics-for-your-listing
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghec: '*'
|
||||
topics:
|
||||
- Marketplace
|
||||
shortTitle: View listing metrics
|
||||
|
||||
@@ -6,6 +6,7 @@ redirect_from:
|
||||
- /developers/github-marketplace/viewing-transactions-for-your-listing
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghec: '*'
|
||||
topics:
|
||||
- Marketplace
|
||||
shortTitle: View listing transactions
|
||||
|
||||
@@ -7,6 +7,7 @@ redirect_from:
|
||||
- /developers/github-marketplace/about-github-marketplace
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghec: '*'
|
||||
topics:
|
||||
- Marketplace
|
||||
---
|
||||
@@ -48,7 +49,7 @@ When you have finished creating your app, you can share it with other users by p
|
||||
|
||||
1. Add a pricing plan. For more information, see "[Setting pricing plans for your listing](/developers/github-marketplace/setting-pricing-plans-for-your-listing)."
|
||||
|
||||
1. Read and accept the terms of the "[{% data variables.product.prodname_marketplace %} Developer Agreement](/articles/github-marketplace-developer-agreement/)."
|
||||
1. Read and accept the terms of the "[{% data variables.product.prodname_marketplace %} Developer Agreement](/free-pro-team@latest/github/site-policy/github-marketplace-developer-agreement."
|
||||
|
||||
1. Submit your listing for publication in {% data variables.product.prodname_marketplace %}. For more information, see "[Submitting your listing for publication](/developers/github-marketplace/submitting-your-listing-for-publication)."
|
||||
|
||||
|
||||
@@ -6,6 +6,7 @@ redirect_from:
|
||||
- /developers/github-marketplace/about-marketplace-badges
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghec: '*'
|
||||
---
|
||||
## For GitHub Apps
|
||||
|
||||
|
||||
@@ -3,6 +3,7 @@ title: Applying for publisher verification for your organization
|
||||
intro: 'To offer paid plans for your app or to include a marketplace badge in your app listing, you must complete the publisher verification process for your organization.'
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghec: '*'
|
||||
topics:
|
||||
- Marketplace
|
||||
redirect_from:
|
||||
|
||||
@@ -3,6 +3,7 @@ title: GitHub Marketplace Overview
|
||||
intro: 'Learn how you can share your app or action with the {% data variables.product.company_short %} community on {% data variables.product.prodname_marketplace %}.'
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghec: '*'
|
||||
children:
|
||||
- /about-github-marketplace
|
||||
- /about-marketplace-badges
|
||||
|
||||
@@ -7,6 +7,7 @@ redirect_from:
|
||||
- /marketplace
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghec: '*'
|
||||
topics:
|
||||
- Marketplace
|
||||
children:
|
||||
|
||||
@@ -10,6 +10,7 @@ redirect_from:
|
||||
- /developers/github-marketplace/configuring-a-webhook-to-notify-you-of-plan-changes
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghec: '*'
|
||||
topics:
|
||||
- Marketplace
|
||||
shortTitle: Webhooks for plan changes
|
||||
|
||||
@@ -15,6 +15,7 @@ redirect_from:
|
||||
- /developers/github-marketplace/drafting-a-listing-for-your-app
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghec: '*'
|
||||
topics:
|
||||
- Marketplace
|
||||
shortTitle: Draft an app listing
|
||||
@@ -60,7 +61,7 @@ Once you've created a {% data variables.product.prodname_marketplace %} draft li
|
||||
|
||||
## Submitting your app
|
||||
|
||||
Once you've completed your {% data variables.product.prodname_marketplace %} listing, you can submit your listing for review from the **Overview** page. You'll need to read and accept the "[{% data variables.product.prodname_marketplace %} Developer Agreement](/articles/github-marketplace-developer-agreement/)," and then you can click **Submit for review**. After you submit your app for review, an onboarding expert will contact you with additional information about the onboarding process.
|
||||
Once you've completed your {% data variables.product.prodname_marketplace %} listing, you can submit your listing for review from the **Overview** page. You'll need to read and accept the "[{% data variables.product.prodname_marketplace %} Developer Agreement](/free-pro-team@latest/github/site-policy/github-marketplace-developer-agreement/)," and then you can click **Submit for review**. After you submit your app for review, an onboarding expert will contact you with additional information about the onboarding process.
|
||||
|
||||
## Removing a {% data variables.product.prodname_marketplace %} listing
|
||||
|
||||
|
||||
@@ -12,6 +12,7 @@ redirect_from:
|
||||
- /marketplace/listing-on-github-marketplace
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghec: '*'
|
||||
topics:
|
||||
- Marketplace
|
||||
children:
|
||||
|
||||
@@ -16,6 +16,7 @@ redirect_from:
|
||||
- /developers/github-marketplace/setting-pricing-plans-for-your-listing
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghec: '*'
|
||||
topics:
|
||||
- Marketplace
|
||||
shortTitle: Set listing pricing plans
|
||||
|
||||
@@ -7,6 +7,7 @@ redirect_from:
|
||||
- /developers/github-marketplace/submitting-your-listing-for-publication
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghec: '*'
|
||||
topics:
|
||||
- Marketplace
|
||||
shortTitle: Submit your listing
|
||||
|
||||
@@ -13,6 +13,7 @@ redirect_from:
|
||||
- /developers/github-marketplace/writing-a-listing-description-for-your-app
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghec: '*'
|
||||
topics:
|
||||
- Marketplace
|
||||
shortTitle: Write listing descriptions
|
||||
@@ -23,7 +24,7 @@ Here are guidelines about the fields you'll need to fill out in the **Listing de
|
||||
|
||||
### Listing name
|
||||
|
||||
Your listing's name will appear on the [{% data variables.product.prodname_marketplace %} homepage](https://github.com/marketplace). The name is limited to 255 characters and can be different from your app's name. Your listing cannot have the same name as an existing {% data variables.product.product_name %} account, unless the name is your own user or organization name.
|
||||
Your listing's name will appear on the [{% data variables.product.prodname_marketplace %} homepage](https://github.com/marketplace). The name is limited to 255 characters and can be different from your app's name. Your listing cannot have the same name as an existing account on {% data variables.product.product_location %}, unless the name is your own user or organization name.
|
||||
|
||||
### Very short description
|
||||
|
||||
|
||||
@@ -8,6 +8,7 @@ redirect_from:
|
||||
- /developers/github-marketplace/billing-customers
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghec: '*'
|
||||
topics:
|
||||
- Marketplace
|
||||
---
|
||||
|
||||
@@ -10,6 +10,7 @@ redirect_from:
|
||||
- /marketplace/selling-your-app
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghec: '*'
|
||||
topics:
|
||||
- Marketplace
|
||||
children:
|
||||
|
||||
@@ -7,13 +7,14 @@ redirect_from:
|
||||
- /developers/github-marketplace/pricing-plans-for-github-marketplace-apps
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghec: '*'
|
||||
topics:
|
||||
- Marketplace
|
||||
shortTitle: Pricing plans for apps
|
||||
---
|
||||
{% data variables.product.prodname_marketplace %} pricing plans can be free, flat rate, or per-unit. Prices are set, displayed, and processed in US dollars. Paid plans are restricted to apps published by verified publishers. For more information about becoming a verified publisher, see "[Applying for publisher verification for your organization](/developers/github-marketplace/applying-for-publisher-verification-for-your-organization)."
|
||||
|
||||
Customers purchase your app using a payment method attached to their {% data variables.product.product_name %} account, without having to leave {% data variables.product.prodname_dotcom_the_website %}. You don't have to write code to perform billing transactions, but you will have to handle events from the {% data variables.product.prodname_marketplace %} API. For more information, see "[Using the {% data variables.product.prodname_marketplace %} API in your app](/developers/github-marketplace/using-the-github-marketplace-api-in-your-app)."
|
||||
Customers purchase your app using a payment method attached to their account on {% data variables.product.product_location %}, without having to leave {% data variables.product.prodname_dotcom_the_website %}. You don't have to write code to perform billing transactions, but you will have to handle events from the {% data variables.product.prodname_marketplace %} API. For more information, see "[Using the {% data variables.product.prodname_marketplace %} API in your app](/developers/github-marketplace/using-the-github-marketplace-api-in-your-app)."
|
||||
|
||||
If the app you're listing on {% data variables.product.prodname_marketplace %} has multiple plan options, you can set up corresponding pricing plans. For example, if your app has two plan options, an open source plan and a pro plan, you can set up a free pricing plan for your open source plan and a flat pricing plan for your pro plan. Each {% data variables.product.prodname_marketplace %} listing must have an annual and a monthly price for every plan that's listed.
|
||||
|
||||
|
||||
@@ -10,6 +10,7 @@ redirect_from:
|
||||
- /developers/github-marketplace/receiving-payment-for-app-purchases
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghec: '*'
|
||||
topics:
|
||||
- Marketplace
|
||||
shortTitle: Receive payment
|
||||
@@ -22,6 +23,6 @@ For transactions made before January 1, 2021, {% data variables.product.company_
|
||||
|
||||
{% note %}
|
||||
|
||||
**Note:** For details of the current pricing and payment terms, see "[{% data variables.product.prodname_marketplace %} developer agreement](/github/site-policy/github-marketplace-developer-agreement)."
|
||||
**Note:** For details of the current pricing and payment terms, see "[{% data variables.product.prodname_marketplace %} developer agreement](/free-pro-team@latest/github/site-policy/github-marketplace-developer-agreement)."
|
||||
|
||||
{% endnote %}
|
||||
|
||||
@@ -9,6 +9,7 @@ redirect_from:
|
||||
- /developers/github-marketplace/handling-new-purchases-and-free-trials
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghec: '*'
|
||||
topics:
|
||||
- Marketplace
|
||||
shortTitle: New purchases & free trials
|
||||
|
||||
@@ -8,6 +8,7 @@ redirect_from:
|
||||
- /developers/github-marketplace/handling-plan-cancellations
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghec: '*'
|
||||
topics:
|
||||
- Marketplace
|
||||
shortTitle: Plan cancellations
|
||||
|
||||
@@ -8,6 +8,7 @@ redirect_from:
|
||||
- /developers/github-marketplace/handling-plan-changes
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghec: '*'
|
||||
topics:
|
||||
- Marketplace
|
||||
---
|
||||
|
||||
@@ -7,6 +7,7 @@ redirect_from:
|
||||
- /marketplace/integrating-with-the-github-marketplace-api
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghec: '*'
|
||||
topics:
|
||||
- Marketplace
|
||||
children:
|
||||
|
||||
@@ -8,6 +8,7 @@ redirect_from:
|
||||
- /developers/github-marketplace/rest-endpoints-for-the-github-marketplace-api
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghec: '*'
|
||||
topics:
|
||||
- Marketplace
|
||||
shortTitle: REST API
|
||||
|
||||
@@ -8,6 +8,7 @@ redirect_from:
|
||||
- /developers/github-marketplace/testing-your-app
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghec: '*'
|
||||
topics:
|
||||
- Marketplace
|
||||
---
|
||||
|
||||
@@ -8,6 +8,7 @@ redirect_from:
|
||||
- /developers/github-marketplace/webhook-events-for-the-github-marketplace-api
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghec: '*'
|
||||
topics:
|
||||
- Marketplace
|
||||
shortTitle: Webhook events
|
||||
|
||||
Reference in New Issue
Block a user