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字段说明

trxType

Integer

否

11

交易类型

3001

账单收款

3006

点餐消费

3007

餐饮外卖消费

3008

非餐饮外卖消费

3010

商城消费

pageTitle

String

否

20

页面标题

 

remark

String

否

160

备注

 

inAccountFlag

String

否

2

入金账户标识

0-余额户

1-储值卡专用户

receiverShopId

Integer

否

11

收款人店铺ID

只有开通资金管理功能的机构生效

业务响应参数

字段名

参数类型

必填

最大长度

说明

取值

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

是  

 

订单原始金额

单位:分


2025年11月19日 14:44 收藏文档