3.5.15 ISV收银台


根据传入的shopId返回跳转到智慧小店ISV收银台或者智慧门店ISV收银台的地址,再由对接方跳转到该地址

如果对接方为通惠,则shopId为通惠关联的智慧小店或者智慧门店的店铺

如果对接方为智慧门店,则shopId为机构自身的店铺或者子机构的店铺

该接口不支持阶梯分账(可正常收款,但不执行阶梯分账规则)。

method: allinpay.shopoint.orderService.isvCheckout  

version: 1.0

业务请求参数

字段名

参数类型

必填

最大长度

说明

取值

oid

String

25

对接方系统订单号

无论是否完成支付或者支付成功与否,均不能重复上送

shopId

Integer

11

数字营销平台的店铺Id

· 对接方为智慧门店时,与shopId必传其中之一

· 对接方为通惠时,必传

 

店铺下至少拥有一个码牌

shopCode

String

20

数字营销平台智慧门店机构的店铺编号

· 对接方为智慧门店时,与shopId必传其中之一

其中,对接方为智慧门店集团时,shopCode需要在集团范围内唯一

· 对接方为通惠时,该参数无效

 

店铺下至少拥有一个码牌

amt

Integer

14

订单金额

单位:分,正数

returnUrl

String

200

支付成功时前端跳转地址

 

authToken

String

60

调用接口3.1.6联合登录时返回的token

 

payMethods

String

100

指定支付方式

格式为:

default,银行id1,银行id2

 

对接方为通惠时,有效值为

不传(默认为default和对接方机构及起子机构)

default

default,指定的对接方机构及其子机构

指定的对接方机构及其子机构

 

参数说明:

不传该参数,则显示用户app(微信/支付宝)支付方式,以及有可用活动时的快捷支付方式

 

只传default,则只根据用户app(微信/支付宝)显示支付方式,无论是否有银行活动,均不出现任何快捷支付方式

 

只指定了银行id,则无论有没有银行活动,均出现该银行的快捷支付方式,且无论是否有活动均不出现未指定银行的快捷支付方式

 

传入default和银行id,则显示用户app(微信/支付宝)支付方式,以及指定银行的快捷支付方式

qrCode

String

20

码牌号

需与上送店铺关联

cusid

 

String

40

收银宝商户号

shopId为智慧小店的店铺时有效。需与上送店铺关联。

splitList

JSONArray

1024

分账信息

参照附录7.2splitList字段说明

remark

String

160

备注

最大160个字节(80个中文字符)。

禁止出现+,空格,/,?,%,#,&,=这几类特殊符号

trxType

Integer

11

交易类型

3001

账单收款

3006

点餐消费

3007

餐饮外卖消费

3008

非餐饮外卖消费

3010

商城消费

pageTitle

String

20

页面标题

 

remark

String

160

备注

 

业务响应参数

字段名

参数类型

必填

最大长度

说明

取值

code

Integer

 

返回码

0:表示成功;

3:表示失败,具体失败原因参见msg字段;

其他:参见4.1 公共返回码

msg

String

 

错误信息

 

data

isvUrl

String

 

跳转地址

 

 

请求示例

{

    "oid": "1236158361962",

    "amt": 100,

    "shopId": 12,

    "notfiyUrl": "https://www.baidu.com",

    "returnUrl": "https://www.baidu.com",

}

 

响应示例

{

    "code": 0,

    "data": {

        "isvUrl": "https://dms.shopoint.cn/..."

    },

    "token": "DlRXdIjEBLRLCJgwTP37sZW6ls--NflxVS2-KUHl"

}

 

 

该接口属于页面跳转。支付成功后,ISV收银台页面跳转回ISV调用方

跳转目的地址为:3.5.15 ISV收银台接口 中传入的returnUrl参数

业务请求参数

method: allinpay.shopoint.orderService.isvReturn

字段名

参数类型

必填

最大长度

说明

取值

reqTransCode

String

 

ISV订单号

 

amount

Integer

是  

 

订单原始金额

单位:分


卜子超buzc 2025年5月14日 17:41 收藏文档