Introduction
PayMart is a simple, fast and reliable payment engine with open architecture. Founded back in 2018 now it is supported and constantly developing by the community of software engineers with bold background in payment and e-wallet systems.
PayMart Business API - a solution specifically designed for internet businesses in need of multicurrency payment processing. We support all major currencies.
Environments
There are two environments available for integration:
- Production environment: https://business.pay-mart.com
Sandbox Environment
Sandbox provides full functionality but it only emulates processing, no actual bank transactions are made. You can use the following PAN for tests:
- 4617611794313933: CONFIRMED as 3-D Secure transaction
- 4626233193837898: DECLINED as 3-D Secure transaction
- 4392963203551251: CONFIRMED as non 3-D Secure transaction
- 4730198364688516: DECLINED as non 3-D Secure transaction
- 4627342642639018: APPROVED PAYOUT
- 4968357931420422: DECLINED PAYOUT
You can use any cardholder name, expiry date and CVV2/CVC2 with these PANs. 3-D Secure is also emulated with a page that doesn’t require any password but only shows you 2 buttons. One button is for successful authentication, another is for failed authentication. Note, that when you chose to fail authentication, order is always declined, no matter what PAN was used.
Production Environment
Once you complete integration with Sandbox environment you will be provided with Production credentials. These are completely different credentials, not related with the ones on Sandbox. Production always makes real bank transactions, cards from Sandbox are not supported on this environment.
Authentication
curl https://business.pay-mart.com/v1/charges \
-H "Authorization: Bearer merchant_private_key"
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_HTTPHEADER => array(
"authorization: Bearer merchant_private_key",
),
));
import http.client
conn = http.client.HTTPSConnection("...")
headers = {
'authorization': "Bearer merchant_private_key",
}
OkHttpClient client = new OkHttpClient();
Request request = new Request.Builder()
.url("https://business.pay-mart.com/api/v1/payouts")
...
.addHeader("content-type", "application/json")
.addHeader("authorization", "Bearer merchant_private_key")
.build();
Response response = client.newCall(request).execute();
Authenticate your account when using the API, by including your secret API key which has been sent via email during registration. Management of your API keys can be done within the Backoffice. Your API keys carry importance and privileges, be sure to store them securely. Please do not share your secret API keys in publicly accessible areas such GitHub and client-side code areas.
Authentication to the API is performed via bearer auth keys (for cross-origin requests), use -H “Authorization: Bearer merchant_private_key”.
All API requests must be made through HTTPS. Calls made through plain HTTP will fail. API requests without authentication will also fail.
Payments
PayMart payment processing REST API.
Create
Code: Copy
curl "https://business.pay-mart.com/api/v1/payments" \
-X POST \
-H "Authorization: Bearer merchant_private_key" \
-H "Content-Type: application/json" -d '{
"product" : "Your Product",
"amount" : "1000",
"currency" : "CNY",
"redirectSuccessUrl" : "https://your-site.com/success",
"redirectFailUrl" : "https://your-site.com/fail",
"extraReturnParam" : "your order id or other info",
"orderNumber" : "your order number",
"locale": "zh"
}'
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://business.pay-mart.com/api/v1/payments",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => "{ \"product\" : \"Your Product\", \"amount\" : "10000", \"currency\" : \"CNY\", \"redirectSuccessUrl\" : \"https://your-site.com/success\", \"redirectFailUrl\" : \"https://your-site.com/fail\", \"extraReturnParam\" : \"your order id or other info\", \"orderNumber\" : \"your order number\", \"locale\" : \"zh\"\n}",
CURLOPT_HTTPHEADER => array(
"authorization: Bearer merchant_private_key",
"content-type: application/json"
),
));
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
from django.http import HttpResponseRedirect, HttpResponse
import requests
import json
def pay(request) :
MERCHANT_PRIVATE_KEY = 'merchant_private_key'
LIVE_URL = 'https://business.pay-mart.com';
SANDBOX_URL = 'https://business.pay-mart.com'
payload = {
"product" : request.POST['product_name'],
"amount" : request.POST['order_amount'],
"currency" : "CNY",
"redirectSuccessUrl": request.POST['notify_url'],
"redirectFailUrl" : request.POST['return_url'],
"extraReturnParam" : request.POST['order_no'],
"orderNumber" : request.POST['order_number'],
"locale" : request.POST['locale']
}
headers = {
'Content-Type': 'application/json',
'Authorization': 'Bearer %s' % (MERCHANT_PRIVATE_KEY)
}
resp = requests.post('%s/api/v1/payments' % (SANDBOX_URL), json=payload, headers=headers)
if resp.status_code == 200:
resp_payload = json.loads(resp.text)
return HttpResponseRedirect(resp_payload['processingUrl'])
else:
return HttpResponse('<html><body><span>Something gone wrong: %s</span></body></html>' % (resp.status_code))
MediaType JSON = MediaType.parse("application/json; charset=utf-8");
HashMap<String, Object> params = new HashMap<String, Object>();
params.put("product", "PayMart Example Payment");
params.put("amount", "1000");
params.put("currency", "EUR");
params.put("redirectSuccessUrl", "[sucess redirect url]");
params.put("redirectFailUrl", "[fail redirect url]");
params.put("orderNumber", "[merchat system order number]");
params.put("extraReturnParam", "[some additional params]");
params.put("locale", "[user locale]");
OkHttpClient client = new OkHttpClient();
Request request = new Request.Builder()
.url("https://business.pay-mart.com/api/v1/payments")
.post(RequestBody.create(JSON, new Gson().toJson(params)))
.addHeader("content-type", "application/json")
.addHeader("authorization", "Bearer merchant_private_key")
.build();
Call call = client.newCall(request);
call.enqueue(new Callback() {
@Override
public void onFailure(Call call, IOException e) {
Log.e("response ", "onFailure(): " + e.getMessage() );
}
@Override
public void onResponse(Call call, Response response) throws IOException {
String resp = response.body().string();
Log.e("response ", "onResponse(): " + resp );
}
});
Return status 200 and JSON: Copy
{
"success": true | false,
"errors": [],
"token": "[payment token]",
"processingUrl": "https://business.pay-mart.com/p/[payment token]",
"payment": {
"amount": "10020",
"currency": "CNY",
"status": "init"
},
"redirectRequest": {
"url": "[redirect url, for example ACS URL for 3ds]",
"params": {
"PaReq": "[PaReq for current payment]",
"TermUrl": "https://business.pay-mart.com/checkout_results/[payment token]/callback_3ds"
},
"type": "post"
}
}
Initialize payments - to begin receiving payments, you must first call using the following script. This will enable you to obtain a payment token, which will be required later to complete API integration.
HTTP Request via SSL
POST '/api/v1/payments'
Query Parameters
Parameter | Mandatory | Description | Validation |
---|---|---|---|
product | yes | Product name (Service description) (example: 'iPhone'). | minLength: 5, maxLength: 255 |
amount | yes | Payment amount in cents (10020), except JPY | minLength: 1, maxLength: 32 |
currency | yes | Currency code (CNY, EUR, USD, JPY). | minLength: 3, maxLength: 3 |
callbackUrl | yes | The server URL a merchant will be notified about a payment finalisation | Valid URI format |
redirectSuccessUrl | no | The URL a customer will be redirected to in the case of successfull payment | Valid URI format |
redirectFailUrl | no | The URL a customer will be redirected to in the case of payment error or failure | Valid URI format |
extraReturnParam | no | Bank/Payment method list, description, etc | minLength: 1, maxLength: 1024 |
orderNumber | no | The current order number from a company system. | minLength: 3, maxLength: 255 (string) |
locale | no | The locale is used on a payment page by default. Currently supported locales: en, zh and jp from ISO 639-1. | minLength: 2, maxLength: 5 (string) |
walletToken | no | Set this parameter when making recurring payment from a customer’s wallet. A customer will receive notification and has to confirm the payment. | returns by API for recurring payments only |
recurring | no | Set this parameter to true when initializing recurring payment. | boolean |
recurringToken | no | Set this parameter when making recurring payment previously initialized with recurring param. | returns by API for recurring payments only |
needConfirmation | no | Set this parameter whe making payment in two steps (preAuth and confirm/decline) | |
card | no | Card object for Host2Host payments. | |
customer | no | Customer object for Host2Host payments. |
Card Object Parameters
Parameter | Mandatory | Description | Validation |
---|---|---|---|
pan | yes | Customer’s card number (PAN). Any valid card number, may contain spaces | Valid card number (16-19 digits) |
expires | yes | Customer’s card expiration date. Format: mm/yyyy | mm/yyyy format |
holder | yes | Customer’s cardholder name. Any valid cardholder name | minLength: 5, maxLength: 50 |
cvv | yes | Customer’s CVV2 / CVC2 / CAV2 | minLength: 3, maxLength: 3 Only digits (\d+) |
Customer Object Parameters (optional)
Parameter | Mandatory | Description | Validation |
---|---|---|---|
yes | Customer’s email, is mandatory if Customer object posted on a request | Valid email format | |
address | no | Customer's billing address | minLength: 5, maxLength: 55 |
country | no | Customer's billing country | ISO country code format "GB" |
city | no | Customer's billing city | minLength: 4, maxLength: 55 |
region | no | Customer's billing region | minLength: 5, maxLength: 55 |
postcode | no | Customer's billing ZipCode | minLength: 4, maxLength: 55 |
phone | no | Customer's billing phone number | minLength: 6, maxLength: 20 |
ip | no | Customer IP address | Valid IP address format (XX.XX.XX.XX) |
browser | no | Customer browser object for 3ds2 payments. |
Customer browser object for 3ds2 payments (optional)
Parameter | Mandatory | Description | Example |
---|---|---|---|
accept_header | no | Browser's content type | text/html |
color_depth | no | Browser's color depth value | 32 |
ip | no | Browser's ip | 177.255.255.35 |
language | no | Browser's language | ru |
screen_height | no | Browser's screen height | 1080 |
screen_width | no | Browser's screen width | 1920 |
tz | no | Browser's time zone | 180 |
user_agent | no | Browser's user agent | Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:96.0) Gecko/20100101 Firefox/96.0 |
java_enabled | no | Is java enabled | true |
javascript_enabled | no | Is javascript enabled | true |
window_width | no | Browser's window width | 1920 |
window_height | no | Browser's bilwindowling height | 1080 |
Payments Providers
Code: Copy
MediaType JSON = MediaType.parse("application/json; charset=utf-8");
HashMap<String, Object> params = new HashMap<String, Object>();
params.put("product", "PayMart Example Payment");
params.put("amount", "1000");
params.put("currency", "EUR");
params.put("redirectSuccessUrl", "[sucess redirect url]");
params.put("redirectFailUrl", "[fail redirect url]");
params.put("orderNumber", "[merchat system order number]");
params.put("extraReturnParam", "[some additional params]");
params.put("locale", "[user locale]");
OkHttpClient client = new OkHttpClient();
Request request = new Request.Builder()
.url("https://business.pay-mart.com/api/v1/payments")
.post(RequestBody.create(JSON, new Gson().toJson(params)))
.addHeader("content-type", "application/json")
.addHeader("authorization", "Bearer merchant_private_key")
.build();
Call call = client.newCall(request);
call.enqueue(new Callback() {
@Override
public void onFailure(Call call, IOException e) {
Log.e("response ", "onFailure(): " + e.getMessage() );
}
@Override
public void onResponse(Call call, Response response) throws IOException {
String resp = response.body().string();
Log.e("response ", "onResponse(): " + resp );
}
});
Return status 200 and JSON: Copy
{
"success": true | false,
"errors": [],
"token": "[payment token]",
"processingUrl": [
{
"webmoney": "http://business.pay-mart.com/p/165998589a413b56ae72fbfdc15b016b/webmoney?locale=en"
},
{
"bank_card": "http://business.pay-mart.com/p/165998589a413b56ae72fbfdc15b016b/bank_card?locale=en"
},
{
"qiwi_wallet": "http://business.pay-mart.com/p/165998589a413b56ae72fbfdc15b016b/qiwi_wallet?locale=en"
},
{
"skrill_wallet": "http://business.pay-mart.com/p/165998589a413b56ae72fbfdc15b016b/skrill_wallet?locale=en"
}
],
"selectorURL": "https://business.pay-mart.com/select/[payment token]/",
"payment": {
"amount": "10020",
"currency": "CNY",
"status": "init"
},
"redirectRequest": {
"url": "[redirect url, for example ACS URL for 3ds]",
"params": {
"PaReq": "[PaReq for current payment]",
"TermUrl": "https://business.pay-mart.com/checkout_results/[payment token]/callback_3ds"
},
"type": "post"
}
}
In case multiple payment providers enabled to a merchant account, Create payment reponse JSON will have processingUrl object represented as an array of available payment providers (please refer to JSON response). Use those URLs to redirect your customer to a payment provider (method).
List of payment providers
In case you want a customer to choose a payment provider (method) it might be convenient to use a specific page (widget) with payment provider list, which is availabe by "selectorURL" parameter in JSON response object
List
Code: Copy
curl "https://business.pay-mart.com/api/v1/payments?dateFrom=2016-05-11&page=1&perPage=1" \
-H "Authorization: Bearer merchant_private_key"
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://business.pay-mart.com/api/v1/payments?dateFrom=2016-05-11&page=1&perPage=1",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => array(
"authorization: Bearer merchant_private_key"
),
));
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
OkHttpClient client = new OkHttpClient();
Request request = new Request.Builder()
.url("https://business.pay-mart.com/api/v1/payments")
.get()
.addHeader("authorization", "Bearer merchant_private_key")
.build();
Response response = client.newCall(request).execute();
Return status 200 and JSON: Copy
{
"success": true | false,
"errors": [],
"status": 200,
"totalCount": 10,
"curentPage": 1,
"perPage": 1,
"totalPage": 10,
"payments": [
{
"id": 1,
"status": "sent",
"token": "[payment token]",
"currency": "CNY",
"product": "Your Product",
"redirect_success_url": "https://your-site.com/success",
"redirect_fail_url": "https://your-site.com/fail",
"amount": 10000,
"created_at": "2016-06-27T14:13:00.273Z",
"updated_at": "2016-06-27T14:15:44.715Z",
"extra_return_param": "your order id or other info",
"operation_type": "pay",
"order_number": 1
}
]
}
Payments List - this is the method used to display the list of returned payments.
HTTP Request via SSL
GET '/api/v1/payments'
Query Parameters
Parameter | Description | Required |
---|---|---|
dateFrom | Date from (example: '2015-01-01') | No |
dateTo | Date to (example: '2015-01-02') | No |
page | Page number (default: 1) | No |
perPage | Payment per page (max: 500, default: 20) | No |
operationType | Operation type (Available values: pays, payouts, all) | No |
orderNumber | Merchant's order number | No |
Get
Code: Copy
curl "https://business.pay-mart.com/api/v1/payments/[payment_token]" \
-H "Authorization: Bearer merchant_private_key"
Return status 200 and JSON: Copy
{
"success": true | false,
"errors": [],
"status": 200,
"payment": {
"id": 2599,
"status": "pending | approved | declined",
"token": "[payment token]",
"currency": "[payment currency]",
"product": "[product description]",
"callback_url": "[callback/notification url]",
"redirect_success_url": "success redirection url",
"redirect_fail_url": "fail redirection url",
"amount": 0,
"created_at": "[creation date]",
"updated_at": "[last status update date]",
"extra_return_param": "[extra params, can be use to payment identification in merchat system]",
"operation_type": "pay | payout",
"order_number": "[merchant's order number]"
}
}
Payment Get - this is the method used to retrieve information about single payment.
HTTP Request via SSL
GET '/api/v1/payments/[payment_token]'
Confirm Two-Step
Code: Copy
curl "https://business.pay-mart.com/api/v1/payments/confirm" \
-X POST \
-H "Authorization: Bearer merchant_private_key" \
-H "Content-Type: application/json" -d '{
"token" : "Your Product"
}'
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://business.pay-mart.com/api/v1/payments/confirm",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => "{ \"token\" : \"payment token\""\n}",
CURLOPT_HTTPHEADER => array(
"authorization: Bearer merchant_private_key",
"content-type: application/json"
),
));
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
from django.http import HttpResponseRedirect, HttpResponse
import requests
import json
def pay(request) :
MERCHANT_PRIVATE_KEY = 'merchant_private_key'
LIVE_URL = 'https://business.pay-mart.com';
SANDBOX_URL = 'https://business.pay-mart.com'
payload = {
"token" : request.POST['token payment']
}
headers = {
'Content-Type': 'application/json',
'Authorization': 'Bearer %s' % (MERCHANT_PRIVATE_KEY)
}
resp = requests.post('%s/api/v1/payments/confirm' % (SANDBOX_URL), json=payload, headers=headers)
if resp.status_code == 200:
resp_payload = json.loads(resp.text)
return HttpResponseRedirect(resp_payload['processingUrl'])
else:
return HttpResponse('<html><body><span>Something gone wrong: %s</span></body></html>' % (resp.status_code))
MediaType JSON = MediaType.parse("application/json; charset=utf-8");
HashMap<String, Object> params = new HashMap<String, Object>();
params.put("token", "payment token");
OkHttpClient client = new OkHttpClient();
Request request = new Request.Builder()
.url("https://business.pay-mart.com/api/v1/payments/confirm")
.post(RequestBody.create(JSON, new Gson().toJson(params)))
.addHeader("content-type", "application/json")
.addHeader("authorization", "Bearer merchant_private_key")
.build();
Call call = client.newCall(request);
call.enqueue(new Callback() {
@Override
public void onFailure(Call call, IOException e) {
Log.e("response ", "onFailure(): " + e.getMessage() );
}
@Override
public void onResponse(Call call, Response response) throws IOException {
String resp = response.body().string();
Log.e("response ", "onResponse(): " + resp );
}
});
Return status 200 and JSON: Copy
{
"success": true | false,
"result": 0,
"status": 200,
"payment": {
"amount": 100,
"gateway_amount": 100,
"currency": "USD",
"status": "approved|declined",
"two_stage_mode": true
}
}
Confirm Two-Step payment by providing a payment token.
HTTP Request via SSL
POST '/api/v1/payments/confirm'
Query Parameters
Parameter | Mandatory | Description |
---|---|---|
token | yes | Payment token. |
Decline Two-Step
Code: Copy
curl "https://business.pay-mart.com/api/v1/payments/decline" \
-X POST \
-H "Authorization: Bearer merchant_private_key" \
-H "Content-Type: application/json" -d '{
"token" : "Your Product"
}'
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://business.pay-mart.com/api/v1/payments/decline",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => "{ \"token\" : \"payment token\""\n}",
CURLOPT_HTTPHEADER => array(
"authorization: Bearer merchant_private_key",
"content-type: application/json"
),
));
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
from django.http import HttpResponseRedirect, HttpResponse
import requests
import json
def pay(request) :
MERCHANT_PRIVATE_KEY = 'merchant_private_key'
LIVE_URL = 'https://business.pay-mart.com';
SANDBOX_URL = 'https://business.pay-mart.com'
payload = {
"token" : request.POST['token payment']
}
headers = {
'Content-Type': 'application/json',
'Authorization': 'Bearer %s' % (MERCHANT_PRIVATE_KEY)
}
resp = requests.post('%s/api/v1/payments/decline' % (SANDBOX_URL), json=payload, headers=headers)
if resp.status_code == 200:
resp_payload = json.loads(resp.text)
return HttpResponseRedirect(resp_payload['processingUrl'])
else:
return HttpResponse('<html><body><span>Something gone wrong: %s</span></body></html>' % (resp.status_code))
MediaType JSON = MediaType.parse("application/json; charset=utf-8");
HashMap<String, Object> params = new HashMap<String, Object>();
params.put("token", "payment token");
OkHttpClient client = new OkHttpClient();
Request request = new Request.Builder()
.url("https://business.pay-mart.com/api/v1/payments/decline")
.post(RequestBody.create(JSON, new Gson().toJson(params)))
.addHeader("content-type", "application/json")
.addHeader("authorization", "Bearer merchant_private_key")
.build();
Call call = client.newCall(request);
call.enqueue(new Callback() {
@Override
public void onFailure(Call call, IOException e) {
Log.e("response ", "onFailure(): " + e.getMessage() );
}
@Override
public void onResponse(Call call, Response response) throws IOException {
String resp = response.body().string();
Log.e("response ", "onResponse(): " + resp );
}
});
Return status 200 and JSON: Copy
{
"success": true | false,
"result": 0,
"status": 200,
"payment": {
"amount": 100,
"gateway_amount": 100,
"currency": "USD",
"status": "approved|declined",
"two_stage_mode": true
}
}
Decline Two-Step payment by providing a payment token.
HTTP Request via SSL
POST '/api/v1/payments/decline'
Query Parameters
Parameter | Mandatory | Description |
---|---|---|
token | yes | Payment token. |
Get/Order
Code: Copy
curl "https://business.pay-mart.com/api/v1/payments/order/[order_number]" \
-H "Authorization: Bearer merchant_private_key"
Return status 200 and JSON: Copy
{
"success": true | false,
"result": 0,
"status": 200,
"totalCount": 1,
"curentPage": 1,
"perPage": 100,
"totalPage": 1,
"payments": [
{
"id": 123,
"status": "pending | approved | declined | expired",
"token": "[payment token]",
"currency": "[payment currency]",
"product": "[payment currency]",
"callback_url": "[callback/notification url]",
"redirect_success_url": "success redirection url",
"redirect_fail_url": "fail redirection url",
"amount": 100,
"created_at": "[creation date]",
"updated_at": "[last status update date]",
"extra_return_param": "[extra params, can be use to payment identification in merchant system]",
"operation_type": "pay | payout",
"order_number": "[merchant's order number]"
}
]
}
Payment Get/Order - this is the method used to retrieve information about payments by order_number.
HTTP Request via SSL
GET '/api/v1/payments/order/[order_number]'
Refunds
PayMart refunds processing REST API.
Create refund
Code: Copy
curl "https://business.pay-mart.com/api/v1/refunds" \
-X POST \
-H "Authorization: Bearer merchant_private_key" \
-H "Content-Type: application/json" -d '{
"token" : "Your Product",
"amount": 1000
}'
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://business.pay-mart.com/api/v1/payments",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => "{ \"token\" : \"payment token\""\n}",
CURLOPT_HTTPHEADER => array(
"authorization: Bearer merchant_private_key",
"content-type: application/json"
),
));
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
from django.http import HttpResponseRedirect, HttpResponse
import requests
import json
def pay(request) :
MERCHANT_PRIVATE_KEY = 'merchant_private_key'
LIVE_URL = 'https://business.pay-mart.com';
SANDBOX_URL = 'https://business.pay-mart.com'
payload = {
"token" : request.POST['token payment'],
"amount": 100
}
headers = {
'Content-Type': 'application/json',
'Authorization': 'Bearer %s' % (MERCHANT_PRIVATE_KEY)
}
resp = requests.post('%s/api/v1/refunds' % (SANDBOX_URL), json=payload, headers=headers)
if resp.status_code == 200:
resp_payload = json.loads(resp.text)
return HttpResponseRedirect(resp_payload['processingUrl'])
else:
return HttpResponse('<html><body><span>Something gone wrong: %s</span></body></html>' % (resp.status_code))
MediaType JSON = MediaType.parse("application/json; charset=utf-8");
HashMap<String, Object> params = new HashMap<String, Object>();
params.put("token", "payment token");
params.put("amount", 100);
OkHttpClient client = new OkHttpClient();
Request request = new Request.Builder()
.url("https://business.pay-mart.com/api/v1/refunds")
.post(RequestBody.create(JSON, new Gson().toJson(params)))
.addHeader("content-type", "application/json")
.addHeader("authorization", "Bearer merchant_private_key")
.build();
Call call = client.newCall(request);
call.enqueue(new Callback() {
@Override
public void onFailure(Call call, IOException e) {
Log.e("response ", "onFailure(): " + e.getMessage() );
}
@Override
public void onResponse(Call call, Response response) throws IOException {
String resp = response.body().string();
Log.e("response ", "onResponse(): " + resp );
}
});
Return status 200 and JSON: Copy
{
"success": true | false,
"errors": [],
"token": "[payment token]",
"processingUrl": "https://business.pay-mart.com/p/[payment token]",
"refund": {
"token": "3a1a4fc8f975eb022a1c0ddb3abcded9",
"amount": "10020",
"currency": "USD",
"status": "approved|declined"
}
}
Create refunds by providing a payment token.
HTTP Request via SSL
POST '/api/v1/refunds'
Query Parameters
Parameter | Mandatory | Description |
---|---|---|
token | yes | Payment token. |
amount | no | Refund amount in cents. |
Payouts
Transferring money from a business account to a client account.
Make a payout
Code: Copy
curl "https://business.pay-mart.com/api/v1/payouts" \
-X POST \
-H "Authorization: Bearer merchant_private_key" \
-H "Content-Type: application/json" -d '{
"amount" : 1000,
"currency" : "CNY",
"orderNumber": "10001",
"extraReturnParam" : "test payout",
"card": {
"pan" : "4276111152393643",
"expires" : "08/2022"
},
"customer": {
"name" : "Mike",
"surname" : "Green",
"email" : "test@pay-mart.com",
"address" : "725 5th Ave, New York, NY 10022, United States",
"ip" : "1.1.1.1"
}
}'
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://business.pay-mart.com/api/v1/payouts",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => "{ \"amount\" : 1000, \"currency\" : \"CNY\", \"orderNumber\" : \"10001\", \"extraReturnParam\" : \"test payout\", \"card\": { \"pan\" : \"4276111152393643\", \"expires\" : \"08/2022\" }, \"customer\": { \"email\" : \"test@pay-mart.com\", \"address\" : \"test test\", \"ip\" : \"1.1.1.1\"}"\n}",
CURLOPT_HTTPHEADER => array(
"authorization: Bearer edf526c5374796cdcec5dce731405cee",
"content-type: application/json"
),
));
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
from django.shortcuts import render
from django.http import HttpResponseRedirect, HttpResponse, HttpResponseNotFound
from django.views.decorators.csrf import csrf_exempt
import requests
import json
def payout(request) :
MERCHANT_PRIVATE_KEY = 'your-merchant-private-key'
LIVE_URL = 'https://business.pay-mart.com';
SANDBOX_URL = 'https://business.pay-mart.com'
payload = {
"amount" : 10000,
"currency" : "EUR",
"orderNumber": "10001",
"card": {
"pan" : "4276111152393643",
"expires" : "08/2022"
},
"customer": {
"email" : "test@pay-mart.com",
"address" : "test test",
"ip" : "1.1.1.1"
}
}
headers = {
'Content-Type': 'application/json',
'Authorization': 'Bearer %s' % (MERCHANT_PRIVATE_KEY)
}
resp = requests.post('%s/api/v1/payouts' % (SANDBOX_URL), json=payload, headers=headers)
if resp.status_code == 200:
resp_o = json.loads(resp.text)
return HttpResponseRedirect(resp_o['status'])
else:
return HttpResponse('<html><body><span>Something gone wrong: %s</span> : %s</body></html>' % (resp.status_code, resp.text))
MediaType JSON = MediaType.parse("application/json; charset=utf-8");
HashMap<String, Object> params = new HashMap<String, Object>();
params.put("amount", 1000);
params.put("currency", "EUR");
params.put("orderNumber", "[merchat system order number]");
OkHttpClient client = new OkHttpClient();
Request request = new Request.Builder()
.url("https://business.pay-mart.com/api/v1/payouts")
.post(RequestBody.create(JSON, new Gson().toJson(params)))
.addHeader("content-type", "application/json")
.addHeader("authorization", "Bearer merchant_private_key")
.build();
Call call = client.newCall(request);
call.enqueue(new Callback() {
@Override
public void onFailure(Call call, IOException e) {
Log.e("response ", "onFailure(): " + e.getMessage() );
}
@Override
public void onResponse(Call call, Response response) throws IOException {
String resp = response.body().string();
Log.e("response ", "onResponse(): " + resp );
}
});
Return status 200 and JSON: Copy
{
"success": true | false,
"errors": [],
"payout": {
"token": "[payment token]",
"status": "[payment status]",
"timestamp": "2016-06-09T03:46:45Z"
}
}
Create a payout operation.
HTTP Request via SSL
POST '/api/v1/payouts'
Query Parameters
Parameter | Mandatory | Description |
---|---|---|
amount | yes | Payment amount in minimal values as of; USD and EUR / Cents, for JPY / Yen, for CNY / Fen. |
currency | yes | Currency code (CNY, EUR, USD, JPY) |
orderNumber | yes | PayMart's client inner order number |
card | yes | Card object for Host2Host payouts. |
customer | yes | Customer object for Host2Host payouts. |
Card Payout Object Parameters
Parameter | Mandatory | Description |
---|---|---|
pan | yes | Customer’s card number (PAN). Any valid card number, may contain spaces |
expires | yes | Customer’s card expiration date. Format: mm/yyyy |
Customer Object Parameters (optional)
Parameter | Mandatory | Description |
---|---|---|
yes | Customer’s email, is mandatory if Customer object posted on a request | |
address | no | Customer's billing address in the full format like "725 5th Ave, New York, NY 10022, United States" |
ip | yes | Customer IP address |
name | no | Customer name |
surname | no | Customer surname |
Providers
Code: Copy
curl "https://business.pay-mart.com/api/v1/payouts" \
-X POST \
-H "Authorization: Bearer merchant_private_key" \
-H "Content-Type: application/json" -d '{
"amount" : 1000,
"currency" : "CNY",
"orderNumber": "10001",
"extraReturnParam" : "test payout",
"card": {
"pan" : "4276111152393643",
"expires" : "08/2022"
},
"customer": {
"email" : "test@pay-mart.com",
"address" : "test test",
"ip" : "1.1.1.1"
}
}'
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://business.pay-mart.com/api/v1/payouts",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => "{ \"amount\" : 1000, \"currency\" : \"CNY\", \"orderNumber\" : \"10001\", \"extraReturnParam\" : \"test payout\", \"card\": { \"pan\" : \"4276111152393643\", \"expires\" : \"08/2022\" }, \"customer\": { \"email\" : \"test@pay-mart.com\", \"address\" : \"test test\", \"ip\" : \"1.1.1.1\"}"\n}",
CURLOPT_HTTPHEADER => array(
"authorization: Bearer edf526c5374796cdcec5dce731405cee",
"content-type: application/json"
),
));
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
from django.shortcuts import render
from django.http import HttpResponseRedirect, HttpResponse, HttpResponseNotFound
from django.views.decorators.csrf import csrf_exempt
import requests
import json
def payout(request) :
MERCHANT_PRIVATE_KEY = 'your-merchant-private-key'
LIVE_URL = 'https://business.pay-mart.com';
SANDBOX_URL = 'https://business.pay-mart.com'
payload = {
"amount" : 10000,
"currency" : "EUR",
"orderNumber": "10001",
"card": {
"pan" : "4276111152393643",
"expires" : "08/2022"
},
"customer": {
"email" : "test@pay-mart.com",
"address" : "test test",
"ip" : "1.1.1.1"
}
}
headers = {
'Content-Type': 'application/json',
'Authorization': 'Bearer %s' % (MERCHANT_PRIVATE_KEY)
}
resp = requests.post('%s/api/v1/payouts' % (SANDBOX_URL), json=payload, headers=headers)
if resp.status_code == 200:
resp_o = json.loads(resp.text)
return HttpResponseRedirect(resp_o['status'])
else:
return HttpResponse('<html><body><span>Something gone wrong: %s</span> : %s</body></html>' % (resp.status_code, resp.text))
MediaType JSON = MediaType.parse("application/json; charset=utf-8");
HashMap<String, Object> params = new HashMap<String, Object>();
params.put("amount", 1000);
params.put("currency", "EUR");
params.put("orderNumber", "[merchat system order number]");
OkHttpClient client = new OkHttpClient();
Request request = new Request.Builder()
.url("https://business.pay-mart.com/api/v1/payouts")
.post(RequestBody.create(JSON, new Gson().toJson(params)))
.addHeader("content-type", "application/json")
.addHeader("authorization", "Bearer merchant_private_key")
.build();
Call call = client.newCall(request);
call.enqueue(new Callback() {
@Override
public void onFailure(Call call, IOException e) {
Log.e("response ", "onFailure(): " + e.getMessage() );
}
@Override
public void onResponse(Call call, Response response) throws IOException {
String resp = response.body().string();
Log.e("response ", "onResponse(): " + resp );
}
});
Return status 200 and JSON: Copy
{
"success": true | false,
"errors": [],
"token": "[payment token]",
"processingUrl": [
{
"webmoney": "http://business.pay-mart.com/pout/165998589a413b56ae72fbfdc15b016b/webmoney?locale=en"
},
{
"bank_card": "http://business.pay-mart.com/pout/165998589a413b56ae72fbfdc15b016b/bank_card?locale=en"
},
{
"qiwi_wallet": "http://business.pay-mart.com/pout/165998589a413b56ae72fbfdc15b016b/qiwi_wallet?locale=en"
},
{
"skrill_wallet": "http://business.pay-mart.com/pout/165998589a413b56ae72fbfdc15b016b/skrill_wallet?locale=en"
}
],
"selectorURL": "https://business.pay-mart.com/select/pout/[payment token]/",
"payment": {
"amount": "10020",
"currency": "CNY",
"status": "init"
}
}
In case multiple payout providers enabled to a merchant account, Create payout reponse JSON will have processingUrl object represented as an array of available payout providers (please refer to JSON response). Use those URLs to redirect your customer to a payout provider (method).
List of payout providers
In case you want a customer to choose a payout provider (method) it might be convenient to use a specific page (widget) with payout provider list, which is availabe by "selectorURL" parameter in JSON response object
Balance
Request current PayMart balance.
Receive Balance
Code: Copy
curl "https://business.pay-mart.com/api/v1/balance?currency=CNY" \
-X GET \
-H "Authorization: Bearer merchant_private_key" \
-H "Content-Type: application/json"
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://business.pay-mart.com/api/v1/balance?currency=CNY",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => array(
"authorization: Bearer merchant_private_key",
"content-type: application/json"
),
));
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
from django.shortcuts import render
from django.http import HttpResponseRedirect, HttpResponse, HttpResponseNotFound
from django.views.decorators.csrf import csrf_exempt
import requests
import json
def balance(request) :
MERCHANT_PRIVATE_KEY = 'merchant_private_key'
LIVE_URL = 'https://business.pay-mart.com';
SANDBOX_URL = 'https://business.pay-mart.com'
headers = {
'Content-Type': 'application/json',
'Authorization': 'Bearer %s' % (MERCHANT_PRIVATE_KEY)
}
resp = requests.get('%s/api/v1/balance' % (SANDBOX_URL), params = {'currency':'CNY'}, headers=headers)
if resp.success:
resp_o = json.loads(resp.text)
return HttpResponse('<html><body><span>Your balance %s</body></html>' % (resp_o['wallet']['available']))
else:
return HttpResponse('<html><body><span>Something gone wrong: %s</span> : %s</body></html>' % (resp.status_code, resp.text))
OkHttpClient client = new OkHttpClient();
Request request = new Request.Builder()
.url("https://business.pay-mart.com/api/v1/balance?currency=CNY")
.get()
.addHeader("content-type", "application/json")
.addHeader("authorization", "Bearer merchant_private_key")
.build();
Response response = client.newCall(request).execute();
Return status 200 and JSON: Copy
{
"success": true | false,
"errors": [],
"wallet": {
"available": 0,
"hold": 0,
"currency": "CNY"
}
}
Receiving the balance for a business account. Balance is returned as an object displaying available and pending amounts. Balances shown may be not be released and/or processed.
HTTP Request via SSL
GET '/api/v1/balance'
Query Parameters
Parameter | Description |
---|---|
currency | Currency code (CNY) |
Disputes
Request current PayMart dispute list.
Dispute list
Code: Copy
curl "https://business.pay-mart.com/api/v1/disputes/list" \
-X GET \
-H "Authorization: Bearer merchant_private_key" \
-H "Content-Type: application/json"
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => "https://business.pay-mart.com/api/v1/disputes/list",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => array(
"authorization: Bearer merchant_private_key",
"content-type: application/json"
),
));
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
from django.shortcuts import render
from django.http import HttpResponseRedirect, HttpResponse, HttpResponseNotFound
from django.views.decorators.csrf import csrf_exempt
import requests
import json
def disputes(request) :
MERCHANT_PRIVATE_KEY = 'merchant_private_key'
LIVE_URL = 'https://business.pay-mart.com';
SANDBOX_URL = 'https://business.pay-mart.com'
headers = {
'Content-Type': 'application/json',
'Authorization': 'Bearer %s' % (MERCHANT_PRIVATE_KEY)
}
resp = requests.get('%s/api/v1/disputes/list' % (SANDBOX_URL), headers=headers)
OkHttpClient client = new OkHttpClient();
Request request = new Request.Builder()
.url("https://business.pay-mart.com/api/v1/disputes/list")
.get()
.addHeader("content-type", "application/json")
.addHeader("authorization", "Bearer merchant_private_key")
.build();
Response response = client.newCall(request).execute();
Return status 200 and JSON: Copy
{
"success": true,
"status": 200,
"disputes": [
{
"id": 27,
"amount": 2,
"currency": "USD",
"investigation_report": null,
"status": "processing",
"merchant_profile_id": 3,
"user_profile_id": 3,
"feed_id": 330,
"created_at": "2019-09-13T08:46:21.302Z",
"updated_at": "2019-09-13T08:46:21.343Z",
"dispute_type": 2,
"reason_code": "123",
"comment": "some comment"
}
]
}
Getting a list of last disputes for a business account.
HTTP Request via SSL
GET '/api/v1/disputes/list'
Query Parameters
No parameters, returns 100 latest records
Notifications
Notifications with the payment or payout status are sent to your callback URL using POST methods. In case payment or payout status changed (pending/approved/declined) -- notification type is sent accordingly.
Code: Copy
from django.views.decorators.csrf import csrf_exempt
from django.http import HttpResponseRedirect, HttpResponse, HttpResponseNotFound
@csrf_exempt
def notifyme(request) :
req_o = json.loads(request.read());
return HttpResponse('Status is:%s' % (req_o['status']))
Params: Copy
{
"token": "payment token",
"type": "payment type: payment | payout",
"status" : "payment status: pending | approved | declined ",
"extraReturnParam" : "extra params",
"orderNumber" : "merchant order number",
"walletToken": "payer's PayMart wallet unique identifier, only for paymart payments",
"recurringToken": "payer's previously initialized recurring token, for making recurrent payment repeatedly",
"sanitizedMask": "payer's sanitized card, if it was provided",
"amount": "payment amount in cents",
"currency": "payment currency",
"gatewayAmount": "exchanged amount in cents",
"gatewayCurrency": "exchanged currency"
}
Dictionaries
Errors
If any method failed, the JSON response with status code 403 returned that specified the problem.
Return status 403 and JSON: Copy
{'success': false, 'result': 1, 'status': 403, 'errors': {'list': [{'code': 'merchant_not_found', 'kind': 'api_error'}]}}
{'success': false, 'result': 1, 'status': 403, 'errors': [{'code': 'amount_less_than_minimum', 'kind': 'invalid_request_error'}]}
{'success': false, 'result': 1, 'status': 403, 'errors': [{'code': 'amount_less_than_balance', 'kind': 'processing_error'}]}
Payment states
State | Final | Description |
---|---|---|
init | no | Request to API will initiate payments. |
pending | no | User redirected to the PayMart Checkout facility during payment processing period. |
approved | yes | Successfully completed payment. |
declined | yes | Unsuccessful payment. |
Kinds of errors
Kind | Description |
---|---|
api_error | Indicate rare occasions such as an PayMart API server technicality. |
authentication_error | Authentication request failure. |
invalid_request_error | Invalid parameters which produce invalid requests. |
processing_error | Processing the payment generated an error. |
Codes of errors
Code | Description |
---|---|
incorrect_private_key | The current private key cannot identify the user. |
incorrect_address_info | Absent or incorrect address information. |
incorrect_bank_card_info | Absent or incorrect bank card information. |
order_number_already_exists | Repeating an order of already identified order number. |
amount_less_than_balance | Payout cannot be completed due to insufficient funds. |
incorrect_amount | Absent or incorrect amount value. |
incorrect_currency | Absent or incorrect currency value. |
incorrect_order_number | Absent or incorrect order value. |
amount_less_than_minimum | Minimum payout amount has not been requested. |
Supported Chinese bank codes
Code | Name |
---|---|
"ABC" | "Agricultural Bank of China" |
"ICBC" | "Industrial and Commercial Bank of China" |
"CCB" | "China Construction Bank" |
"BCOM" | "Bank of Communication" |
"BOC" | "Bank of China" |
"CMB" | "China Merchants Bank" |
"CMBC" | "China Minsheng Bank" |
"CEBB" | "China Ever Bright Bank" |
"BOB" | "Bank of Beijing" |
"SHB" | "Bank of Shanghai" |
"NBB" | "Bank of Ningbo" |
"HXB" | "Hua Xia Bank" |
"CIB" | "China Industrial Bank" |
"PSBC" | "Postal Saving Bank of China" |
"SPABANK" | "Shenzhen Ping An Bank" |
"SPDB" | "Shanghai Pudong Development Bank" |
"BEA" | "Bank of East Asia" |
"ECITIC" | "China Citic Bank" |
"GDB" | "Guangdong Development Bank" |
Supported Chinese state codes
State (Province) code | State (Province) name |
---|---|
11 | Beijing City |
12 | Tianjin City |
13 | Hebei Province |
14 | Shanxi Province |
15 | Inner Mogolia |
21 | Liaoning Province |
22 | Jilin Province |
23 | Heilongjiang Province |
31 | Shanghai City |
32 | Jiangsu Province |
33 | Zhejiang Province |
34 | Anhui Province |
35 | Fujian Province |
36 | Jiangxi Province |
37 | Shandong Province |
41 | Henan Province |
42 | Hubei Province |
43 | Hunan Province |
44 | Guangdong Province |
45 | Guangxi Province |
46 | Hainan Province |
50 | Chongqing City |
51 | Sichuan Province |
52 | Guizhou Province |
53 | Yunnan Province |
54 | Tibet |
61 | Shaanxi Province |
62 | Gansu Province |
63 | Qinghai Province |
64 | Ningxia |
65 | Xinjiang |
71 | Taiwan |
81 | Hong Kong |
82 | Macao |
Supported Chinese city codes
City code | City name | State (Province) code |
---|---|---|
1000 | Beijing City | 11 |
1100 | Tianjin City | 12 |
1210 | Shijiazhuang City | 13 |
1240 | Tangshan City | 13 |
1260 | Qinhuangdao City | 13 |
1270 | Handan City | 13 |
1310 | Xingtai City | 13 |
1340 | Baoding City | 13 |
1380 | Zhangjiakou City | 13 |
1410 | Chengde City | 13 |
1430 | Cangzhou City | 13 |
1460 | Langfang City | 13 |
1480 | Hengshui City | 13 |
1610 | Taiyuan city | 14 |
1620 | Datong City | 14 |
1630 | Yangquan city | 14 |
1640 | Changzhi City | 14 |
1680 | Jingcheng City | 14 |
1690 | Shuozhou City | 14 |
1710 | Xinzhou City | 14 |
1730 | Lvliang City | 14 |
1750 | Jingzhong City | 14 |
1770 | Linfeng City | 14 |
1810 | Yuncheng City | 14 |
1910 | Hohhot City | 15 |
1920 | Baotou City | 15 |
1930 | Wuhai City | 15 |
1940 | Chifeng City | 15 |
1960 | Hulunbeier City | 15 |
1980 | Hinggan League | 15 |
1990 | Tongliao City | 15 |
2010 | Xilin Gol League | 15 |
2030 | Ulanqab City | 15 |
2050 | Erdos City | 15 |
2070 | Bayan Nur City | 15 |
2080 | Alxa League | 15 |
2210 | Shenyang City | 21 |
2220 | Dalian City | 21 |
2230 | Anshan City | 21 |
2240 | Fushun City | 21 |
2250 | Benxi City | 21 |
2260 | Dandong City | 21 |
2270 | Jinzhou City | 21 |
2276 | Huludao City | 21 |
2280 | Yingkou City | 21 |
2290 | Fuxin City | 21 |
2310 | Liaoyang City | 21 |
2320 | Panjing City | 21 |
2330 | Tieling City | 21 |
2340 | Chaoyang City | 21 |
2410 | Changchun City | 22 |
2420 | Jilin City | 22 |
2430 | Siping City | 22 |
2440 | Liaoyuan City | 22 |
2450 | Tonghua City | 22 |
2460 | Baishan City | 22 |
2470 | Baicheng City | 22 |
2490 | Yanbian Korean Autonomous Prefecture | 22 |
2520 | Songyuan City | 22 |
2610 | Harbin City | 23 |
2640 | Qiqihar City | 23 |
2650 | Daqing City | 23 |
2660 | Jixi City | 23 |
2670 | Hegang City | 23 |
2680 | Shuangyashan City | 23 |
2690 | Jiamusi City | 23 |
2710 | Yichun City | 23 |
2720 | Mudanjiang City | 23 |
2740 | Qitaihe City | 23 |
2760 | Suihua City | 23 |
2780 | Heihe City | 23 |
2790 | Daxinganling region | 23 |
2900 | Shanghai City | 31 |
3010 | Nanjing City | 32 |
3020 | Wuxi City | 32 |
3030 | Xuzhou City | 32 |
3040 | Changzhou City | 32 |
3050 | Suzhou City | 32 |
3060 | Nantong City | 32 |
3070 | Lianyungang City | 32 |
3080 | Huai An City | 32 |
3090 | Suqian City | 32 |
3110 | Yancheng City | 32 |
3120 | Yangzhou City | 32 |
3128 | Taizhou City | 32 |
3140 | Zhenjiang City | 32 |
3310 | Hangzhou City | 33 |
3320 | Ningbo City | 33 |
3330 | Wenzhou City | 33 |
3350 | Jiaxing City | 33 |
3360 | Huzhou City | 33 |
3370 | Shaoxing City | 33 |
3380 | Jinhua City | 33 |
3410 | Quzhou City | 33 |
3420 | Zhoushan City | 33 |
3430 | Lishui City | 33 |
3450 | Taizhou City | 33 |
3610 | Hefei City | 34 |
3620 | Wuhu City | 34 |
3630 | Bengbu City | 34 |
3640 | Huainan City | 34 |
3650 | Ma anshan City | 34 |
3660 | Huaibei City | 34 |
3670 | Tongling City | 34 |
3680 | Anqing City | 34 |
3710 | Huangshan City | 34 |
3720 | Fuyang City | 34 |
3722 | Bozhou City | 34 |
3740 | Suzhou City | 34 |
3750 | Chuzhou City | 34 |
3760 | Liu an City | 34 |
3771 | Xuancheng City | 34 |
3781 | Chaohu City | 34 |
3790 | Chizhou City | 34 |
3910 | Fuzhou City | 35 |
3930 | Xiamen City | 35 |
3940 | Putian City | 35 |
3950 | Sanming City | 35 |
3970 | Quanzhou City | 35 |
3990 | Zhangzhou City | 35 |
4010 | Nanping City | 35 |
4030 | Ningde City | 35 |
4050 | Longyan City | 35 |
4210 | Nanchang City | 36 |
4220 | Jingdezhen City | 36 |
4230 | Pingxiang City | 36 |
4240 | Jiujiang City | 36 |
4260 | Xinyu City | 36 |
4270 | Yingtan City | 36 |
4280 | Ganzhou City | 36 |
4310 | Yichun City | 36 |
4330 | Shangrao City | 36 |
4350 | Ji an City | 36 |
4370 | Fuzhou City | 36 |
4510 | Jinan City | 37 |
4520 | Qingdao City | 37 |
4530 | Zibo City | 37 |
4540 | Zaozhuang City | 37 |
4550 | Dongying City | 37 |
4560 | Yantai City | 37 |
4580 | Weifang City | 37 |
4610 | Jining City | 37 |
4630 | Tai an City | 37 |
4634 | Laiwu City | 37 |
4650 | Weihai City | 37 |
4660 | Binzhou City | 37 |
4680 | Dezhou City | 37 |
4710 | Liaocheng City | 37 |
4730 | Linyi City | 37 |
4732 | Rizhao City | 37 |
4750 | Heze City | 37 |
4910 | Zhengzhou City | 41 |
4920 | Kaifeng City | 41 |
4930 | Luoyang City | 41 |
4950 | Pingdingshan City | 41 |
4960 | Anyang City | 41 |
4970 | Hebi City | 41 |
4980 | Xinxiang City | 41 |
5010 | Jiaozuo City | 41 |
5020 | Puyang City | 41 |
5030 | Xuchang City | 41 |
5040 | Luohe City | 41 |
5050 | Sanmenxia City | 41 |
5060 | Shangqiu City | 41 |
5080 | Zhoukou City | 41 |
5110 | Zhumendian City | 41 |
5130 | Nanyang City | 41 |
5150 | Xinyang City | 41 |
5210 | Wuhan City | 42 |
5220 | Huangshi City | 42 |
5230 | Shiyan City | 42 |
5260 | Yichang City | 42 |
5280 | Xiangfan City | 42 |
5286 | Suizhou City | 42 |
5310 | Ezhou City | 42 |
5320 | Jinmen City | 42 |
5330 | Huanggang City | 42 |
5350 | Xiaogan City | 42 |
5360 | Xianning City | 42 |
5370 | Jinzhou City | 42 |
5410 | Enshi Prefecture | 42 |
5510 | Changsha City | 43 |
5520 | Zhuzhou City | 43 |
5530 | Xiangtan City | 43 |
5540 | Hengyang City | 43 |
5550 | Shaoyang City | 43 |
5570 | Yueyang City | 43 |
5580 | Changde City | 43 |
5590 | Zhangjiajie City | 43 |
5610 | Yiyang City | 43 |
5620 | Loudi City | 43 |
5630 | Chenzhou City | 43 |
5650 | Yongzhou City | 43 |
5670 | Huaihua City | 43 |
5690 | Jishou City | 43 |
5810 | Guangzhou City | 44 |
5820 | Shaoguan City | 44 |
5840 | Shenzhen City | 44 |
5850 | Zhuhai City | 44 |
5860 | Shantou City | 44 |
5865 | Jieyang City | 44 |
5869 | Chaozhou City | 44 |
5880 | Foshan City | 44 |
5890 | Jiangmen City | 44 |
5910 | Zhanjiang City | 44 |
5920 | Maoming City | 44 |
5930 | Zhaoqing City | 44 |
5937 | Yunfu City | 44 |
5950 | Huizhou City | 44 |
5960 | Meizhou City | 44 |
5970 | Shanwei City | 44 |
5980 | Heyuan City | 44 |
5990 | Yangjiang City | 44 |
6010 | Qingyuan City | 44 |
6020 | Dongguan City | 44 |
6030 | Zhongshan City | 44 |
6110 | Nanning City | 45 |
6128 | Chongzuo City | 45 |
6140 | Liuzhou City | 45 |
6155 | Laibing City | 45 |
6170 | Guilin City | 45 |
6210 | Wuzhou City | 45 |
6225 | Hezhou City | 45 |
6230 | Beihai City | 45 |
6240 | Yulin City | 45 |
6242 | Guigang City | 45 |
6261 | Baise City | 45 |
6281 | Hechi City | 45 |
6311 | Qingzhou City | 45 |
6330 | Fangchenggang City | 45 |
6410 | Haikou City | 46 |
6420 | Sanya City | 46 |
6510 | Chengdu City | 51 |
6530 | Chongqing City | 50 |
6550 | Zigong City | 51 |
6560 | Panzhihua City | 51 |
6570 | Luzhou City | 51 |
6580 | Deyang City | 51 |
6590 | Mianyang City | 51 |
6610 | Guangyuan City | 51 |
6620 | Suining City | 51 |
6630 | Neijiang City | 51 |
6636 | Ziyang City | 51 |
6650 | Leshan City | 51 |
6652 | Meishan City | 51 |
6670 | Wanzhou District | 50 |
6690 | Fuling District | 50 |
6710 | Yibing City | 51 |
6730 | Nanchong City | 51 |
6737 | Guang an City | 51 |
6750 | Dazhou City | 51 |
6758 | Bazhong City | 51 |
6770 | Ya an City | 51 |
6790 | Aba Tibetan and Qiang Autonomous Region | 51 |
6810 | Garze Tibetan Autonomous Prefecture | 51 |
6840 | Yi Autonomous Prefecture of Liangshan | 51 |
6870 | Qianjiang District | 50 |
7010 | Guiyang City | 52 |
7020 | Liupanshui City | 52 |
7030 | Zunyi City | 52 |
7050 | Tongren District | 52 |
7070 | Qianxinan Prefecture | 52 |
7090 | Bijie District | 52 |
7110 | Anshun City | 52 |
7130 | Qiandongnan Prefecture | 52 |
7150 | Qianan Prefecture | 52 |
7310 | Kunming City | 53 |
7340 | Zhaotong City | 53 |
7360 | Qujing City | 53 |
7380 | Chuxiong City | 53 |
7410 | Yuxi City | 53 |
7430 | Honghe Hani Autonomous Prefecture | 53 |
7450 | Wenshan Zhuang-Miao Autonomous Prefecture | 53 |
7470 | Simao City | 53 |
7490 | Xishuangbanna Dai Autonomous Prefecture | 53 |
7510 | Dali Bai Autonomous prefecture | 53 |
7530 | Baoshan City | 53 |
7540 | Dehong Dai-Jingpo Autonomous Prefecture | 53 |
7550 | Lijiang City | 53 |
7560 | Nujiang Lisu Autonomous Prefecture | 53 |
7570 | Diqing Tibetan Autonomous Region | 53 |
7580 | Lincang City | 53 |
7700 | Lhasa City | 54 |
7720 | Changdu District | 54 |
7740 | Shannan District | 54 |
7760 | Shigatse District | 54 |
7790 | Naqu District | 54 |
7811 | Ali District | 54 |
7830 | Linzhi District | 54 |
7910 | Xi an City | 61 |
7920 | Tongchuan City | 61 |
7930 | Baoji City | 61 |
7950 | Xianyang City | 61 |
7970 | Weinan City | 61 |
7990 | Hanzhong City | 61 |
8010 | Ankang City | 61 |
8030 | Shangluo City | 61 |
8040 | Yan an City | 61 |
8060 | Yulin City | 61 |
8210 | Lanzhou City | 62 |
8220 | Jiayuguan City | 62 |
8230 | Jinchang City | 62 |
8240 | Baiyin City | 62 |
8250 | Tianshui City | 62 |
8260 | Jiuquan City | 62 |
8270 | Zhangye City | 62 |
8280 | Wuwei City | 62 |
8290 | Dingxi City | 62 |
8310 | Longnan City | 62 |
8330 | Pingliang City | 62 |
8340 | Qingyang City | 62 |
8360 | Linxia City | 62 |
8380 | Gannan Prefecture | 62 |
8510 | Xining City | 63 |
8520 | Haidong District | 63 |
8540 | Haibei Tibetan Autonomous Region | 63 |
8550 | Huangnan Tibetan Autonomous Region | 63 |
8560 | Hainan Tibetan Autonomous Region | 63 |
8570 | Guoluo Tibetan Autonomous Region | 63 |
8580 | Yushu Tibetan Autonomous Region | 63 |
8590 | Haixi Mogolian-Tibetan Autonomous Region | 63 |
8710 | Yinchuan City | 64 |
8720 | Shizuishan City | 64 |
8731 | Wuzhong City | 64 |
8733 | Zhongwei City | 64 |
8741 | Guyuan City | 64 |
8810 | Urumqi City | 65 |
8820 | Karamay City | 65 |
8830 | Turpan city | 65 |
8840 | Hami City | 65 |
8844 | Altay Prefecture | 65 |
8850 | Hui Autonomous Prefecture of Changji | 65 |
8870 | Bortala Mongol Autonomous Prefecture | 65 |
8880 | Bayingolin Mogol Autonomous Prefecture | 65 |
8910 | Akesu Prefecture | 65 |
8930 | Kizilsu Kirghiz Autonomous Prefecture | 65 |
8940 | Kashi Prefecture | 65 |
8960 | Hotan Prefecture | 65 |
8980 | Kazak Autonomous Prefecture of Ili | 65 |
9010 | Tacheng prefecture | 65 |
9020 | Altay Prefecture | 65 |
9028 | Shihezi City | 65 |