JetBrains Marketplace Help

6. Test the plugin licensing on the demo instance

Intro

JetBrains' Marketplace and Business Application Development teams prepared a fully-functioning Marketplace Demo instance for you, which can be used for full testing of the paid plugins marketplace in a safe and protected environment. It is always kept functioning so that you can test the whole solution before releasing it to the public.

You should have gotten your credentials to access the Marketplace Demo instance together with the Product Code assigned by JetBrains (credentials have been sent in a separate email for those who got the Product Code earlier.) If you don't have your credentials yet, please reach out to JetBrains via marketplace@jetbrains.com email or other channels.

You need your credentials to access both the plugins repository part and the shop part. You will need to provide your credentials separately for both of these applications (so it is normal that you might be required to re-provide your credentials when going from the plugins repository to the shop.)

Endpoints necessary for IDE functioning are open and don't require credentials to be accessed, so you shouldn't worry about it at all.

Marketplace Demo Instance Limitations (!Important)

  • It is an internal demo of the Marketplace, please do not share the access, license keys generated or any other information you are getting at this internal demo.

  • To route the IDE requests to the Marketplace Demo instance, you are modifying the internal parameters of the IDE. Don't forget to remove custom VM Options and Properties after the testing. Otherwise, your IDE experience might be disrupted at any time.

  • It is NOT possible to generate offline license keys (aka Offline Activation Codes) at the demo stand due to security purposes. It will be possible to generate the offline license keys on production (read more about the offline keys at https://sales.jetbrains.com/hc/en-gb/articles/207240825-How-do-I-manage-and-distribute-licenses-within-my-organization-.)

  • It is NOT possible to download plugins/updates which have been copied from the Production instance of the plugins repository. Only plugins/updates uploaded to this Marketplace Demo instance will be accessible.

  • Outgoing emails sent by the demo sales stand are available to all testers. Please use responsibly and don't use any confidential names/information there. Please note that information about the plugin you are testing might be exposed to other Marketplace program users who are using the same test stand, so please reach out to us if you can't allow that to happen - we'll arrange the private testing.

  • The standard user we are usually using:

Email: test.test@gmail.com Username: TestTest Password: FJKDr478fdjhsj__
  • The stand is cleared every Monday at 3 am (Central European Time), so all the plugins/purchases are removed then. Marketplace team is re-uploading all plugins currently in a testing mode (incl. at least one demo plugin) at around 10 am Central European Time.

Test Setup at the Marketplace Demo Instance

  1. Access the Marketplace Demo instance at https://master.demo.marketplace.intellij.net/, use credentials you have obtained from JetBrains. Unfortunately, you can't use the "sign in via Google Account" option as we can't connect it to non-JetBrains emails (JetBrains Team should use "sign in via Google Account" option exclusively), use the username/password option:

    Marketplace Sign In

    (!!!) Make sure to change the password on the first sign in.

  2. Create an Organization for you plugin. Upload update of your plugin (if existing) or a new plugin (if new) to the Marketplace Demo instance, use a standard procedure using the update plugin page (for existing plugin) and upload plugin page (for a new plugin). Transfer this plugin to the organization.

    Please note that to upload the plugin, you need to sign in to the application with your normal Hub (https://hub.jetbrains.com) account, the same as you use on the production instance.

    All the plugins from the Production instance of the Plugins Repository uploaded before Monday should be available at this instance.

    Marketplace Update Plugin

  3. Go to the Edit Organization and submit your banking information under Vendor information tab.

    Vendor Information

  4. Reach out to JetBrains via marketplace@jetbrains.com email or Slack asking us to approve the plugin/update at the demo instance (if necessary) and add it to the Marketplace available for sales.

    To make your plugin available for sales, we need the following information:

    • Customer billing period (Annual, Monthly, Both.)

    • Licensing type (Subscription, Subscription with Fallback.)

    • Individual customers price (Monthly), in USD, yearly price is calculated as monthly price multiplied by 10.

    • Businesses and organizations price (Monthly), in USD, yearly price is calculated as monthly price multiplied by 10.

    • Allow sales via resellers (true/false)

    (!!!) Please attach the plugin update to the email so that we can re-upload it for you after the Marketplace Demo instance is cleaned. You can send us additional builds of the plugin at the same thread.

  5. JetBrains will process your request (usually should happen within 1-2 business days most) and will send you the confirmation.

    Now you can start testing the plugin!

  6. (can be done while you are waiting for the confirmation from JetBrains)

    Configure your IDE to work with the Marketplace Demo Instance (read below.)

Preparing an IDE for Tests with a Demo Environment

(!!!) To route the IDE requests to the Marketplace Demo instance, you are modifying the internal parameters of the IDE. Don't forget to remove custom VM Options and Properties after the testing. Otherwise, your IDE experience might be disrupted at any time.

Configuring the IDE to work with a test Sales System

Marketplace Demo works with a Sales Systems Marketplace Demo https://mp.jpf-demo.aws.intellij.net

The IDE has to be additionally configured to work with it instead of the production JetBrains Account / Sales System.

Use Help | Edit Custom Properties... to open the idea.properties file in the editor and add

jb.service.configuration.url=https://mp.jpf-demo.aws.intellij.net/testservices/JetBrainsAccount.xml

Configuring the IDE to work with a test Plugins Repository

Marketplace Demo runs on the test server https://master.demo.marketplace.intellij.net/.

The IDE has to be additionally configured to work with it instead of the production Plugins Repository.

Use Help | Edit Custom VM Options... to open the Intellij IDEA 2018.2.app.vmoptions file (or similar depends on your version) in the editor and add

-Didea.plugins.host=https://master.demo.marketplace.intellij.net/

Alternatively, you can add plugins to the IDE from disk.

Where to get started with your Paid Plugin?

As soon as your plugin is marked as Paid Plugin available for sale by JetBrains, you will see Pricing tab at the plugin page:

Plugin Buy Page

All the Marketplace-related information about the plugin is available under Sales Info tab.

How to buy a plugin license

= PRODUCT CODE

Personal license

Use the direct link to the shop: https://mp.jpf-demo.aws.intellij.net/shop/buy?item=P:N::Y / https://mp.jpf-demo.aws.intellij.net/shop/buy?item=P:N::M

For quote: https://mp.jpf-demo.aws.intellij.net/shop/quote?item=P:N::Y / https://mp.jpf-demo.aws.intellij.net/shop/quote?item=P:N::M

Or go to buy page from plugin overview: https://master.demo.marketplace.intellij.net/plugin/

Commercial license

Use the direct link on the shop: https://mp.jpf-demo.aws.intellij.net/shop/buy?item=C:N::Y / https://mp.jpf-demo.aws.intellij.net/shop/buy?item=C:N::M

For quote: https://mp.jpf-demo.aws.intellij.net/shop/quote?item=C:N::Y / https://mp.jpf-demo.aws.intellij.net/shop/quote?item=C:N::M

Or go to buy page from plugin overview: https://master.demo.marketplace.intellij.net/plugin/

Payment information on the checkout

At the checkout form, you need to use special test cards/payment information provided to us by Adyen (our payment provider): https://docs.adyen.com/development-resources/test-cards/test-card-numbers/

*(!!!) Please make sure NOT TO USE real data, always use Adyen-provided data.

How to view emails sent by the Sales System?

Due to the sensitivity of the data produced during the testing (such as license keys, order information, etc.), we are not sending out any emails from the Marketplace Demo Sales Systems.

All of the outgoing emails can be viewed at a special URL: https://mp.jpf-demo.aws.intellij.net/emails

System Emails

System Emails View

(!!!) Please note that outgoing emails sent by the demo sales stand available to all testers.

Please use responsibly and don't use any confidential names/information there. Please note that information about the plugin you are testing might be exposed to other Beta program users, so please reach out to us if you can't allow that to happen - we'll arrange the private testing.

What to test?

You can see a general workflow in this video.

You might consider testing the following parts of the system:

  1. Plugins Repository Part

    • Adding a Marketplace plugin

    • Updating a Marketplace plugin (incl. releasing another version)

    • Getting sales/pricing information from Sales System

    • Buy pages and links

    • Purchase Terms

    • etc

  2. Sales Systems Part

    • Purchasing plugin via Store

    • Orders/Quotes/etc. via Sales System

    • Sales Statistics

    • Licenses issue workflow

    • Emails sent

    • Different scenarios

    • etc

  3. Product Part

    • Evaluating a plugin

    • Licensing a plugin via JBA

    • Revoking a license

    • Multiple plugins licenses

    • Licenses with the different licensee

    • etc

We also can arrange the expedited testing for you when JetBrains employees would go through the testing process together with you. Please reach out to us via marketplace@jetbrains.com if you would prefer this option or have any issues.

Happy Testing!

Last modified: 10 August 2020