3.16ISV收银台


接口地址: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,不能携带参数。
https只支持默认端口

256

若使用https,需使用默认443端口

front_url

支付完成跳转

必须为https协议地址,且不允许带参数

128

只支持payType=U02云闪付JS支付
payType=W02微信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

详见安全规范


卜子超buzc 2025年5月14日 16:06 收藏文档