You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
billing service, partner center, Open Service Broker, end-to-end
subcollection
sell
{{site.data.keyword.attribute-definition-list}}
Checklist for selling services on {{site.data.keyword.cloud_notm}}
{: #checklist}
Use the following checklists to track all the tasks required to define, develop, and publish your third-party service.
{: shortdesc}
Register your product
{: #register}
Task
Description
Environment
Provide your company name
Specify the legal name of your company.
{{site.data.keyword.cloud_notm}} console
Create a test environment
The test environment is not needed for services, but is necessary for software. If you onboard software in the future, you will use the test environment to validate that it's ready for use.
{{site.data.keyword.cloud_notm}} console
Assign team access
With the correct {{site.data.keyword.cloud_notm}} Identity and Access Management (IAM) access, members of your team can help onboard your service.
{{site.data.keyword.cloud_notm}} console
Invite team members to your account
Members of your account are assigned the IAM access that you set up in the previous task.
{{site.data.keyword.cloud_notm}} console
Confirm your legal agreement with {{site.data.keyword.IBM_notm}}
Review and submit the {{site.data.keyword.IBM_notm}} Digital Reseller Agreement if you plan to offer free or paid plans, or upload your custom digital provider agreement to be reviewed and approved by {{site.data.keyword.IBM_notm}}.
{{site.data.keyword.cloud_notm}} console
{: caption="Getting started tasks for selling services" caption-side="top"}
Review the programmatic name that was generated for you and make any needed updates.
{{site.data.keyword.cloud_notm}} console
Verify your partner details
Review the company and team information and make sure that everything is correct.
{{site.data.keyword.cloud_notm}} console
Create your service ID
Create your service ID that is used to identify your service when communicating with other {{site.data.keyword.cloud_notm}} services.
{{site.data.keyword.cloud_notm}} console
Create your API key
Create an API key that is used to authenticate your service ID.
{{site.data.keyword.cloud_notm}} console
Define your product details
Add details, such as your product logo, keywords, description, features, and documentation URL for your product's entry and details page in the {{site.data.keyword.cloud_notm}} catalog.
{{site.data.keyword.cloud_notm}} console
Define your support details
Provide your support site URL, contacts, escalation process, and the locations where your support teams are based.
{{site.data.keyword.cloud_notm}} console
{: caption="Tasks for defining service details" caption-side="top"}
To receive payment disbursements for usage-based pricing plans, email the required documents.
{{site.data.keyword.cloud_notm}} console
Add your ECCN
Add the Export Control Classification Number (ECCN) that applies to your product.
{{site.data.keyword.cloud_notm}} console
Add your UNSPSC
Add the United Nations Standard Products and Services Code (UNSPSC) that applies to your product.
{{site.data.keyword.cloud_notm}} console
Add your pricing plans
{{site.data.keyword.cloud_notm}} supports two pricing models: free or usage-based.
{{site.data.keyword.cloud_notm}} console
Add metrics to your pricing plan
Add metrics to your usage-based pricing plan to determine how customers are charged.
{{site.data.keyword.cloud_notm}} console
Test and submit resource usage
Review how customers understand and experience your pricing plan, and validate that your metered plans are correctly configured by enabling and submitting a usage test. This usage test includes creating your metering JSON, calling the Usage Metering API and submitting metering evidence. For more information, see Usage Metering API{: external}.
Development environment and documentation, {{site.data.keyword.cloud_notm}} console
Review and submit the {{site.data.keyword.cloud_notm}}'s Digital Platform Reseller Agreement
Review and submit the {{site.data.keyword.IBM_notm}} Digital Platform Reseller Agreement if you plan to offer free or paid plans, or upload your custom digital provider agreement to be reviewed and approved by {{site.data.keyword.IBM_notm}}.
{{site.data.keyword.cloud_notm}} console
{: caption="Tasks for add pricing plans for services" caption-side="top"}
Learn about the Open Service Broker specification version 2.12
Service brokers manage the lifecycle of services. The {{site.data.keyword.cloud_notm}} platform interacts with Open Service Brokers to create and manage service instances and service bindings. For more information, see Open Broker API spec{: external}.
Documentation
View the {{site.data.keyword.cloud_notm}} broker samples
Clone the repo, browse the broker samples, and use these samples to start development. For more information, see Sample Resource Service Brokers{: external}.
Code examples
View the {{site.data.keyword.cloud_notm}} Open Service Broker API documentation
Review the criteria that the broker must meet. The {{site.data.keyword.cloud_notm}} Open Service Broker extends the Open Service Broker 2.12 specification. For more information, see Open Service Broker API.
Documentation
Develop your service broker
Use your development environment and {{site.data.keyword.cloud_notm}} resources to develop your broker.
Development environment and documentation
Host your Open Service Broker
The hosted location of the service broker must follow Transport Layer Security (TLS) protocol version 1.2. The service broker must be hosted as part of an app that can respond to REST API calls, and it must meet {{site.data.keyword.cloud_notm}} security guidelines.
Development environment and documentation
Test your hosted Open Service Broker
Validate each of the API endpoints your service broker supports by running curl commands against your hosted service broker. Validate your service broker by running curl commands against the different endpoints you’re enabling.
Development environment and documentation
Set up {{site.data.keyword.cloud_notm}} SSO and redirect URLs
You can enable single sign-on and add redirect URLs that can handle authentication and authorization.
{{site.data.keyword.cloud_notm}} console
Add your broker
Add your broker to your product and link it to your pricing plans.
{{site.data.keyword.cloud_notm}} console
{: caption="Developing your broker" caption-side="top"}
As a third-party provider, you're responsible for maintaining all assets of published services in the {{site.data.keyword.cloud_notm}} catalog and deprecating outdated versions.
{: note}
Publishing your service documentation
{: #pubdocs}
Task
Description
Environment
Populate the Docs link
Provide a link to documentation from the {{site.data.keyword.cloud_notm}} catalog page that helps users understand and learn more about how to use your service.
{{site.data.keyword.cloud_notm}} console
Publish usage documentation for your service
Provide information about how to use your product.
Documentation
Publish getting started information for your service
Include any customer onboarding timelines or steps as part of your Getting Started topic.
Documentation
{: caption="Tasks for documenting services" caption-side="top"}