接口地址:https://dms-api.shopoint.cn/shopoint-openapis-web/szyx/apiweb/isv/checkout
测试地址:https://dms-api-test.shopoint.cn/shopoint-openapis-web/szyx/apiweb/isv/checkout
使用场景:根据传入的cusid返回跳转到智慧门店ISV收银台的地址,再由对接方跳转到该地址。
该接口不支持阶梯分账(可正常收款,但不执行阶梯分账规则)。
请求参数
参数 |
参数名称 |
取值 |
可空 |
最大长度 |
备注 |
|
appid |
应用ID |
平台分配的APPID |
否 |
20 |
|
|
orgid |
机构ID |
实际交易的机构ID |
是 |
11 |
服务商appid调用时必填 |
|
cusid |
商户号 |
实际交易的店铺ID |
否 |
11 |
店铺下至少拥有一个码牌 |
|
version |
版本号 |
接口版本号 |
可 |
2 |
默认填11 |
|
trxamt |
交易金额 |
单位为分 |
否 |
15 |
|
|
reqsn |
商户交易单号 |
商户的交易订单号 |
否 |
25 |
无论是否完成支付或者支付成功与否,均不能重复上送 |
|
randomstr |
随机字符串 |
商户自行生成的随机字符串 |
否 |
32 |
|
|
remark |
备注 |
备注信息 |
是 |
160 |
最大160个字节(160个中文字符) |
|
notify_url |
交易结果通知地址 |
接收交易结果的通知回调地址,通知url必须为直接可访问的url,不能携带参数。 |
否 |
256 |
若使用https,需使用默认443端口 |
|
front_url |
支付完成跳转 |
必须为https协议地址,且不允许带参数 |
否 |
128 |
只支持payType=U02云闪付JS支付 |
|
membertype |
会员账户类型 |
1-手机号 2-会员卡号 3-Openid 4-会员动态码 5-外部会员ID 6-内部会员ID |
是 |
2 |
不传的时候,只能在微信浏览器或者支付宝浏览器进入收银台 如果是APP或者微信小程序接入收银台,必传 |
|
memberid |
会员账号 |
|
是 |
180 |
不传的时候,只能在微信浏览器或者支付宝浏览器进入收银台 如果是APP或者微信小程序接入收银台,必传 |
|
asinfo |
分账信息 |
上送分账信息,json字符串 |
是 |
1024 |
参照附录4.7asinfo字段说明 |
|
qrcode |
码牌号 |
需要与上送的cusid关联 |
是 |
20 |
|
|
trx_type |
交易类型 |
3001 |
账单收款 |
是 |
11 |
|
3006 |
点餐消费 |
|||||
3007 |
餐饮外卖消费 |
|||||
3008 |
非餐饮外卖消费 |
|||||
3010 |
商城消费 |
|||||
page_title |
页面标题 |
|
是 |
20 |
|
|
signtype |
签名方式 |
|
是 |
8 |
支持MD5、RSA、SM2,不填默认MD5 |
|
sign |
签名 |
详见安全规范 |
否 |
32 |
|
响应参数
字段ID |
字段名称 |
取值 |
可空 |
最大长度 |
备注 |
retcode |
返回码 |
SUCCESS/FAIL |
否 |
8 |
|
retmsg |
返回码说明 |
|
是 |
100 |
|
以下信息只有当retcode为SUCCESS时有返回 |
|||||
cusid |
商户号 |
实际交易的店铺ID |
否 |
15 |
|
appid |
应用ID |
平台分配的APPID |
否 |
20 |
|
isvurl |
跳转地址 |
|
否 |
100 |
|
randomstr |
随机字符串 |
随机生成的字符串 |
否 |
32 |
|
errmsg |
错误原因 |
失败的原因说明 |
是 |
100 |
|
sign |
签名 |
|
否 |
32 |
详见安全规范 |