会员充值异步通知
<h5>接口使用描述</h5>
<pre><code>针对客户充值操作,联拓富支付平台在获知客户交易结果后,会主动将结果通知合作方。在收到结果通知后,合作方须做出应答。联拓富平台每次请求等待响应时长是10s,如果收到的合作方应答不是成功或超时或者“success”,系统认为通知失败,联拓富平台连续通知3次每次间隔15s,如果一直失败,通过一定的策略定期重新发起通知,尽可能提高通知的成功率,但不保证通知最终能成功。(通知频率为15/30/180/1800/1800/1800/1800/3600,单位:秒)
重要提示:1)仅当充值单成功后才进行结果通知,失败和处理中均不通知。
2)合作方接收异步通知处理完成后,需要返回“success”(不区分大小写)。
3)异步通知的验签规则是通过返回的参数按照[签名规则]进行加密得到签名(返回的sign不参与签名),通过合作方与异步通知的sign对比,来验证此通知是否是联拓富平台发给合作方的通知,防止合作方获取到虚假的异步通知。</code></pre>
<p><br/></p>
<h4>异步通知参数<img src='https://www.showdoc.cc/server/api/common/visitfile/sign/bfc24f8d7eb93fae8e66d4ab2b4bc461?showdoc=.jpg' align='right' style=' width:300px;height:100 px'/></h4>
<table>
<thead>
<tr>
<th><strong>NO</strong></th>
<th><strong>字段</strong></th>
<th><strong>名称</strong></th>
<th><strong>长度</strong></th>
<th><strong>必填</strong></th>
<th><strong>示例</strong></th>
<th><strong>说明</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td>1</td>
<td>code</td>
<td>结果</td>
<td>string</td>
<td>Y</td>
<td>SUCCESS</td>
<td>交易结果 SUCCESS:表示成功 FAILED:表示失败</td>
</tr>
<tr>
<td>2</td>
<td>msg</td>
<td>结果描述</td>
<td>string</td>
<td>Y</td>
<td>成功</td>
<td>无论是成功或者失败,message都会针对于当前的结果返回响应的结果描述</td>
</tr>
<tr>
<td>3</td>
<td>subCode</td>
<td>错误代码</td>
<td>string</td>
<td>N</td>
<td>LOGIN_ERROR</td>
<td>如果code为FAILED,subcode会返回详细的错误code,以便错误信息描述的更加精确</td>
</tr>
<tr>
<td>4</td>
<td>subMsg</td>
<td>错误描述</td>
<td>string</td>
<td>N</td>
<td>EW_N2320993253</td>
<td>如果code为FAILED,subMsg会返回详细的错误描述,以便错误信息描述的更加精确</td>
</tr>
<tr>
<td>5</td>
<td>sign</td>
<td>签名。具体参见“<a href="https://www.showdoc.cc/web/#/liantuofu?page_id=673453270295568">签名规则</a>”</td>
<td>string</td>
<td>N</td>
<td>1b70687c8a4c72f50c749baf95a482c0</td>
<td>见<a href="https://www.showdoc.cc/web/#/liantuofu?page_id=673453270295568" title="签名规则">签名规则</a></td>
</tr>
<tr>
<td>6</td>
<td>merchantCode</td>
<td>门店编码</td>
<td>string</td>
<td>N</td>
<td>123</td>
<td>门店编码</td>
</tr>
<tr>
<td>7</td>
<td>random</td>
<td>随机数</td>
<td>string</td>
<td>N</td>
<td>123</td>
<td>请求时传递的随机数</td>
</tr>
<tr>
<td>8</td>
<td>outTradeNo</td>
<td>商户订单号</td>
<td>string</td>
<td>N</td>
<td>CS100082018050166666</td>
<td>由商户生成的该笔交易的全局唯一ID,商户需确保其唯一性,重新发起一笔支付要使用原订单号,避免重复支付。后续可通过该ID查询对应订单信息。 建议值:公司简称+门店编号+时间戳+序列 支持8-64位数字、英文字母、“-”及“_”,其他字符不支持</td>
</tr>
<tr>
<td>9</td>
<td>outTransactionId</td>
<td>第三方商户订单号</td>
<td>string</td>
<td>N</td>
<td>1217752501201407033233368018</td>
<td><strong>该订单号与支付宝、微信支付客户端账单详情显示的商户订单号一致,通过该订单后可发起扫码退款或在支付宝、微信端查询交易。</strong></td>
</tr>
<tr>
<td>10</td>
<td>transactionId</td>
<td>第三方交易号</td>
<td>string</td>
<td>N</td>
<td></td>
<td>第三方内部流水号,需要退款或者对订单有疑问时,方便找第三方排查</td>
</tr>
<tr>
<td>11</td>
<td>pushType</td>
<td>支付类型</td>
<td>string</td>
<td>N</td>
<td>RECHARGE</td>
<td>RECHARGE:充值通知,PAYINFO支付通知</td>
</tr>
<tr>
<td>12</td>
<td>payType</td>
<td>支付类型</td>
<td>string</td>
<td>N</td>
<td>WXPAY</td>
<td>支付类型 WXPAY:微信支付 ALIPAY:支付宝支付 MPAY:会员支付</td>
</tr>
<tr>
<td>13</td>
<td>totalAmount</td>
<td>订单总金额</td>
<td>double</td>
<td>N</td>
<td>88.88</td>
<td>单位为元,精确到小数点后两位,取值范围[0.01至100000000]</td>
</tr>
<tr>
<td>14</td>
<td>receiptAmount</td>
<td>实收金额</td>
<td>double</td>
<td>N</td>
<td>66.66</td>
<td>单位为元,精确到小数点后两位,取值范围[0.01至100000000</td>
</tr>
<tr>
<td>15</td>
<td>discountAmount</td>
<td>优惠金额</td>
<td>double</td>
<td>N</td>
<td>22.22</td>
<td>单位为元,精确到小数点后两位,取值范围[0.01至100000000</td>
</tr>
<tr>
<td>16</td>
<td>payTime</td>
<td>交易完成时间</td>
<td>string</td>
<td>N</td>
<td>20181214100006</td>
<td>交易完成时间,格式为 yyyyMMddHHmmss</td>
</tr>
<tr>
<td>17</td>
<td>feeAmount</td>
<td>第三方交易手续费(用于计算商户真实到账金额)</td>
<td>double</td>
<td>N</td>
<td>0.0</td>
<td>第三方交易手续费(用于计算商户真实到账金额)</td>
</tr>
<tr>
<td>18</td>
<td>buyerId</td>
<td>第三方用户标识(微信支付openid,支付宝支付userid)</td>
<td>string</td>
<td>N</td>
<td></td>
<td>第三方用户标识(微信支付openid,支付宝支付userid)</td>
</tr>
<tr>
<td>19</td>
<td>settleAmount</td>
<td>第三方结算金额(商户真实到账金额)</td>
<td>double</td>
<td>N</td>
<td>0.0</td>
<td>第三方交易手续费(用于计算商户真实到账金额)</td>
</tr>
<tr>
<td>20</td>
<td>memberPayRealAmount</td>
<td>会员实充消费金额(充值为实充金额)</td>
<td>double</td>
<td>N</td>
<td>22.22</td>
<td>会员实充消费金额(充值为实充金额)</td>
</tr>
<tr>
<td>21</td>
<td>memberPayGiveAmount</td>
<td>会员赠送消费金额(充值为赠送金额)</td>
<td>double</td>
<td>N</td>
<td>22.22</td>
<td>会员赠送消费金额(充值为赠送金额)</td>
</tr>
<tr>
<td>22</td>
<td>unDiscountableAmount</td>
<td>不打折金额</td>
<td>double</td>
<td>N</td>
<td>22.22</td>
<td>不打折金额</td>
</tr>
<tr>
<td>23</td>
<td>orderRemark</td>
<td>订单备注</td>
<td>string</td>
<td>N</td>
<td>订单备注</td>
<td>1111111111</td>
</tr>
<tr>
<td>24</td>
<td>memberPayOrderNo</td>
<td>会员支付订单号(充值并支付的订单返)</td>
<td>string</td>
<td>N</td>
<td>会员支付订单号(充值并支付的订单返)</td>
<td>1111111111</td>
</tr>
<tr>
<td>25</td>
<td>memberPayOrderStatus</td>
<td>交易状态(充值并支付的订单返)</td>
<td>string</td>
<td>N</td>
<td>交易状态 NOTPAY未支付 SUCCESS支付成功 REFUND转入退款 CLOSED已关闭 REVOKED已撤销(充值并支付的订单返)</td>
<td>NOTPAY</td>
</tr>
<tr>
<td>26</td>
<td>memberPayAmount</td>
<td>会员支付金额(充值并支付的订单返)</td>
<td>double</td>
<td>N</td>
<td>会员支付金额(充值并支付的订单返)</td>
<td>1</td>
</tr>
<tr>
<td>27</td>
<td>memberPayDiscountAmount</td>
<td>会员支付优惠金额(充值并支付的订单返)</td>
<td>string</td>
<td>N</td>
<td>会员支付优惠金额</td>
<td>1</td>
</tr>
<tr>
<td>28</td>
<td>memberPayReceiptAmount</td>
<td>会员支付实收金额(充值并支付的订单返)</td>
<td>string</td>
<td>N</td>
<td>会员支付实收金额</td>
<td>100</td>
</tr>
<tr>
<td>29</td>
<td>memberPayTime</td>
<td>会员交易完成时间(充值并支付的订单返)</td>
<td>string</td>
<td>N</td>
<td>格式为 yyyyMMddHHmmss</td>
<td>20180719144533</td>
</tr>
<tr>
<td>30</td>
<td>orderActivitys</td>
<td>订单优惠活动</td>
<td>array</td>
<td>N</td>
<td></td>
<td>订单优惠活动</td>
</tr>
<tr>
<td>31</td>
<td>orderCoupons</td>
<td>订单优惠券</td>
<td>array</td>
<td>N</td>
<td></td>
<td>订单优惠券</td>
</tr>
</tbody>
</table>
<hr />
<h4>orderActivitys</h4>
<table>
<thead>
<tr>
<th><strong>NO</strong></th>
<th><strong>字段</strong></th>
<th><strong>名称</strong></th>
<th><strong>长度</strong></th>
<th><strong>必填</strong></th>
<th><strong>示例</strong></th>
<th><strong>说明</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td>1</td>
<td>orderNo</td>
<td>订单编号</td>
<td>string</td>
<td>N</td>
<td></td>
<td>订单编号</td>
</tr>
<tr>
<td>2</td>
<td>activityId</td>
<td>活动id</td>
<td>string</td>
<td>N</td>
<td></td>
<td>活动id</td>
</tr>
<tr>
<td>3</td>
<td>activityName</td>
<td>活动名称</td>
<td>string</td>
<td>N</td>
<td></td>
<td>活动名称</td>
</tr>
<tr>
<td>4</td>
<td>activityChannel</td>
<td>优惠券来源</td>
<td>int</td>
<td>N</td>
<td>1</td>
<td>优惠券来源 0系统 1微信 2支付宝</td>
</tr>
<tr>
<td>5</td>
<td>activityType</td>
<td>活动类型</td>
<td>int</td>
<td>N</td>
<td></td>
<td>活动类型 7折扣 8满减</td>
</tr>
<tr>
<td>6</td>
<td>discountAmount</td>
<td>活动优惠金额</td>
<td>number</td>
<td>N</td>
<td></td>
<td>活动优惠金额</td>
</tr>
<tr>
<td>7</td>
<td>actualDiscountAmount</td>
<td>活动实际优惠金额</td>
<td>number</td>
<td>N</td>
<td></td>
<td>活动实际优惠金额</td>
</tr>
<tr>
<td>8</td>
<td>createTime</td>
<td>参与活动时间</td>
<td>string</td>
<td>N</td>
<td></td>
<td>参与活动时间</td>
</tr>
</tbody>
</table>
<hr />
<h4>orderCoupons</h4>
<table>
<thead>
<tr>
<th><strong>NO</strong></th>
<th><strong>字段</strong></th>
<th><strong>名称</strong></th>
<th><strong>长度</strong></th>
<th><strong>必填</strong></th>
<th><strong>示例</strong></th>
<th><strong>说明</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td>1</td>
<td>orderNo</td>
<td>订单编号</td>
<td>string</td>
<td>N</td>
<td></td>
<td>订单编号</td>
</tr>
<tr>
<td>2</td>
<td>couponNo</td>
<td>couponNo</td>
<td>string</td>
<td>N</td>
<td></td>
<td>couponNo</td>
</tr>
<tr>
<td>3</td>
<td>consumStatus</td>
<td>核销状态</td>
<td>int</td>
<td>N</td>
<td></td>
<td>核销状态 0未核销1已核销2核销失败</td>
</tr>
<tr>
<td>4</td>
<td>couponChannel</td>
<td>优惠券来源</td>
<td>int</td>
<td>N</td>
<td>1</td>
<td>优惠券来源 0系统 1微信 2支付宝</td>
</tr>
<tr>
<td>5</td>
<td>couponName</td>
<td>优惠券名称</td>
<td>string</td>
<td>N</td>
<td></td>
<td>优惠券名称</td>
</tr>
<tr>
<td>6</td>
<td>couponType</td>
<td>优惠券类型 * 系统</td>
<td>int</td>
<td>N</td>
<td></td>
<td>优惠券类型 <em> 系统:0代金券 1折扣券 2兑换券 3优惠券 4团购券 5单品代金券,7单品折扣 8单品特价券 9全场满减券 </em> 非系统:0全场 1单品</td>
</tr>
<tr>
<td>7</td>
<td>discountAmount</td>
<td>优惠券优惠金额</td>
<td>number</td>
<td>N</td>
<td></td>
<td>优惠券优惠金额</td>
</tr>
<tr>
<td>8</td>
<td>actualDiscountAmount</td>
<td>优惠券金额</td>
<td>number</td>
<td>N</td>
<td></td>
<td>优惠券金额</td>
</tr>
<tr>
<td>9</td>
<td>consumTime</td>
<td>核销时间</td>
<td>string</td>
<td>N</td>
<td></td>
<td>核销时间</td>
</tr>
</tbody>
</table>
<p><br/><br/></p>
<h5>异步通知示例:</h5>
<pre><code>sign=0009793cf46a7b5491dac2c2ea170795&settleAmount=0.01&transactionId=4200000223201812148170226400&feeAmount=0.0&totalAmount=0.01&payType=WXPAY&outTradeNo=EW_N4130797151_20181214000000003&receiptAmount=0.01&code=SUCCESS&outTransactionId=MYBKJHZF2018121409593712441861&payTime=20181214100006&discountAmount=0.0&orderStatus=SUCCESS&buyerId=oHucvv5B9spDQkd2-uMm4lNtLptE&msg=支付成功</code></pre>
<h5>异步通知返回示例(成功):</h5>
<pre><code>return "success";</code></pre>