Loading...

Knowledge Base

Renew Enterprise Email Orders Using the API

When you want to renew an existing Enterprise Email order using the API. This article explains renewal parameters, additional mailbox and storage addon purchases, auto-renew settings, invoice options, discount handling, and response details.

Renew

 

Description

Renews an existing Enterprise Email Order.

Parameters

 

When you want to renew an existing Enterprise Email order using the API. This article explains renewal parameters, additional mailbox and storage addon purchases, auto-renew settings, invoice options, discount handling, and response details.
NameData TypeRequired / OptionalDescription
auth-useridIntegerRequiredAuthentication Parameter
api-keyStringRequiredAuthentication Parameter
order-idIntegerRequiredThe Order Id which is to be renewed.
monthsIntegerRequiredThe number of months for which the Order is to be renewed.
no-of-accountsIntegerOptionalAdditional Email Accounts to be purchased for the Enterprise Email Order, if required.
no-of-storage5-blocksIntegerOptionalNumber of additional email storage addons to purchase while renewing order
auto-renewBooleanRequired

Enables / Disables the Auto Renewal setting for the Order.

Note

Auto-Renewal

invoice-optionStringRequiredThis parameter will decide how the Customer Invoices will be handled. Values can be: NoInvoice, PayInvoice, KeepInvoice, OnlyAdd
discount-amountFloatOptionalDiscount amount for the order value.

HTTP Method

POST

Example Test URL Request

US Server https://test.httpapi.com/api/enterpriseemail/us/renew.json?auth-userid=0&api-key=key&order-id=0&months=0&invoice-option=NoInvoice&discount-amount=0.00

Response

Returns a hash map containing the below details:

  • Domain Name (description)

  • Order Id of the Enterprise Email Order (entityid)

  • Action Type (actiontype)

  • Description of the Enterprise Email Order Renewal Action (actiontypedesc)

  • Action Id of the Enterprise Email Order Renewal Action (eaqid)

  • Enterprise Email Order Renewal Action Status (actionstatus)

  • Description of the Enterprise Email Order Renewal Action Status (actionstatusdesc)

  • Invoice Id of the Enterprise Email Order Renewal Invoice (invoiceid)

  • Selling Currency of the Reseller (sellingcurrencysymbol)

  • Selling Curreny Amount (sellingamount)

  • Customer Id associated with the Enterprise Email Order (customerid)

  • Discount Amount (discount-amount)

Note

invoiceid, sellingcurrencysymbol, sellingamount and customerid will not be returned if invoice-option is set to NoInvoice.

In case of any errors, a status key with value as ERROR alongwith an error message will be returned.