- Introduction to KooGallery
-
Seller Guide
- Registration
- Joint Operations Certification and Product Access
-
Delivery Methods
- Product Release Description
- Delivery Methods
- Image Release Guide
- Releasing Professional Services
- SaaS Release Guide
- Releasing Consulting Services
- License Release Guide
- Releasing Multi-SKU Product Specifications
- Seller Management
- Product Management
- Service Supervision
- Transaction Management
- Settlement Management
- Bill Management
- Issuing Invoices to Huawei Cloud
-
FAQs
- What Enterprise Certificates Are Needed for the Registration?
- Can I Use the Same Account to Apply for Seller Registration Again After I Exit KooGallery?
- How Do I Become a KooGallery Partner?
- How Long Does It Take to Review the Registration Application?
- How Do I Release Products on KooGallery?
- How Long Does It Take to Review a Product Release Application?
- How Do I Remove a Product from the Catalog?
- When Can I Receive the Payment After a Bill Is Generated?
- When Can I Issue an Invoice for an Order?
- Is the Product Technical Support Provided by Sellers or Huawei Cloud?
- How Long Is the Validity Period of Products on KooGallery?
- How Do I Initiate an Appeal During Service Supervision?
- Can an Individual User Become a Seller on KooGallery?
- What Benefits Can I Obtain After Registering with KooGallery?
- Do I Need to Pay Deposit If I Register with KooGallery?
- How Do I Change the Company Name?
- Why Is No Bill Generated for an Order? What Are the Prerequisites for Bill Run?
- How Do I View the Sharing Ratio of a Product?
- How Do I Release a Trial SaaS Specification?
- Why Can't I Select an Image as an Image Asset?
- Reseller Guide
-
User Guide
- Support You May Need
- Huawei Cloud KooGallery Terms
- Product Purchase
- Product Use
- Service Supervision
- After-Sales Support
- Renewal Management
- Product Unsubscription
- Invoice Management
- Agencies
-
FAQs
- What Is Huawei Cloud KooGallery?
- What Software and Services Are Provided on KooGallery?
- How Do I Purchase Cloud Applications on KooGallery?
- Why Can't I Use the Pay-per-Use or Yearly/Monthly Billing Mode for Certain Products?
- How Do I View Purchased Applications?
- How Do I Request Invoices After Purchasing Products from KooGallery?
- What Do I Do If I Encounter a Problem When Using a Product?
- How Do I Renew Purchased Applications?
- What Do I Do If No Applications or Services Meet My Requirements?
- How Do I Contact a Seller?
- What Do I Do If I Cannot Contact a Seller?
- Does Huawei Cloud Support Login Through Third-Party Website?
- Common Problems About Yearly/Monthly Images
- Common Problems About Pay-per-Use Images
- How Do I Initiate an Appeal During Service Supervision?
-
Access Guide
- SaaS Access Guide V2.0 (New Products)
- SaaS Access Guide V1.0 (Existing Products)
- Automatic Deployment and Access Guide
- General Reference
Copied.
Renewal
Description
For yearly/monthly products, you must develop the renewal interface.
- After a customer places an order for renewal or converts a trial order to a commercial order, KooGallery calls the interface to request you to extend the service. The service interface then updates the expiration date and informs KooGallery about the update result.
- Ensure that the communication over the interface is normal. If the renewal fails, the service of the user may be terminated.
- If the renewal interface fails to be called, KooGallery will retry for an hour. You can view the interface exception information on the Application Tools > Service Interface Messages page. After the exception is solved, ask KooGallery to call the interface again.
NOTE:
- Check the email address bound to your Huawei Cloud account. If you receive an email about an interface calling failure, rectify the exception as soon as possible.
- KooGallery monitors interface exceptions. If renewals of a SaaS product frequently fail due to interface exceptions, KooGallery will remove the product from the catalog.
The following figure shows the process of renewing a service.
Request Message
The following table describes the request parameters.
Request method: GET
Parameter |
Mandatory |
Type |
Maximum Length |
Description |
---|---|---|---|---|
activity |
Yes |
String |
20 |
Request ID, which is used to distinguish the scenario. For renewals, the value is refreshInstance. |
orderId |
Yes |
String |
64 |
KooGallery order ID. A new order will be generated during the renewal or renewal cancellation and has an ID different from that of a subscription order. Use instanceId to identify the resources. |
instanceId |
Yes |
String |
64 |
Instance ID. |
productId |
No |
String |
64 |
Product ID. If a customer renews a product and changes the billing cycle or a customer converts a trial product to a commercial product, a new productId is provided. |
expireTime |
Yes |
String |
20 |
Expiration time. Format: yyyyMMddHHmmss |
testFlag |
No |
String |
2 |
Whether a request is submitted for debugging.
The default value is 0. |
trialToFormal |
No |
String |
2 |
Whether a request is submitted to convert a trial product to a commercial product.
By default, a request is not submitted to convert a trial product to a commercial product. For a request submitted to convert a trial product to a commercial product, it is regarded by default that the instance is not billed in the pay-per-use mode. |
authToken |
Yes |
String |
50 |
Security verification token. For details about the values, see authToken Value. |
timeStamp |
Yes |
String |
20 |
UTC timestamp when a request is initiated. Format: yyyyMMddHHmmssSSS |
periodType |
No |
String |
10 |
Period type. This parameter is only required for yearly/monthly product subscriptions (the value of chargingMode is set to 1). Yearly subscription: year Monthly subscription: month |
periodNumber |
No |
integer |
2 |
Number of periods. This parameter is only required for yearly/monthly product subscriptions (the value of chargingMode is set to 1). Enter a positive integer, for example, 1, 2, and 3. |
orderAmount |
No |
bigdecimal |
20 |
Order amount. The amount is the actual payment amount, which you can check during reconciliation. 1. Renewal: The amount is 0 or a positive number containing up to three decimal places. 2. Renewal cancellation: The amount is a negative number containing up to three decimal places. Unit: USD |
Example request:
https://isvserver.com/produceAPI?activity=refreshInstance& expireTime=20180725000000&instanceId=03pf80c2bae96vc49b80b917bea776d7&orderId=HWS001014ED483AA1E8&timeStamp=20170725025113409&testFlag=0&authToken=09lsS5y+KCtxBu+ON4TXv1SrjH5KVYka9sx2MauHrQU=
Response Message
The following table describes the response parameters.
Parameter |
Mandatory |
Type |
Maximum Length |
Description |
---|---|---|---|---|
resultCode |
Yes |
String |
6 |
Result code. For details, see Invocation Result Codes. |
resultMsg |
No |
String |
255 |
Result message. |
- When processing an interface request, your server must ensure idempotency.
- KooGallery may resend requests for a single order. When receiving a duplicate order, the ISV server needs to return a success response, rather than extend the SaaS instance again.
Example response:
{ "resultCode":"000000", "resultMsg":"success." }
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot