⟵ Back to XML Help

To get subscription statuses:

URL to post:

https://vendors.bmtmicro.com/xmlrequest

method=”post”

XML request format:

<?xml version="1.0" encoding="utf-8">
<request>
<subscriptions>
<apitoken>Replace this with your APIToken</apitoken>
<subscriptionid>Replace this with your Subscription ID</subscriptionid> 
</subscriptions>
</request>

OR:

<?xml version="1.0" encoding="utf-8"?>
<request>
<subscriptions>
<apitoken>Replace this with your APIToken</apitoken>
<email>Replace this with customer email</email>
<orderid>Replace this with the Order ID of the subscription order or the order ID of any subsequent renewal</orderid>
</subscriptions>
</request>

Returned XML Example:

<response>
<subscriptions>
<subscriptionid>12345678</subscriptionid>
<orderid>12345678</orderid>
<itemnummber>1</itemnummber>
<productid>12345678</productid>
<status>active</status>
<effectivedate>YYYY-MM-DD</effectivedate>
<expirationdate/>
<nextbillingdate>YYYY-MM-DD</nextbillingdate> 
</subscriptions>
</response>

To check subscription status from the sold software is done by posting to:

https://xml.bmtmicro.com/

<?xml version="1.0" encoding="utf-8"?>
<request>
<validatesubscription>
<productid>** PRODUCT ID **</productid>
<email>** EMAIL **</email> 
</validatesubscription>
</request>

This will return the following response like this:

<response>
<validatesubscription>
<subscription>
<status>active</status>
<expirationdate</>
<nextbillingdate>YYYY-MM-DD</nextbillingdate> 
<subscription>
</validatesubscription>
</response>

**Note that the expiration date is the date when the subscription went inactive. This field is always blank if the subscription is active. A date here indicates the day the subscription was cancelled.

Your APIToken can be found in the Settings section.

⟵ Back to XML Help