2.1渠道能力服务

H5获取微信OPENID

接口地址
生产环境：https://cus.allinpay.com/cusapi/wxopen/getopenid

使用场景：
用于商户在前端网页通过微信授权方式获取通联的公众号openid
处理流程
第一步开发者按照对接规范重定向通联获取openid页面，需要带上开发者重定向redirecturl
第二步通联验证签名有效性，跳往微信授权页面进行用户授权，用户授权完成后微信回调到通联
第三步通联根据微信授权回调的code获取openid，并根据第一步的redirecturl重定向商户页面，带上openid参数
第四步开发者根据对接规范验证签名并且获取openid

url参数：

参数	参数名称	取值	可空	最大长度	备注
appid	应用ID	平台分配的机构APPID	否	8
apptype	公众号类型	01：微信公众号	否	2	暂只支持01
redirecturl	重定向url	需要做urlencode	否	128
state	开发者自定义		否	128	重定向后会带上state参数，开发者可以填写a-zA-Z0-9的参数值，最多128字节
signtype	签名类型		否	8	RSA SM2
sign	签名	详见安全规范	否	32

重定向参数：

参数	参数名称	取值	可空	最大长度	备注
appid	应用ID	平台分配的机构APPID	否	8
openid	微信openid		否	128
state	开发者自定义		否	128	重定向后会带上state参数，开发者可以填写a-zA-Z0-9的参数值，最多128字节
sign	签名	详见安全规范	否	32

示例：
appid = "00000005";
key = "123456";
apptype = "01";
redirecturl="https://test.allinpaygd.com/JWeb/recopenid.jsp";
state = "32510000201970036";
重定向通联url:
https://test.allinpaygd.com/cuswap/wxopen/getopenid.wx?appid=00000005&apptype=01&redirecturl=https://test.allinpaygd.com/JWeb/recopenid.jsp&state=32510000201970036&sign=2A998C484E49EE6A603FB4E1373B5210
使用微信扫一扫下方二维码体验：

微信发放代金券API

接口地址

生产环境：https://cus.allinpay.com/cusapi/sybserviceapi/sendcoupons

测试环境：https://syb-test.allinpay.com/vsppcusapi/sybserviceapi/sendcoupons

使用场景：

一、使用通联appid发券：
1、在“商户服务平台-设置”中，配置收银宝对接参数；
2、根据运营提供的线下流程，申请创建微信券并获取相应的批次id
3、通过收银宝发的交易结果中的 ”acct“或调用”H5获取微信OPENID“接口获取收银宝appid对应的openid
4、调用该api实现向指定用户发券

注意：
1、当前该接口只支持公众号发券，app不支持。
2、该类型券不支持插入卡包，如果需要插入卡包则自行开发微信卡包相关接口

请求参数：

参数	参数名称	取值	可空	最大长度	备注
cusid	收银宝商户号	收银宝商户号	否	15
appid	应用ID	平台分配的机构APPID	否	8
version	版本号	接口版本号	可	2	默认填11
randomstr	随机字符串	商户自行生成的随机字符串	否	32
stockid	代金券批次id	示例值：9856000	否	20	微信为每个批次分配的唯一id
openid	用户openid	示例值：2323dfsdf342342	否	128	openid信息，用户在appid下的唯一标识。
couponvalue	指定面额发券，面额	示例值：100	是	20	指定面额发券场景，券面额，其他场景不需要填，单位：分。
couponminimum	指定面额发券，券门槛	示例值：100	是	20	指定面额发券批次门槛，其他场景不需要，单位：分
signtype	签名类型		否	8	RSA SM2
sign	签名	详见安全规范	否	32

响应参数：

字段ID	字段名称	取值	可空	最大长度	备注
retcode	返回码	SUCCESS/FAIL	否	8	此字段是通信标识，非交易结果
retmsg	返回码说明		是	100
以下信息只有当retcode为SUCCESS时有返回
status	操作状态	00 /01	否	2	00：操作成功 01:操作失败
errmsg	错误信息		是	100
randomstr	随机字符串	随机生成的字符串	否	32
sign	签名		否	32	详见安全规范

微信点餐同步

生产环境：https://cus.allinpay.com/cusapi/sybserviceapi/wxcateringorderssyncstatus
测试环境：https://syb-test.allinpay.com/vsppcusapi/sybserviceapi/wxcateringorderssyncstatus

使用场景：
当点餐订单状态发生变化时，都上传全量的订单明细。

1、用户在扫码点餐小程序/h5页面中下单时，上报用户的下单信息，此时status为CREATE_DEAL

2、确定支付成功后上报用户的支付信息，此时status为PAY_SUCCESS

请求参数：

参数	参数名称	取值	可空	最大长度	备注
cusid	机构号	平台分配的机构商户号	否	15
appid	应用ID	平台分配的机构APPID	否	8
version	版本号	接口版本号	可	2	默认填11
randomstr	随机字符串	商户自行生成的随机字符串	否	32
signtypei	签名类型		否	4	RSA/SM2
sign	签名	详见1.5	否	32
sub_appid	子商户在微信公众平台申请服务号对应的APPID		否	32
outshopno	商户旗下门店的唯一编号		否	32
subopenid	用户子标识，用户在子商户appid下的openid		否	32
logintoken	微信用户登录接口返回的登录票据		否	256	公众号，填写页面授权access_token，详细参考；小程序，填写session_key
orderentry	点餐入口		否	256	点餐入口
totalamount	总价，单位为分, 数字类型		否
discountamount	优惠金额，单位为分, 数字类型		否
useramount	实际支付金额，单位为分, 数字类型		否
status	订单状态，取值如下： CREATE_DEAL—用户下单； PAY_SUCCESS—支付完成，结账成功；		否	32
actiontime	状态发生变化的时间，格式为yyyymmddhhmmss		否	64
paytime	支付时间，格式 yyyymmddhhmmss status为PAY_SUCCESS时必填）		可	64
chnltrxid	渠道平台交易单号（status为PAY_SUCCESS时必填）		可	64
trxid	收银宝平台的交易流水号（status为PAY_SUCCESS时必填）		可	64
reqsn	商户的交易订单号		否	64
dishlist	dish_list对象列表		否
outtableno	桌位号		可	16
peoplecount	消费人数, 数字类型		可

dish_list

参数	参数名称	可空	最大长度
out_dish_no	商户菜品ID	否	48
name	菜品名称	否	32
price	菜品单价，单位为分
unit	菜品单位，BY_SHARE-按份 BY_WEIGHT-按重量
count	菜品数量，保留小数点后2位有效数字

响应参数：

字段ID	字段名称	取值	可空	最大长度	备注
retcode	返回码	SUCCESS/FAIL	否	8	此字段是通信标识，非交易结果
retmsg	返回码说明		是	100
trxstatus	状态码	1000 \| 1001	是	4	1000：获取结果成功 1999 ：获取失败
以下信息只有当retcode为SUCCESS时有返回
status	操作状态	00 /01	否	2	00 操作成功 01 操作失败
errmsg	错误信息		是	100
randomstr	随机字符串	随机生成的字符串	否	32
sign	签名		否	32	详见安全规范

上传微信电子小票

接口地址

生产环境：https://cus.allinpay.com/cusapi/sybserviceapi/uploadelectticket

测试环境：https://syb-test.allinpay.com/vsppcusapi/sybserviceapi/uploadelectticket

使用场景：

上传微信电子小票

面向调用角色：代理商，服务商，普通商户

请求参数：

参数	参数名称	取值	可空	最大长度	备注
appid	应用ID		否	8	平台分配的机构APPID
orgid	平台机构号				集团商户，代理商必填
cusid	平台商户号		否	15	必填
version	版本号	接口版本号	可	2	默认填11
randomstr	随机字符串	商户自行生成的随机字符串	否	32
sign	签名	详见签名规范	否	32
signtype	签名类型		否	4	SM2、RSA
trxid	交易单号		否
chnltrxid	渠道交易单号		否	64
cmid	微信子商户号		否	32
openid	微信OPENID		否	64
merchantcontacts	用户与商家的联系渠道				json对象 consultation_phone_number商户售后咨询电话
file	图片文件流		否		图片文件不超过200k 图片文件。将图片文件以二进制方式读取后，电子小票图片只支持PNG、JPG格式

响应参数：

字段ID		字段名称	取值	可空		最大长度			备注
retcode		返回码	SUCCESS/FAIL	否		8			此字段是通信标识，非交易结果
retmsg		返回码说明		是		100
以下信息只有当retcode为SUCCESS时有返回
randomstr	随机字符串				随机生成的字符串		否	32
sign	签名						否	32		详见签名规范

2.1渠道能力服务

目录

H5获取微信OPENID

微信发放代金券API

微信点餐同步

上传微信电子小票