Manage resellers

All the reseller related APIs are encapsulated in the class Paxstore.OpenApi.ResellerApi.

User can customize the additional attributes for reseller. To add/delete/update reseller's additional entity attributes please using marketplace admin login and go to page via General Setting -> Entity Attribute Setting.

Constructors of ResellerApi

public ResellerApi(string baseUrl, string apiKey, string apiSecret, TimeZoneInfo timeZoneInfo = null, int timeout = 5000, IWebProxy proxy = null)
public ResellerApi(string baseUrl, string apiKey, string apiSecret, TimeZoneInfo timeZoneInfo)
public ResellerApi(string baseUrl, string apiKey, string apiSecret, IWebProxy proxy)
public ResellerApi(string baseUrl, string apiKey, string apiSecret, int timeout)

Constructor parameters description

Name	Type	Description
baseUrl	string	the base url of REST API
apiKey	string	the apiKey of marketplace, get this key from PAXSTORE admin console, refe to chapter Apply access rights
apiSecret	string	apiSecret, get api secret from PAXSTORE admin console, refer to chapter Apply access rights

Search resellers

API

public Result<PagedReseller> SearchReseller(int pageNo, int pageSize, ResellerSearchOrderBy orderBy, string name, ResellerStatus status)

Input parameter(s) description

Name	Type	Nullable	Description
pageNo	int	false	page number, value must >=1
pageSize	int	false	the record number per page, range is 1 to 100
orderBy	ResellerSearchOrderBy	false	the field name of sort order by. The value of the parameter can be one of ResellerSearchOrderBy.Name, ResellerSearchOrderBy.Phone and ResellerSearchOrderBy.Contact
name	string	true	search filter by reseller name
status	ResellerStatus	false	the reseller status the value can be ResellerStatus.All, ResellerStatus.Active, ResellerStatus.Inactive, ResellerStatus.Suspend. If the value is ResellerStatus.All it will return the resellers of all status

Sample codes

ResellerApi api = new ResellerApi (API_BASE_URL, API_KEY, API_SECRET);
Result<PagedReseller> result = api.SearchReseller(1, 10, ResellerSearchOrderBy.Name, null, ResellerStatus.All);

Client side validation failed sample result(JSON formatted)

{
	"BusinessCode": -1,
	"Message": null,
	"ValidationErrors": ["'Page No' must be greater than '0'."],
	"Data": null,
	"PageInfo": null
}

Successful sample result(JSON formatted)

{
	"BusinessCode": 0,
	"Message": null,
	"ValidationErrors": null,
	"Data": null,
	"PageInfo": {
		"PageNo": 1,
		"Limit": 10,
		"TotalCount": 2,
		"HasNext": false,
		"DataSet": [{
			"ID": 1000000211,
			"Name": "Pine Labs",
			"Phone": "",
			"Country": "",
			"Postcode": "",
			"Address": "",
			"Company": "",
			"Contact": "",
			"Email": "chenlb@paxsz.com",
			"Status": "A"
		}, {
			"ID": 1000000225,
			"Name": "reseller_002",
			"Phone": "89894545",
			"Country": "CN",
			"Postcode": "8954",
			"Address": "JiangSu Suzhou city xinghujie 203#",
			"Company": "pax",
			"Contact": "sam",
			"Email": "sam2@gmail.com",
			"Status": "A"
		}]
	}
}

The type in dataSet of is PagedReseller. And the structure shows like below.

Property Name	Type	Description
ID	long	the id of reseller
Name	string	the name of reseller
Phone	string	the phone number of reseller
Country	string	the country code, please refer to Country Codes
Postcode	string	the postcode of reseller
Email	string	the email of reseller
Status	string	the status of reseller, value can be one of A(Active), P(Pendding) and S(Suspend)

Possible client validation errors

'Page Size' must be less than or equal to '100'.
'Page No' must be greater than '0'.
'Page Size' must be greater than '0'.

Get a reseller

Get reseller by reseller id.

API

public Result<Reseller> GetReseller(long resellerId)

Input parameter(s) description

Parameter Name	Type	Nullable	Description
resellerId	long	false	the id of reseller

Sample codes

ResellerApi api = new ResellerApi (API_BASE_URL, API_KEY, API_SECRET);
Result<Reseller> result = api.GetReseller(1000000211);

Client side validation failed sample result(JSON formatted)

{
	"BusinessCode": -1,
	"Message": null,
	"ValidationErrors": ["Parameter resellerId cannot be null and cannot be less than 1!"]
	"Data": null,
	"PageInfo": null
}

Server side validation failed sample result(JSON formatted)

{
	"BusinessCode": -1760,
	"Message": "Reseller name already exists",
	"ValidationErrors": null,
	"Data": null,
	"PageInfo": null
}

Successful sample result(JSON formatted)

{
	"BusinessCode": 0,
	"Message": null,
	"ValidationErrors": null,
	"Data": {
		"EntityAttributeValues": {
			"111": "hello"
		},
		"Parent": {
			"ID": 4151,
			"Name": "New York"
		},
		"ID": 1000000211,
		"Name": "FVFFF",
		"Phone": "87879696",
		"Country": "CN",
		"Contact": "FFF",
		"Email": "sum@gmail.com",
		"Status": "S"
	}, 
	"PageInfo": null
}

The type of data is Reseller, and the structure shows below.

Name	Type	Description
ID	long	the id of reseller
Name	string	the name of reseller
Phone	string	the phone number of reseller
Country	string	the country code, please refer to Country Codes
Postcode	string	the postcode of reseller
Email	string	the email of reseller
Status	string	the status of reseller, value can be one of A(Active), P(Pendding) and S(Suspend)
Parent	SimpleReseller	reseller's parent
EntityAttributeValues	Dictionary<string, string>	dynamic attributes

Structure of SimpleReseller

Name	Type	Description
ID	long	the id of reseller
Name	string	the name of reseller

Possible client validation errors

Parameter resellerId cannot be null and cannot be less than 1!

Possible business codes

Business Code	Message	Description
1759	Reseller doesn't exist

Create a reseller

API

public Result<Reseller> CreateReseller(ResellerCreateRequest resellerCreateRequest)

Input parameter(s) description

Parameter Name	Type	Nullable	Description
resellerCreateRequest	ResellerCreateRequest	false	the create request object, the structure like below

Structure of class ResellerCreateRequest

Property Name	Type	Nullable	Description
Name	string	false	Name of reseller, max length is 64.
Email	string	false	Email of reseller, max length is 255.
Country	string	false	the country code, please refer to Country Codes
Contact	string	false	contact of reseller, max length is 64.
Phone	string	false	Phone number of reseller, max length is 32. Sample value 400-86554555.
Postcode	string	true	Post code, max length is 32. Sample value 510250.
Address	string	true	Address of reseller, max length is 255.
Company	string	true	Company of reseller, max length is 255.
ParentResellerName	string	true	Parent reseller name, if it is empty will set the root reseller of current marketplace as the parent reseller
EntityAttributeValues	Dictionary<string, string>	false	Dynamic attributes. Whether the attributes is required or not depends on the attributes configuration.
ActivateWhenCreate	bool	true	Whether to activate the reseller when create, default value is false. The property is private, please call the set method to set the value

Sample codes

ResellerApi api = new ResellerApi (API_BASE_URL, API_KEY, API_SECRET);
ResellerCreateRequest request = new ResellerCreateRequest();
request.Name = "Reseller For Test";
request.Address = "suzhou";
request.Email = "zhangsan@163.com";
request.Country = "CN";
request.Contact = "ZhangSan";
request.Phone = "88889999";
Result<Reseller> result = api.CreateReseller(request);

Client side validation failed sample result(JSON formatted)

{
	"BusinessCode": -1,
	"Message": null,
	"ValidationErrors": ["'Email' should not be empty.","'Country' should not be empty.","'Contact' should not be empty.","'Phone' should not be empty."],
	"Data": null,
	"PageInfo": null
}

Server side validation failed sample result(JSON formatted)

{
	"BusinessCode": 1760,
	"Message": "Reseller name already exists",
	"ValidationErrors": null,
	"Data": null,
	"PageInfo": null
}

Successful sample result(JSON formatted)

{
	"BusinessCode": 0,
	"Message": null,
	"ValidationErrors": null,
	"Data": {
		"DntityAttributeValues": {
			"111": "tan2"
		},
		"Parent": {
			"ID": 4151,
			"Name": "New York"
		},
		"ID": 51741,
		"Name": "reseller_abc",
		"Phone": "87879696",
		"Country": "CN",
		"Contact": "Sam",
		"Email": "sam@gmail.com",
		"Status": "P"
	},
	"PageInfo": null
}

Type of data is Reseller, same as the API get reseller.

Possible client validation errors

Parameter resellerCreateRequest cannot be null!
'Name' should not be empty.
'Email' should not be empty.
'Country' should not be empty.
'Contact' should not be empty.
'Phone' should not be empty.
'Email' is not a valid email address.
The length of 'Name' must be 64 characters or fewer. You entered 100 characters.
The length of 'Email' must be 255 characters or fewer. You entered 256 characters.
The length of 'Country' must be 64 characters or fewer. You entered 70 characters.
The length of 'Contact' must be 64 characters or fewer. You entered 70 characters.
The length of 'Phone' must be 32 characters or fewer. You entered 60 characters.
The length of 'Postcode' must be 16 characters or fewer. You entered 20 characters.
The length of 'Address' must be 255 characters or fewer. You entered 300 characters.
The length of 'Company' must be 255 characters or fewer. You entered 300 characters.
The length of 'Parent Reseller Name' must be 64 characters or fewer. You entered 70 characters.

Possible business codes

Business Code	Message	Description
1778	Parent reseller not found
1779	Parent reseller is not active
1782	At most 10 level resellers are supported
1760	Reseller name already exists
1762	Reseller name is mandatory
1763	Reseller contact is mandatory
1764	Reseller phone is mandatory
1765	Reseller email is mandatory
1606	Country is mandatory
1767	Reseller name is too long
1768	Reseller contact is too long
1769	Reseller phone is too long
1770	Reseller email is too long
1618	Postcode is too long
1619	Address is too long
1771	Reseller company is too long
1105	Email is invalid
1112	Phone No. is invalid
1624	The name cannot contain special characters	Name can contain the characters 0-9, a-z, A-Z, space, Chinese characters,(,),_,.
3400	Country code is invalid

Update a reseller

API

public Result<Reseller> UpdateReseller(long resellerId, ResellerUpdateRequest resellerUpdateRequest)

Input parameter(s) description

Parameter Name	Type	Nullable	Description
resellerId	long	false	Reseller's id.
resellerUpdateRequest	ResellerUpdateRequest	false	The update request object, the structure like below

Structure of class ResellerUpdateRequest

Property Name	Type	Nullable	Description
Name	string	false	Name of reseller, max length is 64.
Email	string	true	Email of reseller, max length is 255. Only the pending reseller can update the email. For other reseller change email please call replaceResellerEmail API. If email is empty API won't update the email.
Country	string	false	the country code, please refer to Country Codes
Contact	string	false	contact of reseller, max length is 64.
Phone	string	false	Phone number of reseller, max length is 32. Sample value 400-86554555.
Postcode	string	true	Post code, max length is 32. Sample value 510250.
Address	string	true	Address of reseller, max length is 255.
Company	string	true	Company of reseller, max length is 255.
ParentResellerName	String	true	Do not suggest set value for this property. If set value please keep the parentResellerName same as the original parentResellerName. Otherwise API will return a 1830 business code.
EntityAttributeValues	Dictionary<string, string>	false	Dynamic attributes. Whether the attributes is required or not depends on the attributes configuration.

Sample codes

ResellerApi api = new ResellerApi (API_BASE_URL, API_KEY, API_SECRET);
ResellerUpdateRequest updateRequest = new ResellerUpdateRequest();
updateRequest.Name = "Reseller For Test";
updateRequest.Address = "suzhou2";
updateRequest.Email = "zhangsan@163.com";
updateRequest.Country = "CN";
updateRequest.Contact = "ZhangSan2";
updateRequest.Phone = "44445555";
Result<Reseller> updateResult = api.UpdateReseller(resellerId, updateRequest);

Client side validation failed sample result(JSON formatted)

{
	"BusinessCode": -1,
	"Message": null,
	"ValidationErrors": ["'Country' should not be empty.","'Contact' should not be empty.","'Phone' should not be empty."],
	"Data": null,
	"PageInfo": null
}

Server side validation failed sample result(JSON formatted)

{
	"BusinessCode": 12000,
	"Message": "code is mandatory",
	"ValidationErrors": null,
	"Data": null,
	"PageInfo": null
}

Note: the code in message is the dynamic attribute for the above failed sample result

Successful sample result(JSON formatted)

{
	"BusinessCode": 0,
	"Message": "code is mandatory",
	"ValidationErrors": null,
	"Data": {
		"EntityAttributeValues": {
			"code": "XY"
		},
		"Parent": {
			"ID": 4151,
			"Name": "New York"
		},
		"ID": 17850,
		"Name": "FVFFF",
		"Phone": "87879696",
		"Country": "CN",
		"Contact": "FFF",
		"Email": "FF@1234.COM",
		"Status": "S"
	},
	"PageInfo": null
}

Type of data is Reseller, same as the API get reseller.

Possible client validation errors

Parameter resellerId cannot be null and cannot be less than 1!
'Name' should not be empty.
'Country' should not be empty.
'Contact' should not be empty.
'Phone' should not be empty.
'Email' is not a valid email address.
The length of 'Name' must be 64 characters or fewer. You entered 100 characters.
The length of 'Email' must be 255 characters or fewer. You entered 256 characters.
The length of 'Country' must be 64 characters or fewer. You entered 70 characters.
The length of 'Contact' must be 64 characters or fewer. You entered 70 characters.
The length of 'Phone' must be 32 characters or fewer. You entered 60 characters.
The length of 'Postcode' must be 16 characters or fewer. You entered 20 characters.
The length of 'Address' must be 255 characters or fewer. You entered 300 characters.
The length of 'Company' must be 255 characters or fewer. You entered 300 characters.
The length of 'Parent Reseller Name' must be 64 characters or fewer. You entered 70 characters.

Possible business codes

Business Code	Message	Description
1759	Reseller doesn't exist
1762	Reseller name is mandatory
1760	Reseller name already exists
1764	Reseller phone is mandatory
1606	Country is mandatory
1763	Reseller contact is mandatory
1767	Reseller name is too long
1769	Reseller phone is too long
1768	Reseller contact is too long
1618	Postcode is too long
1619	Address is too long
1771	Reseller company is too long
1770	Reseller email is too long
1105	Email is invalid
1112	Phone No. is invalid
1624	The name cannot contain special characters	Name can contain the characters 0-9, a-z, A-Z, space, Chinese characters,(,),_,.
3400	Country code is invalid
1830	Cannot update reseller's parent

Activate a reseller

API

If activate reseller successfully there's not response content from remote server. So the data field in result is null whether activate sucessfully not not.

public Result<string> ActivateReseller(long resellerId)

Input parameter(s) description

Parameter Name	Type	Nullable	Description
resellerId	long	false	The reseller's id.

Sample codes

ResellerApi api = new ResellerApi (API_BASE_URL, API_KEY, API_SECRET);
Result<string> result = api.ActivateReseller(51739L);

Client side validation failed sample result(JSON formatted)

{
	"BusinessCode": -1,
	"Message": null,
	"ValidationErrors": ["Parameter resellerId cannot be null and cannot be less than 1!"],
	"Data": null,
	"PageInfo": null
}

Server side validation failed sample result(JSON formaatted)

{
	"BusinessCode": 1891,
	"Message": "The reseller has already been activated!",
	"ValidationErrors": null,
	"Data": null,
	"PageInfo": null
}

Succssful sample result(JSON formatted)

{
	"BusinessCode": 0,
	"Message": null,
	"ValidationErrors": null,
	"Data": null,
	"PageInfo": null
}

Possible client validation errors

Parameter resellerId cannot be null and cannot be less than 1!

Possible business codes

BusinessCode	Message	Description
1759	Reseller doesn't exist	The input reseller id not correct.
1891	The reseller has already been activated!
1894	The reseller's parent is not active

Disable a reseller

API

If disable successfully there's no response content from remote server. So the data field in result is null whether disable successfully or not.

public Result<string> DisableReseller(long resellerId)

Input parameter(s) description

Parameter Name	Type	Nullable	Description
resellerId	long	false	The reseller's id.

Sample codes

ResellerApi api = new ResellerApi (API_BASE_URL, API_KEY, API_SECRET);
Result<string> result = api.DisableReseller(51739L);

Client side validation failed sample result(JSON formatted)

{
	"BusinessCode": 01,
	"Message": null,
	"ValidationErrors": ["Parameter resellerId cannot be null and cannot be less than 1!"],
	"Data": null,
	"PageInfo": null
}

Server side validation failed sample result(JSON formatted)

{
	"BusinessCode": 1886,
	"Message": "The reseller is not active,unable to disable!",
	"ValidationErrors": null,
	"Data": null,
	"PageInfo": null
}

Successful sample result(JSON formatted)

{
	"BusinessCode": 0,
	"Message": null,
	"ValidationErrors": null,
	"Data": null,
	"PageInfo": null
}

Possible client validation errors

Parameter resellerId cannot be null and cannot be less than 1!

Possible business codes

BusinessCode	Message	Description
1759	Reseller doesn't exist	The input reseller id not correct.
1886	The reseller is not active,unable to disable!
1793	The reseller has active merchants
1794	The reseller has active terminals
1795	The reseller has active terminal groups
1781	The reseller has active sub-resellers

Delete a reseller

API

If delete reseller successfully there's not response content from remote server. And the data field in result is always null.

public Result<string> DeleteReseller(long resellerId)

Input parameter(s) description

Parameter Name	Type	Nullable	Description
resellerId	long	false	The reseller's id.

Sample codes

ResellerApi api = new ResellerApi (API_BASE_URL, API_KEY, API_SECRET);
Result<string> result = api.DeleteReseller(51739L);

Client side validation failed sample result(JSON formatted)

{
	"BusinessCode": -1,
	"Message": null,
	"ValidationErrors": ["Parameter resellerId cannot be null and cannot be less than 1!"],
	"Data": null,
	"PageInfo": null
}

Server side validation failed sample result(JSON formatted)

{
	"BusinessCode": 1759,
	"Message": "Reseller doesn't exist",
	"ValidationErrors": null,
	"Data": null,
	"PageInfo": null
}

Successful sample result

{
	"BusinessCode": 0,
	"Message": null,
	"ValidationErrors": null,
	"Data": null,
	"PageInfo": null
}

Possible client validation errors

Parameter resellerId cannot be null and cannot be less than 1!

Possible business codes

BusinessCode	Message	Description
1759	Reseller doesn't exist	The input reseller id not correct.
1875	The reseller is active,unable to delete!
1775	Not allowed to delete the reseller of current user
1761	Reseller has been used by merchant
1785	The reseller has been used by terminal
1788	The reseller has been used by terminal group
1780	The reseller has sub-resellers

Replace reseller email

API

This API is used to update email of the active resellers

public Result<string> replaceResellerEmail(long resellerId, string email)

Input parameter(s) description

Parameter Name	Type	Nullable	Description
resellerId	long	false	The reseller's id.
email	string	false	The new email address.

Sample codes

ResellerApi api = new ResellerApi (API_BASE_URL, API_KEY, API_SECRET);
Result<string> result = API.replaceResellerEmail(1000000267, "zhangsan@pax.com");

Client side validation failed sample result(JSON formatted)

{
	"BusinessCode": -1,
	"Message": null,
	"ValidationErrors": ["Parameter resellerId cannot be null and cannot be less than 1!"],
	"Data": null,
	"PageInfo": null
}

Server side validation failed sample result(JSON formatted)

{
	"BusinessCode": 1759,
	"Message": "Reseller doesn't exist",
	"ValidationErrors": null,
	"Data": null,
	"PageInfo": null
}

Successful sample result

{
	"BusinessCode": 0,
	"Message": null,
	"ValidationErrors": null,
	"Data": null,
	"PageInfo": null
}

Possible client validation errors

Parameter resellerId cannot be null and cannot be less than 1! 'Email' should not be empty. The length of 'Email' must be 255 characters or fewer. You entered 256 characters.
'Email' is not a valid email address.

Possible business codes

BusinessCode	Message	Description
1759	Reseller doesn't exist	The input reseller id not correct.
131	Insufficient access right	This may caused by updating the root reseller's email
1932	The reseller is not active,unable to replace user!	This API can only the active reseller's email
1105	Email is invalid	Email address is not valid
1933	The user email not update.	The inputted email address is same as the original email

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

RESELLER_API.md

RESELLER_API.md

Manage resellers

Search resellers

Get a reseller

Create a reseller

Update a reseller

Activate a reseller

Disable a reseller

Delete a reseller

Replace reseller email

Files

RESELLER_API.md

Latest commit

History

RESELLER_API.md

File metadata and controls

Manage resellers

Search resellers

Get a reseller

Create a reseller

Update a reseller

Activate a reseller

Disable a reseller

Delete a reseller

Replace reseller email