If you have your own system and would like to create a reseller account without having to use our dashboard, we have now created an API allowing you to do just that! This API is for server to server communication, in case you have your own CRM system or something similar, to manage your customer base.
- Parameters (Bold are mandatory) - if the optional parameters are not supplied, then there is no value set to these fields.
|
Parameter Name (Case Sensitive) |
Value |
Description |
Default Value |
|
ev |
createReseller |
Must be this value |
|
|
user (mandatory) |
Admin’s username |
The admin’s username that matches the api_id |
|
|
api_id (mandatory) |
Admin’s Api Id |
The admin’s api_id that matches the username |
Generated from edit profile |
|
fname (mandatory) |
Reseller's First Name |
Reseller’s First Name |
|
|
lname (mandatory) |
Reseller’s Last Name |
Reseller’s Last Name |
|
|
email (mandatory) |
Reseller’s email |
Reseller’s email |
|
|
company (mandatory)
|
Reseller’s company name |
Reseller’s company name |
|
|
phone (mandatory) |
Reseller’s local phone |
Reseller’s local phone |
|
|
user_name |
User Name |
The reseller's user name (if not supplied then the email will be the user name) |
email parameter |
|
activated
|
true / false |
If true, will activate the account of this new advertiser |
false |
|
send_email
|
true / false |
If false, will not send a welcome email with user name and password to the new advertiser |
true |
|
password |
Advertiser password |
* Minimum 6 Characters * Password must contains one letter and one number * Password cannot contain the following characters: #, %, &, + |
Password is generated automatically |
|
pre_paid |
true / false |
If true, indicates that this is a pre paid account |
false |
|
auto_charge |
true / false |
If true, indicates that this account will be billed automatically on his/her bills in case it have a credit card data at his account |
false |
|
agree_notifications |
true / false |
If true, then set the agree to get notification by mail to true (If supplied, you must ask the user to agree to that at your side) |
|
|
agree_terms |
true / false |
If true, then set the agree to terms and conditions to true (If supplied, you must ask the user to agree to that at your side) |
|
|
isRevenueShare |
true / false |
Indicates if this reseller is on Fix price mode or revenue share mode (revenue share mode available only if you have the billing system) |
Default value is taken from Account Setup --> Resellers |
|
freeCreditsAtSignup |
Number |
Free credits that assign to this reseller, applicable only if this is reseller with fix price |
Default value is 0 |
|
subscriptionFee |
Number |
Monthly cost for this reseller |
Default value is taken from package |
|
monthlyLimit |
Number |
How many credits this reseller's advertisers can use every month |
Default value is taken from package |
|
advertiserSubscriptionFeeCost |
Number |
Monthly cost per active advertiser |
Default value is taken from package |
|
codeKeywordLeaseCost |
Number |
Monthly cost per code keyword |
Default value is taken from package |
|
creditPriceCost |
Number |
Cost per 1 credit |
Default value is taken from package |
|
enableBranding |
true / false |
Indicated if reseller's branding is enabled |
Default value is taken from package |
|
enableSales |
true / false |
Indicated if sales agents is enabled |
Default value is taken from package |
|
freeKeywords |
Number |
How many free key words this reseller will get for free every month |
Default value is taken from package |
|
freePremiumMobileSites |
Number |
How many free premium mobile sites this reseller gets for free every month |
Default value is taken from package |
|
keywordLeasePriceCost |
Number |
Monthly cost per custom / vanity keyword |
Default value is taken from package |
|
premiumMobileSitesCost |
Number |
Monthly cost per premium mobile site |
Default value is taken from package |
|
revenueShare |
Number 0-100 |
If this reseller has revenue share mode, then indicate the revenue share value |
Default value is taken from package |
|
freeCreditsIncluded |
Number |
How many free credits is included is the subscription fee |
Default value is taken from package |
|
commissionUserId |
Number |
Indicate a user id that need to get commission for this new reseller. Must supply also the commissionPercent parameter. Available only to white label with billing system |
|
|
commissionPercent |
Number |
Indicates the commission percent for the commissionUserId parameter. |
|
|
packageId |
Number |
Indicates the reseller package id that this reseller will be assigned to. All the prices will be taken from this package unless override by a specific parameter. |
If packageId not supplied then the first level package from your account will be used. |
- Return Code
- If the API succeeds, then it will return with status code 200, which will give the following message: “User created successfully".
- If an error occurs or there is an invalid parameter, then it will return with status code 400 or 500 with an error message in the response.
Example:
https://mcpn.us/api?ev=createReseller&user=adminuser&api_id=A1H444h07FhB65dn&fname=Jhon&lname=Smith&email=jsmith@gmail.com&company=mycomany&phone=17225555555
Comments
0 comments
Article is closed for comments.