Business Rules

• Subscription cannot be pending a migration.
• Cancellations are not permitted where the Service Plan associated with the subscription is unlinked from a Package Plan.
• If the service type associated with the subscription is DNS Hosting or EME Email Domain, you cannot cancel the subscription if there are active email mailboxes associated with the domain.
• The subscription must be the lowest in the subscription hierachy.
• The subscription is owned by an account of the parent calling the API (in effect, only the RSP can cancel the subscription).
• The subscription cannot be subject to a service type migrate in flight.
• The subscription status must be Active.
• If service subscription is attached to a one to one package/service plan, and the service plan is mandatory a cancellation will be permitted.  However, cancellations will not be permitted where the service plan is mandatory and the package plan has more than one service plan attached.
• Cancellations are not permitted where the service type setting 'Can't Cancel' is enabled.  The exception is where the account feature 'Can't Cancel Override' is enabled.
• Cancellation dates greater than six months into the future are not permitted.
• Cancellation dates earlier than the start date of the subscription are not permitted.
• Cancellation dates earlier than the start date of the current billing period are not permitted.  You cannot set a cancellation date that's within a closed period.
• Please note that if your package plan/service plan configuration is one to one, when the service subscription is cancelled the package subscription is also automatically cancelled.  If there is a contract attached to the package subscription, break fees may be generated depending on the contract setup, and whether the contract is still active.

SOAP Example

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:emersion:api">
   <soapenv:Header/>
   <soapenv:Body>
      <urn:CancelServiceSubscription>
         <urn:ServiceSubscriptionID>4077475</urn:ServiceSubscriptionID>
         <urn:CancelTimeFrame>Cancel On Specific Date</urn:CancelTimeFrame>
         <urn:CancelDate>2021-06-03</urn:CancelDate>
         <urn:SkipProvisioning>Y</urn:SkipProvisioning>
         <urn:CancelReason>user cancel</urn:CancelReason>
         <urn:CancelNote>User has changed providers</urn:CancelNote>
      </urn:CancelServiceSubscription>
   </soapenv:Body>
</soapenv:Envelope>

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="urn:emersion:api">
   <SOAP-ENV:Body>
      <ns1:CancelServiceSubscriptionResponse/>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Field Descriptions

All field names are case sensitive. Check enumerated values in the descriptions to confirm capitalisation and spacing. See field types for additional information..

Error Handling