通用场景
用于生成线下推广二维码
公共请求参数
业务请求参数
merchandise_id｜服务id必选string[20,100]
【描述】服务id，该字段由调用方传入，是生成线下推广二维码的必要参数，该值是支付宝生成，可以在支付宝p站我的服务中查询对应的服务id
【注意事项】必须是marketcode为线下推广且已上架的服务。
【示例值】op010301000000378910
ticket｜标识符必选string[1,1000]
【描述】用于扩展信息，该值可以传入服务商想要扩展的信息，将会与其它参数一起存入码值信息中。
【注意事项】不可以是"标识符"，这种无效参数，该字段是调用方传入，用于扩展信息
【示例值】merchid=8168000000140644&scene=offline&tempid=am010301000000062709
callback｜回调地址必选string[0,1000]
【描述】商家回调地址，该字段是商家扫码后，跳转的地址url，比如商品详情页的url
【注意事项】该字段是商家扫码后，跳转的地址url，比如商品详情页的url
【示例值】https://security.91isv.cn/assembly/alipay/auth
app_name｜小程序名称必选string[0,100]
【描述】小程序名称，该字段非必传字段，用于表示此次参与交易的小程序具体是什么
【注意事项】该字段非必传字段，用于表示此次参与交易的小程序具体是什么
【示例值】*****门店
常见请求示例
默认示例
alipayclient alipayclient = new defaultalipayclient("https://openapi.alipay.com/gateway.do","app_id","your private_key","json","gbk","alipay_public_key","rsa2");
alipayopenservicemarketqrcodeofflinegetrequest request = new alipayopenservicemarketqrcodeofflinegetrequest();
request.setbizcontent("{"
" \"merchandise_id\":\"op010301000000378910\","
" \"ticket\":\"merchid=8168000000140644&scene=offline&tempid=am010301000000062709\","
" \"callback\":\"https://security.91isv.cn/assembly/alipay/auth\","
" \"app_name\":\"*****门店\""
"}");
alipayopenservicemarketqrcodeofflinegetresponse response = alipayclient.execute(request);
if(response.issuccess()){
system.out.println("调用成功");
} else {
system.out.println("调用失败");
}说明：本示例仅供参考。
公共响应参数
业务响应参数
qr_code_url｜二维码地址必选string(1000)
【描述】生成二维码后的url，该字段是调用当前api生成返回的二维码的url，用于服务商线下推广使用
【注意事项】该字段是调用当前api生成返回的二维码的url，用于服务商线下推广使用
【示例值】https://b.alipay.com/page/fw-portal/itemqrcodetoisv?marketcode=offline_promotion&merchandiseid=op010301000000378910&ticket=merchid=8168000000140644&scene=offline&tempid=am010301000000062709&callback=https://security.91isv.cn/assembly/alipay/auth&appname=****门店
url｜原始链接必选string(1000)
【描述】生成二维码前的url，该字段是将merchandise_id、ticket、callback、app_name这几个字段简单拼接后的url，用于服务商校验参数使用
【注意事项】该字段是将merchandise_id、ticket、callback、app_name这几个字段简单拼接后的url，用于服务商校验参数使用
【示例值】https://b.alipay.com/page/fw-portal/itemqrcodetoisv?marketcode=offline_promotion&merchandiseid=am010301000000008448&ticket=标识符&callback=商家授权完成以后跳转地址&appname=小程序名称
title｜标题必选string(100)
【描述】服务标题，该字段是当前服务的标题，用于前端展示
【注意事项】该字段是当前服务的标题，用于前端展示
【示例值】**品牌**小程序
logo｜logo必选string(1000)
【描述】服务logo，该字段是服务的logo，用于前端展示
【注意事项】该字段是服务的logo，用于前端展示
【示例值】https://appstoreisvpic.alipayobjects.com/prod/4f27d3aa-7635-44d5-8914-16a718b70383.png
sub_title｜副标题可选string(100)
【描述】副标题，该字段是当前服务的副标题，不一定有，用于前端展示
【注意事项】该字段是当前服务的副标题，不一定有，用于前端展示
【示例值】**小程序
响应示例
正常示例
异常示例
{
"alipay_open_servicemarket_qrcode_offline_get_response": {
"code": "10000",
"msg": "success",
"qr_code_url": "https://b.alipay.com/page/fw-portal/itemqrcodetoisv?marketcode=offline_promotion&merchandiseid=op010301000000378910&ticket=merchid=8168000000140644&scene=offline&tempid=am010301000000062709&callback=https://security.91isv.cn/assembly/alipay/auth&appname=****门店",
"url": "https://b.alipay.com/page/fw-portal/itemqrcodetoisv?marketcode=offline_promotion&merchandiseid=am010301000000008448&ticket=标识符&callback=商家授权完成以后跳转地址&appname=小程序名称",
"title": "**品牌**小程序",
"sub_title": "**小程序",
"logo": "https://appstoreisvpic.alipayobjects.com/prod/4f27d3aa-7635-44d5-8914-16a718b70383.png"
},
"sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}说明：本示例仅供参考。
公共错误码
业务错误码
| 错误码 | 错误描述 | 凯发app官方网站的解决方案 |
|---|---|---|
| system_error | 系统繁忙 | 服务器异常 可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试 |
| invalid_parameter | 参数有误 | 请根据接口返回的参数非法的具体错误信息，修改参数后进行重试 |
| attr_miss_callback | 属性callback缺失 | 属性callback缺失，检查补充后重新提交 |
| attr_miss_merchandiseid | 属性merchandiseid缺失 | 属性merchandiseid缺失，检查补充后重新提交 |
| attr_miss_ticket | 属性ticket缺失或无效 | 属性ticket缺失或无效，检查补充后重新提交 |
| callback_scan_fail | 回调地址callback安全扫描不通过,请检查是否含有敏感词汇 | 回调地址callback安全扫描不通过,请检查是否含有敏感词汇,检查补充后重新提交 |
| illegal_parameter_merchandiseid | 当前服务不存在,请填写正确的merchandiseid | 当前服务不存在,请填写正确的merchandiseid,检查补充后重新提交 |
| not_offline_promotion | 服务必须是线下模板推广市场已上架的商品 | 服务必须是线下模板推广市场已上架的商品，请检查服务是否属于线下推广或是否已上架 |
| no_permission_operate | 无权限操作,不属于当前账户的应用无法生成推广二维码 | 不属于当前账户的应用无法生成推广二维码,请输入正确的merchandiseid,检查补充后重新提交 |