gyfl
/
xyzshop


			
				
					
						
						
							123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413
							<!DOCTYPE html>
<html>

	<head>
		<meta charset="UTF-8">
		<title>运营商接口文档</title>
		<link rel="stylesheet" href="https://www.layuicdn.com/layui-v2.5.5/css/layui.css" media="all">
	</head>
	<style>
		p {
			font-size: 25px;
		}
	</style>

	<body>
		<fieldset class="layui-elem-field layui-field-title" style="margin-top: 20px;">
			<legend style="font-size: 40px;">1.请求规范</legend>
			<p>1.1 发送请求</p>
			<p>发送Http请求用POST</p>
			<p>测试商户: s_id=1607066747476332018      key=V6Qv8zQel9RBvE9lIa7NYYqGCe5eCdbPPuRByE7rrQLdBC9RMKfWLbGbb3IsSOFI</p>
			<p>加签规则:金额+回调地址+订单号+手机号码+商户编号+key 进行MD5 加密（UTF8 编码）32位转大写---(amount+notify_url+order_no+phone+s_id+key).toUpperCase()</p>
			<p>请求地址:&nbsp;&nbsp;&nbsp;http://系统方提供的ip/Order/Api/invest</p>
		</fieldset>

		<fieldset class="layui-elem-field layui-field-title" style="margin-top: 20px;">
			<legend>请求数据</legend>
		</fieldset>

		<div class="layui-form">
			<table class="layui-table">
				<colgroup>
					<col width="150">
					<col width="150">
					<col width="200">
					<col>
				</colgroup>
				<thead>
					<tr>
						<th>名称</th>
						<th>类型</th>
						<th>必须</th>
						<th>备注</th>
					</tr>
				</thead>
				<tbody>
					<tr>
						<td>phone</td>
						<td>String</td>
						<td>是</td>
						<td>充值手机号</td>
					</tr>
					<tr>
						<td>order_no</td>
						<td>String</td>
						<td>是</td>
						<td>运营商提供的订单号</td>
					</tr>
					<tr>
						<td>s_id</td>
						<td>String</td>
						<td>是</td>
						<td>系统提供的商户编号</td>
					</tr>
					<tr>
						<td>amount</td>
						<td>String</td>
						<td>是</td>
						<td>金额,正整数，以元为单位</td>
					</tr>
					<tr>
						<td>notify_url</td>
						<td>String</td>
						<td>是</td>
						<td>充值结果回调地址 </td>
					</tr>
					<tr>
						<td>timeout</td>
						<td>String</td>
						<td>否</td>
						<td>时间戳:1609810477（不参与加签） </td>
					</tr>
					<tr>
						<td>sign</td>
						<td>String</td>
						<td>是</td>
						<td>签名</td>
					</tr>
				</tbody>
			</table>
			<p> 1.2同步返回参数 Map</p>
			<table class="layui-table">
				<colgroup>
					<col width="150">
					<col width="150">
					<col width="200">
					<col>
				</colgroup>
				<thead>
					<tr>
						<th>名称</th>
						<th>类型</th>
						<th>必须</th>
						<th>备注</th>
					</tr>
				</thead>
				<tbody>
					<tr>
						<td>result</td>
						<td>String</td>
						<td>是</td>
						<td>下单状态返回码-SUCCESS：受理成功 fail:受理失败</td>
					</tr>
					<tr>
						<td>msg</td>
						<td>String</td>
						<td>是</td>
						<td>状态码说明（见3.msg编码说明）</td>
					</tr>
					<tr>
						<td>merchantOrderNo</td>
						<td>String</td>
						<td>是</td>
						<td>运营商订单号</td>
					</tr>
					<tr>
						<td>orderNo</td>
						<td>String</td>
						<td>否</td>
						<td>系统订单号</td>
					</tr>
			</table>
			<p>1.3 根据回调地址异步返回通知结果参数</p>
			<table class="layui-table">
				<colgroup>
					<col width="150">
					<col width="150">
					<col width="200">
					<col>
				</colgroup>
				<thead>
					<tr>
						<th>名称</th>
						<th>类型</th>
						<th>必须</th>
						<th>备注</th>
					</tr>
				</thead>
				<tbody>
					<tr>
						<td>result</td>
						<td>String</td>
						<td>是</td>
						<td>充值状态--success：充值成功小写fail:充值失败</td>
					</tr>
					<tr>
						<td>msg</td>
						<td>String</td>
						<td>是</td>
						<td>状态码说明（见3.msg编码说明）</td>
					</tr>
					<tr>
						<td>order</td>
						<td>String</td>
						<td>否</td>
						<td>联通电信官方订单号,充值失败为空</td>
					</tr>
					<tr>
						<td>phone_no</td>
						<td>String</td>
						<td>是</td>
						<td>充值手机号</td>
					</tr>
					<tr>
						<td>amount</td>
						<td>String</td>
						<td>是</td>
						<td>充值金额 </td>
					</tr>
					<tr>
						<td>op_no</td>
						<td>String</td>
						<td>是</td>
						<td>运营商订单号</td>
					</tr>
					<tr>
						<td>sign</td>
						<td>String</td>
						<td>是</td>
						<td>签名方式 result+msg+order_no+phone_no+amount+op_no+key 进行 MD5 方式（UTF8 编码）</td>
					</tr>
				</tbody>
			</table>
		</div>

		<fieldset class="layui-elem-field layui-field-title" style="margin-top: 20px;">
			<legend style="font-size: 40px;">2.充值状态查询接口</legend>
			<p>1.1 发送请求</p>
			<p>发送Http请求用POST</p>
			<p>加签规则:orderId+sid+key 进行 MD5 方式大写（UTF8 编码）</p>
			<p>请求地址:&nbsp;&nbsp;&nbsp;http://系统方提供的ip/Order/Api/queryStatus</p>
			<p>请求参数:</p>
		</fieldset>
		<div class="layui-form">
			<table class="layui-table">
				<colgroup>
					<col width="150">
					<col width="150">
					<col width="200">
					<col>
				</colgroup>
				<thead>
					<tr>
						<th>名称</th>
						<th>类型</th>
						<th>必须</th>
						<th>备注</th>
					</tr>
				</thead>
				<tbody>
					<tr>
						<td>sid</td>
						<td>String</td>
						<td>是</td>
						<td>商户编码</td>
					</tr>
					<tr>
						<td>orderId</td>
						<td>String</td>
						<td>是</td>
						<td>运营商订单号</td>
					</tr>
					<tr>
						<td>sign</td>
						<td>String</td>
						<td>是</td>
						<td>签名方式:orderId+sid+key 进行 MD5 方式大写（UTF8 编码）</td>
					</tr>
				</tbody>
			</table>
			<p>同步返回参数:</p>
			<table class="layui-table">
				<colgroup>
					<col width="150">
					<col width="150">
					<col width="200">
					<col>
				</colgroup>
				<thead>
					<tr>
						<th>名称</th>
						<th>类型</th>
						<th>必须</th>
						<th>备注</th>
					</tr>
				</thead>
				<tbody>
					<tr>
						<td>result</td>
						<td>String</td>
						<td>是</td>
						<td>请求状态码</td>
					</tr>
					<tr>
						<td>msg</td>
						<td>String</td>
						<td>是</td>
						<td>状态码说明（见3.msg编码说明）</td>
					</tr>
					<tr>
						<td>data</td>
						<td>Map</td>
						<td>否</td>
						<td>返回的订单数据</td>
					</tr>
				</tbody>
			</table>
			<p>充值状态查询接口返回data订单数据:</p>
			<table class="layui-table">
				<colgroup>
					<col width="150">
					<col width="150">
					<col width="200">
					<col>
				</colgroup>
				<thead>
					<tr>
						<th>名称</th>
						<th>类型</th>
						<th>必须</th>
						<th>备注</th>
					</tr>
				</thead>
				<tbody>
					<tr>
						<td>orderNo</td>
						<td>String</td>
						<td>是</td>
						<td>商户订单号</td>
					</tr>
					<tr>
						<td>phone</td>
						<td>String</td>
						<td>是</td>
						<td>手机号</td>
					</tr>
					<tr>
						<td>mobileOrderId</td>
						<td>String</td>
						<td>否</td>
						<td>网厅单号</td>
					</tr>
					<tr>
						<td>amount</td>
						<td>String</td>
						<td>是</td>
						<td>金额</td>
					</tr>
					<tr>
						<td>status</td>
						<td>String</td>
						<td>是</td>
						<td>订单状态</td>
					</tr>
				</tbody>
			</table>
		</div>
		<fieldset class="layui-elem-field layui-field-title" style="margin-top: 20px;">
			<legend style="font-size: 40px;">3.msg编码说明</legend>
		</fieldset>
		<div class="layui-form">
			<table class="layui-table">
				<colgroup>
					<col width="150">
					<col>
				</colgroup>
				<thead>
					<tr>
						<th>编码</th>
						<th>说明</th>
					</tr>
				</thead>
				<tbody>
					<tr>
						<td>0</td>
						<td>充值失败</td>
					</tr>
					<tr>
						<td>1</td>
						<td>充值成功</td>
					</tr>
					<tr>
						<td>2</td>
						<td>充值中</td>
					</tr>
					<tr>
						<td>3</td>
						<td>匹配失败</td>
					</tr>
					<tr>
						<td>-1</td>
						<td>商户不存在</td>
					</tr>
					<tr>
						<td>-2</td>
						<td>此订单已被列入黑名单</td>
					</tr>
					<tr>
						<td>-3</td>
						<td>下单超时</td>
					</tr>
					<tr>
						<td>-4</td>
						<td>上传参数不能为空</td>
					</tr>
					<tr>
						<td>-5</td>
						<td>订单号不可重复</td>
					</tr>
					<tr>
						<td>-6</td>
						<td>加密参数不匹配，请检查是否加签成功</td>
					</tr>
					<tr>
						<td>-7</td>
						<td>商户余额不足</td>
					</tr>
					<tr>
						<td>-8</td>
						<td>订单不存在(按照失败订单处理)</td>
					</tr>
					<tr>
						<td>-9</td>
						<td>移动运营商通道已关闭</td>
					</tr>
					<tr>
						<td>-10</td>
						<td>联通运营商通道已关闭</td>
					</tr>
					<tr>
						<td>-11</td>
						<td>电信运营商通道已关闭</td>
					</tr>
					<tr>
						<td>-99</td>
						<td>数据处理异常,请稍后再试</td>
					</tr>
				</tbody>
			</table>
		</div>

	</body>

</html>