根据传入的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 |
是 |
|
订单原始金额 |
单位:分 |