Subscription is created via API without physical hosting on Plesk for Linux

Symptoms

• Some billing system is used to create subscriptions in Plesk via XML API.
• Subscription is created successfully, but without website hosting.
• If enable debug logging in Plesk, no errors can be found in /var/log/plesk/panel.log . Subscription creation begins with the following API request:

  <packet version="1.6.0.2">
  <domain>
          <add>
                  <gen_setup>
                          <name>example.com</name>
                          <owner-id>123</owner-id>
                          <ip_address>203.0.113.2</ip_address>
                          <status>0</status>
                  </gen_setup>
                  <prefs>
                          <www>true</www>
                  </prefs>
                  <template-name>Service_Plan</template-name>
          </add>
  </domain>
  </packet>
  

• Subscription with website hosting can be created via Plesk interface without any issues.

Cause

Incorrect API request is sent from the billing system to Plesk:

• Old API version (1.6.0.2) is used. Actual API version for Plesk Onyx is 1.6.8.0.
• Outdated <domain> tag is used.

Resolution

Generate correct API request in the billing system:

<packet version="1.6.8.0">
<webspace>
        <add>
                <gen_setup>
                        <name>example.com</name>
                        <owner-id>123</owner-id> 
                        <htype>vrt_hst</htype>
                        <ip_address>203.0.113.2</ip_address>
                        <status>0</status>
                </gen_setup>
                <hosting>
                        <vrt_hst>
                                <property>
                                        <name>ftp_login</name>
                                        <value>user</value>
                                </property>
                                <property>
                                        <name>ftp_password</name>
                                        <value>password</value>
                                </property>
                                <ip_address>203.0.113.2</ip_address>
                        </vrt_hst>
                </hosting>
        <plan-name>Service_Plan</plan-name>
        </add>
</webspace>
</packet>

Additional Information

XML API Guide. Creating a Subscription