modify subreseller
Modify a subreseller account.
Request parameters for modify subreseller
Standard parameters
- action = modify
- object = subreseller
Attributes
Parameters within the attributes associative array are described below.
Parameter name | Obligation | Definition/Value |
---|---|---|
allowed_tld_list | Optional | List of TLDs that the subeseller is allowed to sell. |
ccp_enabled | Required | Indicates whether credit card payments are allowed for the subreseller. N—No Y—Yes |
contact_set | Required | Subreseller’s contact information. The admin contact for a subreseller is the Emergency Contact, which is not the same as a domain admin contact. The following values are required for the subreseller admin contact: first_name, last_name, org_name, phone, and email. For tech contact, you can include any of the fields explained in the contact_set section; however, you must include first_name, last_name, org_name, address1, city, phone, and email. If country is Canada or U.S, you must also include the state and postal code parameters. |
low_balance_email | Required | The email address to which notices are sent when the subreseller's account balance falls to a predefined level. |
nameservers | Optional | List of default nameservers for the subreseller. |
password | Required | Password for the subreseller account. |
payment_email | Optional | The email address to which payment notices are sent. |
pricing_plan | Required | The pricing plan assigned to the subreseller. |
status | Required | Set the status of the account. Allowed values are active, onhold, locked, canceled, and paid_only. |
storefront_rwi | Optional | Determines whether the subreseller sees the Storefront link in the RWI (and hence whether the subreseller can configure a Storefront). N—Do not display the Storefront link; this is the default. Y—Display the Store front link |
system_status_email | system_status_email | The email address that will receive system status messages. |
url | Optional | The web address of the account. |
username | Required | Username for the new subreseller. |
Response parameters for modify subreseller
Standard parameters
- action = reply
- is_success = a Boolean is returned, indicating success or failure of the request
- response_code = response code indicating outcome of the request
- response_text = message describing the outcome of the request
Examples for modify subreseller
Request
<?xml version=’1.0’ encoding=’UTF-8’ standalone=’no’ ?>
<!DOCTYPE OPS_envelope SYSTEM ’ops.dtd’>
<OPS_envelope>
<header>
<version>0.9</version>
</header>
<body>
<data_block>
<dt_assoc>
<item key='protocol'>XCP</item>
<item key='action'>MODIFY</item>
<item key='object'>SUBRESELLER</item>
<item key='attributes'>
<dt_assoc>
<item key='url'>testurlupdate.com</item>
<item key='nameservers'>
<dt_assoc>
<item key='fqdn1'>ns1.systemdns.com</item>
<item key='fqdn2'>ns2.systemdns.com</item>
</dt_assoc>
</item>
<item key='payment_email'>[email protected]</item>
<item key='pricing_plan'>silver</item>
<item key='status'>cancelled</item>
<item key='username'>sub1240929148892</item>
<item key='contact_set'>
<dt_assoc>
<item key="admin">
<dt_assoc>
<item key="email">[email protected]</item>
<item key="phone">+1.4165551123x333</item>
<item key="phone2"></item>
<item key="first_name">John</item>
<item key="last_name">Doe</item>
</dt_assoc>
</item>
<item key="tech">
<dt_assoc>
<item key="org_name">Sub Reseller Company Inc.</item>
<item key="first_name">John</item>
<item key="last_name">Doe</item>
<item key="title">CEO</item>
<item key="phone">+1.4165551122x333</item>
<item key="fax"></item>
<item key="email">[email protected]</item>
<item key="address1">55 Reseller Ave</item>
<item key="address2">Suite 99</item>
<item key="address3"></item>
<item key="city">New York</item>
<item key="state">NY</item>
<item key="postal_code">70218</item>
<item key="country">US</item>
</dt_assoc>
</item>
</dt_assoc>
</item>
<item key='storefront_rwi'>Y</item>
<item key='ccp_enabled'>Y</item>
<item key='low_balance_email'>[email protected]</item>
<item key='password'>test123</item>
<item key='system_status_email'>[email protected]</item>
</dt_assoc>
</item>
</dt_assoc>
</data_block>
</body>
</OPS_envelope>
Response
<?xml version='1.0' encoding='UTF-8' standalone='no'?>
<!DOCTYPE OPS_envelope SYSTEM 'ops.dtd'>
<OPS_envelope>
<header>
<version>0.9</version>
</header>
<body>
<data_block>
<dt_assoc>
<item key="protocol">XCP</item>
<item key="object">SUBRESELLER</item>
<item key="response_text">Reseller sub1240929148892 successfully modified</item>
<item key="action">REPLY</item>
<item key="response_code">200</item>
<item key="is_success">1</item>
</dt_assoc>
</data_block>
</body>
</OPS_envelope>
Updated almost 2 years ago