POS 商户编号查询-完整提供 Demo 代码示例及数据专业且全面的 API 查询接口
更多资料请参考:www.woyaocha.net/product/posmcc
接口描述
功能描述
通过商户编号获取中国大陆地区所有线下收单机构的商户信息,如:收单机构、MCC编码类别、适用费率及商户所在地区等信息。
URL 示例
1)http
协议:
POST 方式请求:
Copy
http://cha.ebaitian.cn/api/json?appid=xxx&module=getPosmccInfo&merchantNo=xxx&sign=xxx
GET 方式请求:
Copy
http://cha.ebaitian.cn/api/json?type=get&appid=xxx&module=getPosmccInfo&merchantNo=xxx&sign=xxx
2)https
协议:
POST 方式请求:
Copy
https://cha.ebaitian.cn/api/json?appid=xxx&module=getPosmccInfo&merchantNo=xxx&sign=xxx
GET 方式请求:
Copy
https://cha.ebaitian.cn/api/json?type=get&appid=xxx&module=getPosmccInfo&merchantNo=xxx&sign=xxx
请求参数
数据包体
Copy
{"type": "get","appid": "1000xxxx","module": "getPosmccInfo","merchantNo": "820521154110001","sign": "ecab4881ee80ad3d76bb1da68387428ca752eb885e52621a3129dcf4d9bc4fd4"
}
参数说明
参数 | 必选 | 类型 | 描述 |
---|---|---|---|
type | 否 | string | 授权接口的请求方式 |
appid | 是 | string | 授权接口的 AppID,请填写您在我要查官网上申请到的 AppID |
module | 是 | string | 目标请求的数据模块,查询 POS 商户编号为:getPosmccInfo |
merchantNo | 是 | string | 目标要查询的商户编号,即 POS 签购单上的商户编号,一般为15位数字 |
sign | 是 | string | 请求凭证,具体计算方式见下面的其他说明 |
其他说明
1)type:可选值 get,如果赋值 get,则以 get 方式提交数据;默认以 post 方式提交数据;
2)sign:签名校验,根据公式 $sign=sha256(appid=$appid&module=getPosmccInfo&merchantNo=$merchantNo&appkey=$appkey)
生成;其中:appkey 为授权接口的 AppKey,请填写您在我要查官网上申请到的 AppKey 。
构造伪代码如下:
Copy
string type = "get"; //请求方式,可以赋值为:post
string appid = "1000xxxx"; //sdkappid 对应的 appid,需要业务方高度保密
string module = "getPosmccInfo"; //请求的数据模块,此处赋值:getMobileArea
string merchantNo = "820521154110001"; //要查询的手机号码,注意仅能为中国大陆地区11位手机号码
string sign = sha256(appid=1000xxxx&module=getPosmccInfo&merchantNo=820521154110001&appkey=56cf61af4b7897e704f67deb88ae8f24);
响应参数
数据包体
Copy
{"result":1,"description":"TRUE","flag":"","posmccInfo":{"posbankInfo":{"bankclass":"收单资质机构","bankcode":"820","bankareacode":"0","bankareaname":null,"bankname":"盛付通"},"posareaInfo":{"areacode":"5211","province":"湖北省","city":"武汉市","dis":"江岸区"},"posmccInfo":{"bclass":"民生类","sclass":"加油、超市类","mcccode":"5411","broad":"大型仓储式超级市场大型仓储式超级市场","rates":"0.34","note":"包含“超市、仓储式大卖场、连锁店、便利店”等字样;
开架式连锁便利店集团,当其以整体方式签订入网协议,且在同一地区门店数量在20 家以上;
食品饮料自动售货机,以及综合菜市场的零售活动"}}
}
参数说明
参数说明
参数 | 必选 | 类型 | 描述 |
---|---|---|---|
result | 是 | string | 接口响应结果:0-失败;1-成功 |
description | 是 | string | 接口响应描述:一般为 TURE(result=1) 与 FALSE(result=0),或者返回错误信息 |
flag | 否 | string | 错误说明,没有错误则返回空 |
posmccInfo | 是 | object | 返回 POS 收单商户信息 |
posmccInfo 参数说明:
参数 | 必选 | 类型 | 描述 |
---|---|---|---|
posbankInfo | 是 | object | POS 收单机构信息,一般为银行或第三方电子支付公司 |
posareaInfo | 是 | object | POS 收单商户地区信息 |
posmccInfo | 是 | object | POS 收单商户详细信息 |
posbankInfo 参数说明:
参数 | 必选 | 类型 | 描述 |
---|---|---|---|
bankclass | 是 | string | POS 收单机构类别,一般为商业银行或商业收单机构 |
bankcode | 是 | string | POS 收单机构代码 |
bankareacode | 是 | string | POS 收单机构区域代码 |
bankareaname | 是 | string | POS 收单机构区域名称 |
bankname | 是 | string | POS 收单机构名称 |
posareaInfo 参数说明:
参数 | 必选 | 类型 | 描述 |
---|---|---|---|
areacode | 是 | string | POS 收单商户地区代码 |
province | 是 | string | POS 收单商户所在省(市/自治区) |
city | 是 | string | POS 收单商户所在市(区/自治州) |
dis | 是 | string | POS 收单商户所在区(县/市/区) |
posmccInfo 参数说明:
参数 | 必选 | 类型 | 描述 |
---|---|---|---|
bclass | 是 | string | POS 收单商户所属 MCC 大类名称 |
sclass | 是 | string | POS 收单商户所属 MCC 小类名称 |
mcccode | 是 | string | POS 收单商户 MCC 编码 |
broad | 是 | string | POS 收单商户 MCC 编码类别 |
rates | 是 | string | POS 收单商户适用费率 |
note | 是 | string | POS 收单商户其他备注信息 |
SDK 及代码示例
PHP SDK
方法一:以 POST 方式请求数据
Copy
//接口参数
$api_url='http://cha.ebaitian.cn/api/json';
$api_appid='1000xxxx';
$api_appkey='56cf61af4b7897e704f67deb88ae8f24';//函数,以POST方式提交数据,PHP需要开启CURL函数;数据传输安全,建议使用
function getPosmccInfo($merchantNo){global $api_url,$api_appid,$api_appkey;$posturl=$api_url;$data='appid='.$api_appid.'&module=getPosmccInfo&merchantNo='.$merchantNo;$sign=hash("sha256",$data.'&appkey='.$api_appkey);$postdata=array("appid"=>$api_appid,"appkey"=>$api_appkey,"module"=>"getPosmccInfo","merchantNo"=>$merchantNo,'sign'=>$sign);$curl = curl_init();curl_setopt($curl, CURLOPT_URL, $posturl);curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);curl_setopt($curl, CURLOPT_POST, 1);curl_setopt($curl, CURLOPT_POSTFIELDS, $postdata);$output = curl_exec($curl);curl_close($curl);$obj=json_decode($output);$result=$obj->result;if($result==1){$value=$obj->posmccInfo->posbankInfo->bankname;$value.=','.$obj->posmccInfo->posareaInfo->province;$value.=','.$obj->posmccInfo->posareaInfo->city;$value.=','.$obj->posmccInfo->posareaInfo->dis;$value.=','.$obj->posmccInfo->posmccInfo->broad;$value.=','.$obj->posmccInfo->posmccInfo->rates;}else{$value=$obj->flag;}return $value;
}
//调用函数
$merchantNo='820521154110001';
echo getPosmccInfo($merchantNo);
exit;
方法二:以 GET 方式请求数据
Copy
//接口参数
$api_url='http://cha.ebaitian.cn/api/json';
$api_appid='1000xxxx';
$api_appkey='56cf61af4b7897e704f67deb88ae8f24';//函数,以GET方式提交数据
function getPosmccInfo($merchantNo){global $api_url,$api_appid,$api_appkey;$data='appid='.$api_appid.'&module=getPosmccInfo&merchantNo='.$merchantNo;$sign=hash("sha256",$data.'&appkey='.$api_appkey);$info_get=file_get_contents($api_url.'?type=get&'.$data.'&sign='.$sign);$info_json=json_decode($info_get, true);$result=$info_json['result'];if($result==1){$value=$info_json['posmccInfo']['posbankInfo']['bankname'];$value.=','.$info_json['posmccInfo']['posareaInfo']['province'];$value.=','.$info_json['posmccInfo']['posareaInfo']['city'];$value.=','.$info_json['posmccInfo']['posareaInfo']['dis'];$value.=','.$info_json['posmccInfo']['posmccInfo']['broad'];$value.=','.$info_json['posmccInfo']['posmccInfo']['rates'];}else{$value=$info_json['flag'];}return $value;
}
//调用函数
$merchantNo='820521154110001';
echo getPosmccInfo($merchantNo);
exit;
Java SDK
Copy
//以下示例是以 GET 方式请求数据
public class QueryHelper {public static String apiurl="http://cha.ebaitian.cn/api/json";public static String appid="1000xxxx";public static String appkey="56cf61af4b7897e704f67deb88ae8f24";public static String module="getPosmccInfo";public static String getSHA256Str(String str){MessageDigest messageDigest;String encdeStr = "";try {messageDigest = MessageDigest.getInstance("SHA-256");byte[] hash = messageDigest.digest(str.getBytes("UTF-8"));encdeStr = Hex.encodeHexString(hash);} catch (NoSuchAlgorithmException e) {e.printStackTrace();} catch (UnsupportedEncodingException e) {e.printStackTrace();}return encdeStr;}public static String get(String urlString) {try {URL url = new URL(urlString);HttpURLConnection conn = (HttpURLConnection) url.openConnection();conn.setConnectTimeout(5 * 1000);conn.setReadTimeout(5 * 1000);conn.setDoInput(true);conn.setDoOutput(true);conn.setUseCaches(false);conn.setInstanceFollowRedirects(false);conn.setRequestMethod("GET"); int responseCode = conn.getResponseCode();if (responseCode == 200) {StringBuilder builder = new StringBuilder();BufferedReader br = new BufferedReader(new InputStreamReader(conn.getInputStream(),"utf-8"));for (String s = br.readLine(); s != null; s = br.readLine()) {builder.append(s);}br.close();return builder.toString();}} catch (IOException e) {e.printStackTrace();}return null;}public static String queryPosmcc(String merchantNo){String sign=getSHA256Str("appid="+appid+"&module="+module+"&merchantNo="+merchantNo+"&appkey="+appkey);String url=apiurl+"?type=get&appid="+appid+"&module="+module+"&merchantNo="+merchantNo+"&sign="+sign;return get(url);}
}//使用示例
QueryHelper.queryPosmcc("820521154110001");
Python SDK
Copy
#!/usr/bin/python
# -*- coding: utf-8 -*-
import httplib2
import hashlib
from urllib.parse import urlencode #python3
#from urllib import urlencode #python2apiurl='http://cha.ebaitian.cn/api/json'
appid='1000xxxx'
appkey='56cf61af4b7897e704f67deb88ae8f24'
module='getPosmccInfo'
merchantNo='820521154110001'
data='appid='+appid+'&module='+module+'&merchantNo='+merchantNo
sign_data=data+'&appkey='+appkey# from Crypto.Cipher import AES
# from Crypto.Hash import SHA256
# 256
hash_256 = hashlib.sha256()
hash_256.update(sign_data.encode('utf-8'))
sign = hash_256.hexdigest()postdata = urlencode({'appid':appid,'module':module,'merchantNo':merchantNo,'sign':sign})
url = apiurl+'?'+postdata
http = httplib2.Http()
response, content = http.request(url,'GET')
print(content.decode("utf-8"))
Node.js SDK
方法一:以 POST 方式请求数据
Copy
//以 POST 方式提交
var http = require('http'); var querystring = require('querystring'); //参数设置
var appid = '1000xxxx';
var appkey = '56cf61af4b7897e704f67deb88ae8f24';
var module = 'getPosmccInfo';//目标查询商户编号
var merchantNo='820521154110001';//签名,SHA256 不可直接调用;函数参考下载地址:https://github.com/alexweber/jquery.sha256
var sign = SHA256('appid='+appid+'&module='+module+'&merchantNo='+merchantNo+'&appkey='+appkey);//这是需要提交的数据
var post_data = {appid: appid, module: module,merchantNo: merchantNo,sign: sign
}; var content = querystring.stringify(post_data); var options = { hostname: 'cha.ebaitian.cn', port: 80, path: '/api/json', method: 'POST', headers: { 'Content-Type': 'application/x-www-form-urlencoded; charset=UTF-8' }
}; var req = http.request(options, function (res) { console.log('STATUS: ' + res.statusCode); console.log('HEADERS: ' + JSON.stringify(res.headers)); res.setEncoding('utf8'); res.on('data', function (chunk) { console.log('BODY: ' + chunk); //JSON.parse(chunk)});
}); req.on('error', function (e) { console.log('problem with request: ' + e.message);
}); // write data to request body
req.write(content); req.end();
方法二:以 GET 方式请求数据
Copy
//以 GET 方式提交
var http = require('http'); var querystring = require('querystring'); //参数设置
var appid = '1000xxxx';
var appkey = '56cf61af4b7897e704f67deb88ae8f24';
var module = 'getPosmccInfo';//目标查询商户编号
var merchantNo='820521154110001';//签名,SHA256 不可直接调用;函数参考下载地址:https://github.com/alexweber/jquery.sha256
var sign = SHA256('appid='+appid+'&module='+module+'&merchantNo='+merchantNo+'&appkey='+appkey);//这是需要提交的数据
var data = {appid: appid, module: module,merchantNo: merchantNo,sign: sign
};var content = querystring.stringify(data); var options = { hostname: 'cha.ebaitian.cn', port: 80, path: '/api/json?' + content, method: 'GET'
}; var req = http.request(options, function (res) { console.log('STATUS: ' + res.statusCode); console.log('HEADERS: ' + JSON.stringify(res.headers)); res.setEncoding('utf8'); res.on('data', function (chunk) { console.log('BODY: ' + chunk);});
}); req.on('error', function (e) { console.log('problem with request: ' + e.message);
}); req.end();
C# SDK
Copy
using System;
using System.Collections.Generic;
using System.Web;
using System.Net;
using System.Text;public class getPosmccInfo{public static string getInfo(string appid, string appkey, string module, string mobile){string url = string.Format("http://cha.ebaitian.cn/api/json?type=get&appid={0}&module={1}&mobile={2}&sgin={3}", appid, module, mobile, sgin);using (WebClient client = new WebClient()){client.Encoding = Encoding.UTF8;return client.DownloadString(url);}}
}string posmccInfo = getPosmccInfo.getInfo("1000xxxx", "getPosmccInfo", "820521154110001", "ecab4881ee80ad3d76bb1da68387428ca752eb885e52621a3129dcf4d9bc4fd4", Request.UserHostAddress);
Console.WriteLine(posmccInfo);
Response.Write(posmccInfo);
JavaScript SDK
方法一:以 POST 方式请求数据
Copy
//使用 JQuery 请先加载最新的 JQuery 插件
//参数设置
var apiurl = 'http://cha.ebaitian.cn/api/json';
var appid = '1000xxxx';
var appkey = '56cf61af4b7897e704f67deb88ae8f24';
var module = 'getPosmccInfo';//目标查询商户编号
var merchantNo='820521154110001';//签名,SHA256 不可直接调用;函数参考下载地址:https://github.com/alexweber/jquery.sha256
var sign = SHA256('appid='+appid+'&module='+module+'&merchantNo='+merchantNo+'&appkey='+appkey);//提交数据
$.ajax({url:apiurl,type:'post',dataType:'json',data:{appid:appid,module:module,merchantNo:merchantNo,sign:sign},success:function(res){console.log(res);}
});
方法二:以 GET 方式请求数据
Copy
//使用 JQuery 请先加载最新的 JQuery 插件
//参数设置
var apiurl = 'http://cha.ebaitian.cn/api/json';
var appid = '1000xxxx';
var appkey = '56cf61af4b7897e704f67deb88ae8f24';
var module = 'getPosmccInfo';//目标查询商户编号
var merchantNo='820521154110001';//签名,SHA256 不可直接调用;函数参考下载地址:https://github.com/alexweber/jquery.sha256
var sign = SHA256('appid='+appid+'&module='+module+'&merchantNo='+merchantNo+'&appkey='+appkey);//提交数据
$.ajax({url:apiurl,type:'post',dataType:'json',data:{appid:appid,module:module,merchantNo:merchantNo,sign:sign},success:function(res){console.log(res);}
});
ASP SDK
Copy
'设置参数
dim apiurl, appid, appkey, module, merchantNo, sign
apiurl="http://cha.ebaitian.cn/api/json"
appid="1000xxxx'
appkey="56cf61af4b7897e704f67deb88ae8f24"
module="getPosmccInfo"
merchantNo="820521154110001"'签名,SHA256 不可直接调用;函数参考地址:https://blog.csdn.net/yesoce/article/details/128546
sgin=SHA256("appid=&appid&"&module="&module&"&merchantNo="&merchantNo&"&appkey="&appkey)'异步提交数据
function PostHTTPPage(url,data)dim Http set Http=server.createobject("MSXML2.SERVERXMLHTTP.3.0")Http.open "POST",url,falseHttp.setRequestHeader "Content-Type", "application/x-www-form-urlencoded"Http.send(data) if Http.readystate<>4 then exit function End ifPostHTTPPage=bytesToBSTR(Http.responseBody,"UTF-8")set http=nothing if err.number<>0 then err.Clear
End function'提交数据
dim postdata, strTest
postdata="appid=&appid&"&module="&module&"&merchantNo="&merchantNo&"&sign="&sign
strTest=PostHTTPPage(apiurl,postdata)'返回结果
response.write(strTest)
response.end
常见问题
API 接口参数为空
此错误返回 JSON 数据如下:
Copy
{"result":0,"description":"API接口参数为空","flag":"appid:sign"
}
解决方法:
1)请检查 appid 及 sign 是否为空;
2)确保 appid 是从官网获取到正确的接口授权;
3)确保 sign 计算生成是正确的。
API 接口参数无效
此错误返回 JSON 数据如下:
Copy
{"result":0,"description":"API接口参数无效","flag":"appid"
}
解决方法:
1)请检查 appid 是否正确;
2)确保 appid 是从官网获取到正确的接口授权。
API 接口授权已到期
此错误返回 JSON 数据如下:
Copy
{"result":0,"description":"API接口授权已到期","flag":"end:2018-12-31 23:59:59"
}
解决方法:
1)请检查 appid 对应接口授权的期限是否过期;
2)如果接口授权过期,请到官网更新(免费用户直接更新,无需续费)或续费(针对商业付费用户)。
签名错误
此错误返回 JSON 数据如下:
Copy
{"result":0,"description":"签名错误","flag":"getPosmccInfo->sign"
}
解决方法:
1)请检查 sign 签名计算是否正确;
2)签名 sign 根据公式 $sign=sha256(appid=$appid&module=getPosmccInfo&merchantNo=$merchantNo&appkey=$appkey)
生成;其中:appkey 为授权接口的 AppKey,请填写您在我要查官网上申请到的 AppKey 。
请求受限
此错误返回 JSON 数据如下:
Copy
{"result":0,"description":"请求受限","flag":"getPosmccInfo->daylimit"
}
解决方法:
1)授权接口已超出当前接口产品请求的最大限制;
2)请根据实际使用需求升级您的接口产品。
POS 商户编号查询-完整提供 Demo 代码示例及数据专业且全面的 API 查询接口相关推荐
- 2019-nCoV肺炎疫情同程查询-完整提供 Demo 代码示例及数据专业且全面的 API 查询接口
更多资料请参考:www.woyaocha.net/product/trip2019ncov 手机查询链接(已开发好的):www.woyaocha.net/trip2019ncov 接口使用 我要查询 ...
- 行政区划代码查询-完整提供 Demo 代码示例及数据专业且全面的 API 查询接口
更多资料请参考:www.woyaocha.net/product/area 接口描述 功能描述 根据行政区划代码获取行政区划名称,或者根据行政区划名称获取行政区划代码. URL 示例 1)http 协 ...
- 快递查询(快递单号智能识别/快递公司+快递单号)-完整提供 Demo 代码示例及数据专业且全面的 API 查询接口
更多资料请参考:www.woyaocha.net/product/express 查询说明 接口一:快递单号智能识别 快递单号智能识别,是根据查询的快递单号自动智能识别出该运单所属的快递公司,再获取快 ...
- 院校代码/高等学校查询-整提供 Demo 代码示例及数据专业且全面的 API 查询接口
更多资料请参考:www.woyaocha.net/product/school 接口描述 功能描述 通过院校名称获取院校对应的院校代码/高等学校,或者通过院校代码/高等学校获取对应的院校名称:后期将会 ...
- 手机号码查询-整提供 Demo 代码示例及数据专业且全面的 API 查询接口
更多资料请参考:www.woyaocha.net/product/mobile 接口描述 功能描述 获取手机号码段的省市区以及运营商名称,通俗的说就是获取手机号码的归属地及电信运营商名称. URL 示 ...
- 一封传话聚合推送各语言demo代码示例
一封传话聚合推送各语言demo代码示例 前言 查看一封传话的API文档的GET请求只需一行代码,在url上拼接head和body参数即可完成推送.这里针对body数据量较大的情况,给出各语言实现的de ...
- 哪里可提供低代码开源大数据解决方案?
如今的时代,对数据的管理要求越来越高,其实,这也是新经济时代下的办公需求.针对数据化时代的发展要求,开源大数据解决方案可以为企业分忧解难,做好数据化管理和分析,优化数据资源,为企业的发展决策提供强而有 ...
- db2分页查询语句优化_面试官:数据量很大,分页查询很慢,怎么优化?
当需要从数据库查询的表有上万条记录的时候,一次性查询所有结果会变得很慢,特别是随着数据量的增加特别明显,这时需要使用分页查询.对于数据库分页查询,也有很多种方法和优化的点. 下面简单说一下我知道的一些 ...
- Google推出HTML 5练兵场 提供详尽代码示例,互联网营销
继Apple推出自己的HTML 5网站之后,作为推广HTML 5两巨头之一的Google也不甘寂寞,于是不久前他们推出HTML5 ROCKS. Google推广HTML 5网站HTML5 ROCK ...
最新文章
- 牌类游戏使用微服务重构笔记(四): micro框架使用经验
- sort,uniq,wc,history命令简介
- 玩转Win10的45个快捷键
- libgdx 学习笔记七 libgdx应用程序生命周期
- 从头开始开发gis_DevRel工程师一:从头开始建立开发人员关系团队
- 基于文本和语音的双模态情感分析
- 基于C# Winform的音量控制程序设计
- 中小型企业网络IP地址规划案例
- PVE解决VM is locked问题
- 社区角色(Kubernetes社区Maintainer是什么角色?)
- 有关企业合并时的10条IT措施
- 素描嘴巴注意这几个点,轻松画出头像神韵~
- 059.迪杰斯特拉(Dijkstra)算法的原理以及解决最短路径问题
- 什么是ITSS认证?哪些企业需要申请ITSS资质证书?
- [系统安全] 虚拟化安全之虚拟化概述
- 航信 PNR解析详解
- multisim元件库介绍
- Cannot parse date “2020-08-31 00:00:00“: while it seems to fit format ‘yyyy-MM-dd‘T‘HH:mm:ss.SSS
- GPS芯片获取的卫星时间会出现快几秒的原因
- 场效应管工作原理详解
热门文章
- 10,数据类型 ,复合类型 ,array ,map , struct
- k8s核心概念pod 基本定义和命令
- 2022年最新毕业设计题目汇总
- 用MDT 2012为企业部署windows 7(十二)--修改部署系统的任务序列
- 阿里云人脸识别新版SDK对接(java)
- 网页图片尺寸查看方法
- 用移动硬盘安装系统linux系统,U盘、移动硬盘引导启动安装linux系统【Centos 6.4 】...
- Android Studio: CreateProcess error=206 文件名或扩展名太长 解决方案之一
- 非常好的新版网盘系统,是一款PHP网盘与外链分享程序,支持文件预览
- java:alpine 字体 dockerdocker-compose 字体找不到 dockerfile创建镜像 找不到字体