PAXSTORE exposes reseller, merchant, terminal and merchant category related APIs for thirdparty system convenience. So that the authorized thirdparty systems can do operations for reseller, merchant, terminal and merchant category without logging into PAXSTORE's admin console. The exposed API is RESTful formatted. PAXSTORE provides this dotnet SDK to simplify the remote invoke.

All the APIs of this SDK will return the object Paxstore.OpenApi.Model.Result.
When using the SDK to call the REST APIs it will do basic validations like required validation and length validation for the inputted parameter(s) before the SDK send the request to remote server. And if the basic validation failed SDK will return the Result object with BusinessCode=-1 and the ValidationErrors.

Below is the structure of class Paxstore.OpenApi.Model.Result

For API requests using apiKey and apiSecret, you can make up to 3000 requests per 10 minutes. Authenticated requests are associated with the apiKey and apiSecret. This means that all thirdparty systems using the same apiKey and apiSecret share the same quota of 3000 requests per 10 minutes.

For unauthenticated requests, the rate limit allows for up to 20 requests per 30 minutes. Unauthenticated requests are associated with the originating IP address.

The returned HTTP headers of any API request show your current rate limit status:

The above 3 response headers are encapsulated in class of Paxstore.OpenApi.Model.Result.

If you exceed the rate limit, an error response code is 429:

The default value of connect timeout and read timeout is 5000(milliseconds). And the configuration is API level.

Sample of configure connect timeout and read timeout

AppApi API = new AppApi(TestConst.API_BASE_URL, TestConst.API_KEY, TestConst.API_SECRET);
API.SetConnectionTimeoutTime(30000);
API.SetReadWriteTimeoutTime(30000);

If the proxy is not setted, request will go to Paxstore directly. If the server of thirdparty system does not have the abiliti to access Paxstore directly duto security purpose they can use proxy. The proxy configuration is API level. Below is the interface to set proxy.

public void SetProxy(IWebProxy proxy)

Sample codes

ResellerApi API = new ResellerApi(TestConst.API_BASE_URL, TestConst.API_KEY, TestConst.API_SECRET);
IWebProxy proxy = new WebProxy("localhost", 1080);
ICredentials credentials = new NetworkCredential("username", "password");
proxy.Credentials = credentials;
API.SetProxy(proxy);

Note: If the proxy server don't need username and password the credentials is not needed.

If the thirdparty systems want to call the REST APIs they must enable external system access in PAXSTORE admin console for the certain marketplaces and get the access key and access secret.

Below are the step for enabling external system access and get access key and access secret.

Log in to PAXSTORE admin console as Super Admin or Market Admin and click General Setting in left menu.

Click the left tab External System to show the external system configuration page.

From above screenshot we know the external system access is disabled by default. To enable it please click the enable/disable switch. And once user clicked the switch it will pop up a confirm dialog to let user confirm.

Click OK button to continue enabling the external system access. Click the CANCEL button to cancel current operation to keep external system access disabled.

After click OK button the external system access is enabled and the access key is shown in the page. But the access secret is replaced by asterisks for security purpose.

Click the eye icon in external system configuration page to get the access secret.

Please click OK button. And it will show the access secret instead of asterisks.

For security purpose it only allow user to see the access secret one time. When user next time log in the access secret is replaced by asterisks again and no eye icon beside it. If user want to get the access secret again he/she must click the RESET button to get the new access key and access secret.

Please keep the access key and access secret safely. Once the access key or access secret leaks please goto external system configuration page to disable external system access or reset the access key and access secret.

Please refer to https://www.nuget.org/packages/Paxstore.OpenApi/

Log into Admin Center of demo marketplace using marketplace admin account. Enable the 3rd system access for current marketplace and get key and secret.

Base URL of API: https://api.whatspos.com/p-market-api

using Paxstore.OpenApi;
using Paxstore.OpenApi.Model;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
namespace Paxstore.Test.ApiTest
{
    class Sample
    {
        string BASEURL = "https://api.whatspos.cn/p-market-api/";
        string KEY = "YOUR KEY";
        string SECRET = "YOUR SECRET";
        public Result<PagedReseller> GetResellers()
        {
            ResellerApi resellerApi = new ResellerApi(BASEURL, KEY, SECRET);
            Result<PagedReseller> resellerList = resellerApi.SearchReseller(1, 10, ResellerSearchOrderBy.Name, "reseller", ResellerStatus.Active);
            return resellerList;
        }
    }
}

See the Apache 2.0 license file for details.

Copyright 2018 PAX Computer Technology(Shenzhen) CO., LTD ("PAX")

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at following link.

     http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.