reseller

is added when reseller has a customer specific business

Adding / Modifying a WebMoney Gateway

Integrating a WebMoney Gateway with our system simply requires filling in a form specifying your preferences and account details.

Before you Start

You will need to know your WebMoney Purse Number and Secret Key, to add this payment gateway to your Reseller Account. The Purse Number and Secret Key will be generated for your Merchant Account once, you complete the sign-up process at WebMoney.

Settings for your WebMoney Merchant Account

You need to set/specify the below details in the Settings section of your Webmoney Merchant Account:

  • Test/Work mode: Set this to Work.

  • Send to Result URL, in case the privacy is provided: Leave this checkbox unchecked.

  • Send parameters in the preliminary inquiry: Select this option.

  • Result URL, Success URL & Failure URL: Leave this blank.

  • Proxy for Result URL: Leave this blank.

  • Let to use URL sent in form: Select this option.

  • Allow URLs transmitted in the form: Select this option.

  • Control sign forming method: Set this as SHA256 or MD5.

    Note

    Only SHA256 and MD5 are supported as data integrity verification algorithms in our system.

Adding the WebMoney Gateway into your Reseller Account

  1. Login to your Reseller Control Panel. See details

  2. In the Menu, point to Settings -> Finance & Billing -> Payment Gateway and click on List / Add.

  3. Click on the Add a Gateway link.

  4. Click on the Add a WebMoney Gateway link.

  5. Enter the following details and save your changes by clicking on the Submit button:

    • Gateway Name: This Gateway Name will be shown to your Customers / Sub-Resellers, when they are about to make a payment. You may provide a name like WebMoney.

    • Purse number: WMID is a unique 12-digit number, which is the address of a member within the WebMoney system. WM purse (or just a Purse) is an attribute registered under the WMID and used to transfer funds. Specify your Purse number here.

    • WMID: This is the WMID associated with your WebMoney Account.

    • Secret Key: This is the Secret Key associated with your WebMoney Account.

    • Currency: Select the currency in which you want to charge your Customers / Sub-Resellers. The currencies supported are US Dollar, Russian Rouble, Euro, Ukraine Hryvnia and Belarusian Ruble. Your Merchant Account needs to support the currency that is selected here.

    • Currency Exchange Rate: If the currency you selected in the previous option varies from your Selling Currency, we will have to convert the Invoice value to the WebMoney Currency, before we send your Customer's / Sub-Reseller's details to WebMoney. For this purpose, the system needs an exchange rate between the two.

      You may choose to maintain this exchange rate yourself or let us maintain it for you. We download forex rates on a daily basis from a recognized source and update exchange rates for you. If, however, you wish to update the rates yourself, then you may do so by selecting the I would like to Maintain the currency exchange rate myself checkbox AND entering your own conversion rate.

    • Payment Gateway Access Level for Customers / Sub-Resellers: Select appropriate Access Levels for your Customers / Sub-Resellers.

    • Credit a Customer / Sub-Reseller with the Net Amount in an Add Funds transaction: WebMoney deducts a fee on a per transaction basis. There are two types of Transactions that can pass through your WebMoney integration - Invoice/Debit Note Payment and Add Funds.

      In case of an Add Funds transaction, you have the option of crediting your Customers / Sub-Resellers with the Net amount that WebMoney credits you with, or choose to credit them with the Gross funds and bear the charges yourself.

      The Net amount is calculated by subtracting the per transaction charges from the transaction amount. The per transaction charges are calculated by adding the Total Fixed fee charged per transaction and the Total Variable fee charged per transaction.

      Lets say WebMoney charges you 3% + 15 cents per transaction. We will use this example to explain the two fields listed below.

    • Total Fixed fee charged per transaction for your merchant account (Per Transaction Fixed Fee charged by your Bank + Per Transaction Fixed Fee charged by WebMoney): Enter the total fixed fee that is charged per transaction in this field. If there is no fixed fee charged per transaction, then enter the value as 0.

      Given the example above, enter 15 cents in this field. This is the fixed component that is levied on every transaction. You could also add any bank charges you have to bear per transaction here.

    • Total Variable fee charged per transaction for your merchant account: Enter the total variable fee that is charged per transaction in this field. If there is no variable fee charged per transaction, then enter the value as 0.

      From the example above, enter 3% in the field here. This charge varies with the value of the transaction and hence forms the variable fee.

      Note

      If you have selected to credit a Customer / Sub-Reseller with the Net amount in an Add Funds transaction, then you must submit either a Fixed Transaction fee (greater than 0) or a Variable Transaction fee (greater than 0).

    • Send me a Reminder if a transaction is pending for more than x days: In case you have not yet accepted a payment sent to you via the WebMoney Payment Gateway, you can get e-mail reminders sent to you daily after x number of days from the payment date, until you either Approve or Decline the payment.

    • Display Position: If you plan on adding multiple Gateways, you can select the position in which you wish to display this Gateway on your Payment Page.

Note

The SuperSite contains information about the various payment options you offer to your Customers, which are presented at the time of purchasing Products and Services. Once you have added a WebMoney Payment Gateway, it will be included in the payment options on your SuperSite automatically.

Additional Information

SuperSite

Get Reseller Pricing

Description

Use this method to get details of the pricing for the Managed Server Linux plans for your Sub-Resellers.

Response

Returns a map with the prices of the Managed Server Linux plans along with the prices of the other products.

The response structure for the Managed Server Linux product will be:


"productkey":
{
"addons":
{
"addon1-name":price,
"addon2-name":price
},
"plans":
{
"planid":
{
"action":
{
"tenure-in-months":price
},
}
}
}

Example:


"managedserverlinuxus":
{
"addons":
{
"storage_1":0.0,
"cpanel":0.0,
"whmcs":0.0,
"ipaddress":0.0,
"storage_5":0.0,
"storage_4":0.0,
"storage_3":0.0,
"storage_2":0.0
},
"plans":
{
"300011":
{
"renew":
{
"1":0.0
},
"add":
{
"1":0.0
}
},
"300012":
{
"renew":
{
"1":0.0
},
"add":
{
"1":0.0
}
}
"300013":
{
"renew":
{
"1":0.0
},
"add":
{
"1":0.0
}
}
"300014":
{
"renew":
{
"1":0.0
},
"add":
{
"1":0.0
}
}
}
}

Get Customer Pricing

Description

Use this method to get details of the pricing for the Managed Server Linux plans for your Customers.

Response

Returns a map with the prices of the Managed Server Linux plans along with the prices of the other products.

The response structure for the Managed Server Linux product will be:


"productkey":
{
"addons":
{
"addon1-name":price,
"addon2-name":price
},
"plans":
{
"planid":
{
"action":
{
"tenure-in-months":price
},
}
}
}

Example:


"managedserverlinuxus":
{
"addons":
{
"storage_1":0.0,
"cpanel":0.0,
"whmcs":0.0,
"ipaddress":0.0,
"storage_5":0.0,
"storage_4":0.0,
"storage_3":0.0,
"storage_2":0.0
},
"plans":
{
"300011":
{
"renew":
{
"1":0.0
},
"add":
{
"1":0.0
}
},
"300012":
{
"renew":
{
"1":0.0
},
"add":
{
"1":0.0
}
}
"300013":
{
"renew":
{
"1":0.0
},
"add":
{
"1":0.0
}
}
"300014":
{
"renew":
{
"1":0.0
},
"add":
{
"1":0.0
}
}
}
}

Search Orders

Description

Gets a list and details of the Managed Server Linux Orders matching the search criteria.

Parameters

Name Data Type Required / Optional Description
auth-userid Integer Required Authentication Parameter
api-key String Required Authentication Parameter
no-of-records Integer Required Number of Orders to be fetched
page-no Integer Required Page number for which details are to be fetched
order-id Array of Integers Optional Order ID(s) of the Managed Server Linux Order(s) whose details need to be fetched
reseller-id Array of Integers Optional Reseller ID(s) whose Managed Server Linux Orders need to be fetched
customer-id Array of Integers Optional Customer ID(s) whose Managed Server Linux Orders need to be fetched
show-child-orders Boolean Optional Whether Sub-Reseller Orders need to be fetched or not
status Array of Strings Optional Status of the Order: Active, InActive, Suspended or Deleted
domain-name String Optional Name of the Domain of the Managed Server Linux Order
creation-date-start String Optional UNIX TimeStamp for listing of the Managed Server Linux Orders whose Creation Date is greater than creation-date-start
creation-date-end String Optional UNIX TimeStamp for listing of the Managed Server Linux Orders whose Creation Date is less than creation-date-end
expiry-date-start String Optional UNIX TimeStamp for listing of the Managed Server Linux Orders whose expiry date is greater than expiry-date-start
expiry-date-end String Optional UNIX TimeStamp for listing of the Managed Server Linux Orders whose expiry date is less than expiry-date-end
order-by Array of Strings Optional One or more parameters by which you want to sort the Orders. Default is orderid.

Example:

If page-no is 1, no-of-records is 30 and order-by is orderid; it will fetch the first 30 Orders which suit the search criteria sorted by orderid.
If page-no is 2, no-of-records is 30 and order-by is orderid; it will fetch the second batch of 30 Orders sorted by orderid.

HTTP Method

GET

Example Test URL Request


https://test.httpapi.com/api/managedserver/linux/us/search.json?auth-userid=0&api-key=key&no-of-records=1&page-no=1

Response

Returns a hash map containing the below details of the Managed Server Linux Orders which match the search criteria:

  • Domain Name (entity.description)

  • Order Id (orders.orderid)

  • Customer Id (entity.customerid)

  • Order Creation Timestamp (orders.creationtime)

  • Order Expiry Timestamp (orders.endtime)

  • Current Order Status (entity.currentstatus) - value will be InActive, Active, Suspended or Deleted

  • Product Name (entitytype.entitytypename)

  • Product Key (entitytype.entitytypekey)

  • Type of Operating System (hosting_group_info.os_type)

  • Data Center location for the Managed Server (hosting_group_info.location)

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

Get Order Id

Description

Gets the associated Managed Server Linux Order ID for the specified domain name.

Parameters

Name Data Type Required / Optional Description
auth-userid Integer Required Authentication Parameter
api-key String Required Authentication Parameter
domain-name String Required The domain name for which the Order ID is to be fetched

HTTP Method

GET

Example Test URL Request


https://test.httpapi.com/api/managedserver/linux/us/orderid.json?auth-userid=0&api-key=key&domain-name=domainname.asia

Response

Returns the associated Managed Server Linux Order ID (Integer) of the domain name.

Get Plan Details

Description

Use this method to get details of your plans.

Response

Returns details of the plans of the Managed Server Linux product, along with the plan details of other Products of the Reseller.

Example:

The response structure for the Managed Server Linux product will be:


"managedserverlinuxus":
{
"plan-id":
{
"supported_os":
[
{
"os_display_name":"OS Display Name",
"os_name":"OS Name",
"addons":
[
{
"addon_name":"storage_1",
"type":"SATA",
"is_paid":(true or false),
"space":51200,
"free_quantity":0,
"conflicting_addon_names":[]
},
{
"addon_name":"storage_2",
"type":"SATA",
"is_paid":(true or false),
"space":102400,
"free_quantity":0,
"conflicting_addon_names":[]
},
{
"addon_name":"storage_3",
"type":"SATA",
"is_paid":(true or false),
"space":204800,
"free_quantity":0,
"conflicting_addon_names":[]
},
{
"addon_name":"storage_4",
"type":"SATA",
"is_paid":(true or false),
"space":307200,
"free_quantity":0,
"conflicting_addon_names":[]
},
{
"addon_name":"storage_5",
"type":"SATA",
"is_paid":(true or false),
"space":512000,
"free_quantity":0,
"conflicting_addon_names":[]
},
{
"addon_name":"ipaddress",
"is_paid":(true or false),
"free_quantity":2,
"conflicting_addon_names":[]
},
{
"addon_name":"cpanel",
"is_paid":(false),
"free_quantity":0,
"conflicting_addon_names":[]
},
{
"addon_name":"whmcs",
"is_paid":(true or false),
"free_quantity":0,
"conflicting_addon_names":[]
}
],
"is_default"(true or false)
}
],
"plan_name":"Plan Name",
"plan_status":"Active",*
"bandwidth":value,
"ram":
{
"ram_memory":value,
"ram_type":"RAM Type"
},
"storage":
{
"storage_raid_level":value,
"storage_space":value,
"storage_type":"SATA"
},
"cpu":
{
"cpu_speed":"value",
"cpu_hyper_threaded":(true or false),
"cpu_processor_type":"Processor Type",
"cpu_cores":value
}
}
}

Get Details

Description

Gets the details of an existing Managed Server Linux Order.

Parameters

Name Data Type Required / Optional Description
auth-userid Integer Required Authentication Parameter
api-key String Required Authentication Parameter
order-id Integer Required Order ID of the Order for which the details are to be fetched

HTTP Method

GET

Example Test URL Request


https://test.httpapi.com/api/managedserver/linux/us/details.json?auth-userid=0&api-key=key&order-id=0

Response

Returns a hash map containing the below details:

  • Order ID (entityid)

  • Order Description (description)

  • Domain Name (domainname)

  • Current Order Status under the System (currentstatus) - value will be InActive, Active, Suspended or Deleted

  • Product key (productkey)

  • Product Category (productcategory)

  • Order Creation Date (creationtime)

  • Expiry Date (endtime)

  • Whether Order belongs to a Customer directly under the Reseller (isImmediateReseller)

  • Reseller Chain by RID (parentkey)

  • Customer ID Associated with the Order (customerid)

  • Whether Order Suspended due to Expiry (isOrderSuspendedUponExpiry)

  • Whether Order Suspended by Parent Reseller (orderSuspendedByParent)

  • Whether Order Deletion is Allowed (allowdeletion)

  • Cost Price for Reseller (resellercost)

  • Cost Price for Customer (customercost)

  • IP Address (ipaddress)

  • Plan ID of the Managed Server Plan (planid)

  • Status of the Managed Server Plan (paused)

  • Admin User for the Managed Server Order (siteadminusername)

  • Password for the above Admin USer (siteadminpassword)

  • Installed Operating System (os_name)

  • Details of the Addons (addons)

    • Addon ID of the Addon (addon_id)

    • Addon Name (addon_name)

    • Addon Creation Date (creation_time)

    • Payment Status for the Addon (is_paid)

    • IP Address (ipaddress)

    • WHMCS License Key (license_key)

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