开发前注意事项
<h1>一、支付接口注意事项</h1>
<p>相关接口 被扫接口 open/pay</p>
<h3>1支付必须要上传参数</h3>
<pre><code>注意事项：支付接口上传必填参数：orderSource：参数值和技术支持确认
目前可传值从76开始,新软件对接，请向运营申请对应的orderSource值；</code></pre>
<h3>2上传商品参数注意事项</h3>
<pre><code>1.商品计量单位 数量和重量二选一上传 不能两者都上传
2.数量不允许有小数
3.测试时 上传多个商品一起测试
4.上传商品名称需要字母和数字组合，带有特殊符号（！@#￥%&amp;*（）—+），
做过滤去掉特殊字符处理，否则签名失败。
5.和技术支持确认无误</code></pre>
<h3>3订单查询接口（重要必须接，防客户已支付软件不入账情况）</h3>
<pre><code> 相关接口 open/pay/query
①每一笔订单都需要订单查询接口做二次确认，尤其在网络、客户输入密码造成支付
订单状态不明确的时候，需要调用订单查询接口做二次确认，需循环调用此接口。
② 推荐 订单查询检测逻辑
可设置循环查询时间120秒
软件方自主可以设置订单查询前20秒，不可以取消查询
查询&lt;60次 前15次1秒1次，之后2秒1次
客户手动取消查询后，仍可以2秒1次继续查询，直到彻底取消或重新下单
客户可以随时手动对订单查询，检测到已支付，自动入账。（手动检测入账逻辑）
③异常支付订单保存、随时入账
调用查询接口未返回支付成功的订单，可保存异常订单
软件可以做手动调用订单查询接口，手动随时检测异常订单，查询到成功，
随时更新异常订单状态，入账。</code></pre>
<h3>4订单号规则</h3>
<pre><code> ①订单号、退款订单号全局唯一，故不能和任意一个商户的订单号重复
推荐支付订单号规则: 软件名+时间年月日分秒+款台号+门店ew编码+7位顺序号
比如六神软件：LX202312181007580001EW_N*****0000001
②订单号长度：控制40位以内</code></pre>
<h3>5软件记账</h3>
<p>相关接口</p>
<p>订单查询接口 /open/pay/query
交易金额 totalAmount：订单创建金额</p>
<p>优惠金额discountAmount：订单优惠金额</p>
<p>实收金额 receiptAmount ：实际收款金额</p>
<pre><code>①软件增加线上微信支付、线上支付宝支付、现金支付、会员卡支付、线上优惠等字段
来匹配对接接口后的在软件记账方式。
②线上促销或优惠券核销后，有优惠订单，要注意小票、交接班，后台报表上体现线上优惠的金额。
③软件记账后，在小票、交班、后台报表要体现这些支付方式的记账。
④对接会员后，小票要展示线上会员的余额、积分、优惠券等信息
⑤软件后台记账后，软件后台对应的订单要存写线上会员的手机号
⑥软件订单号和线上接口订单号可以存在关联，比如线下软件的订单号=线上订单号，
或线上订单号一部分包含线下软件订单号。</code></pre>
<h1>二、退款接口注意事项</h1>
<p>相关接口 退款接口open/refund/query</p>
<pre><code> ①有无优惠金额的退款，都退实收金额，有优惠的金额退款金额不能退订单金额。
②全部优惠的订单，即实收金额为0 不调用接口退款
③退款时候 要判断一下退款金额是否&lt;=实收金额，否则不能退款</code></pre>
<h1>三、报文规范</h1>
<h3>1：请求和返回报文标准遵循每一个接口对应示例的格式报文，请求报文采用普通的key1=value1&key2=value2...的报文格式，返回报文遵循标注的json格式（除了异步通知接口）。</h3>
<h3>2: 请求方法为post,格式为表单</h3>
<h3>3：返回的报文标准为json。</h3>
<h3>4：编码格式为UTF-8</h3>