WAP API PRO 收银台

对于具有一定开发能力的商户，可以通过对接Upay支付网关来支持WAP支付，让顾客可以直接在商户的网页上进行移动支付，从而拓展商户的线上业务渠道。

1. 业务场景

顾客在支付客户端（如微信）中访问商户的商城页面，选择商品后结账，触发支付控件（如点击支付按钮），支付客户端会弹出支付控件提示用户输入支付密码，用户输入密码后完成支付，商户页面提示交易进行中，在商户获取到支付结果后，在页面上展示支付结果和订单信息。

2. WAP接入须知

在对接WAP接口前，请联系收钱吧销售人员填写服务商入网申请资料和测试商户入网资料。入网资料中填写的微信相关参数必须与开发者使用的微信相关参数保持一致。

激活接口用于通过终端激活码（code）来获取终端号（terminal_sn）和终端密钥（terminal_key），以用于调用wap支付接口时的签名。激活接口对于同一台终端，只需要调用一次，调用wap支付之前需要先进行激活获取terminal_sn和terminal_key。激活接口调用方法就是web api对接接口里的激活接口。

网关地址

https://m.wosai.cn/qr/gateway

请求方式

GET

请求参数

页面同步跳转参数说明

商户的请求数据处理完成后，会将处理的结果通知给商户网站。这些处理结果数据就是页面跳转同步通知参数(当消费者付完款之后，会从付款界面跳转回return_url地址下，然后处理的数据也相应的同步到这个地址下)。

商户务必以查单或者服务器异步通知的订单结果为主作出正确的处理。return_url的结果仅供参考。查询订单请使用轮询方式获取为主，具体的轮询方式请使用web api接口里查询接口，轮询的时间控制在100-120s之间，轮询的间隔建议为前30秒内2秒一次，之后5秒一次

附录

支付方式

错误码

商户务必以查单或者服务器异步通知的订单结果为主作出正确的处理。return_url的结果仅供参考。查询订单请使用轮询方式获取为主，具体的轮询方式请使用web api接口里查询接口，轮询的时间控制在100-120s之间，轮询的间隔建议为前30秒内2秒一次，之后5秒一次

说明：一般除 get_brand_wcpay_request:ok 外皆认为支付失败，无需细分处理。

签名规则

1. 筛选 获取所有请求参数，不包括字节类型参数，如文件、字节流，剔除sign与sign_type参数。
2. 排序 将筛选的参数按照第一个字符的键值ASCII码递增排序（字母升序排序），如果遇到相同字符则按照第二个字符的键值ASCII码递增排序，以此类推。
3. 拼接 将排序后的参数与其对应值，组合成“参数=参数值”的格式，并且把这些参数用&字符连接起来，此时生成的字符串为待签名字符串。将key的值拼接在字符串后面，调用MD5算法生成sign。将sign转换成大写。

例：

     传入参数如下
     terminal_sn: "123"
     client_sn:"123"
     total_amount:"1"

     拼接参数字符串
     stringA="client_sn=123&terminal_sn=123&total_amount=1"
     拼接密钥
     stringSignTemp = "stringA&key=19b820737ace6937a7808c"
     md5生成sign
     sign = md5(stringSignTemp).toUpperCase()

注：

需要使用微信浏览器，使用302跳转的方式访问https://m.wosai.cn/qr/gateway 示例：

  <?php
    $paramsStr = "client_sn=test&operator=TEST&return_url=test&subject=TEST&terminal_sn=test&total_amount=3";
    $sign = strtoupper(md5($paramsStr.'&key=test'));
    $paramsStr = $paramsStr."&sign=".$sign;

    header("Location:https://m.wosai.cn/qr/gateway?".$paramsStr);
  ?>

wap支付接入常见问题

1.使用wap支付，需要在微信后台配置https://m.wosai.cn/qr/ 这个地址。具体配置流程：

1）登录微信公众号后台（https://mp.weixin.qq.com/)，点击左侧的微信支付，再点击开发配置，点击修改
2）进入之后，勾选“JS API网页支付”，填写相关信息：支付授权目录：https://m.wosai.cn/qr/
   共享收货地址选择“是”，告警通知URL开发者自己填写。