常见问题

如果您在调用 API 时出现报错：

欢迎前往开放社区提问、留言；
在公共错误码中根据错误码的类型，查找相关错误码及解决方案；
还可以在文档中心直接搜索您要的答案。

Q：如何判断目前接入的版本号及是否支持公域推广？

A：3.0版本、3.1版本（极速版）支持公域推广，可查看升级说明判断当前版本号、获取升级方案。

Q：修改卡模版信息后，已发放的卡实例信息会随之更新吗？

A：field_rule_list（字段规则列表）配置项不更新。其他修改项因为线上缓存的缘故，模板更新可能存在 1-5 分钟延时。

Q：会员卡详情页链接如何获得？

A：调用会员卡查询接口 alipay.marketing.card.query（会员卡查询），在响应参数 schema_url 中，即可获得跳转链接地址。

Q: 为什么创建会员卡模板"参数有误,门店数据有误"？

A: shopids 参数的门店 id 为商家 PID 下属的门店 id。如果不需要配置卡模板投放渠道参数 pub_channels 可将 shopids参数与 pub_channels 参数去掉。

Q: 支付宝商家平台的代金券可以从其他 APP 里领取添加到支付宝卡包吗？

A: 不可以，商家通过支付宝端创建的卡劵投放在支付宝卡包中，用户只能在支付宝卡包内进行领券。商家可以通过基础功能接入支付宝卡包的功能。

Q: 券出资方在支付宝客户端能不能看到优惠券实际抵扣情况？

A: 可以在支付宝客户端的账单中看到该笔订单中的优惠金额以及实际支付金额。

Q: 商家咨询代开通当面付 business_license_pic 是否必填？

A: 待开通的账户如果是个人账户是必填，企业账户则无需设置。

Q: 会员卡卡面上的会员等级，是我们在创建模板时候设置为初始等级吗？

A: 在创建会员卡模板的时候设置一个会员等级的集合，等开卡的时候设置其中的一个等级。参见基础功能中会员卡模板创建和会员卡开卡接口。

Q: write_off_type 参数设置卡包详情页面中展现出的卡码为必填参数，如果商家不需要卡码要如何处理呢？

A: 模板中的 write_off_type 参数值可以设置为 none，就不显示卡码了。

Q:商家会员卡的卡面背景图可以不同等级设置不同的背景图吗？

A: 商家会员卡的卡面背景暂时不可根据等级设置不同的背景图。参见基础功能的创建会员卡模板。

Q：创建会员卡模板报错” isv 权限不足“ 怎么办？

A：网页移动应用需要添加支付宝卡包和商家会员卡功能包。

Q：会员卡领取过是不是就不能再领了？

A：一个用户只能领取一张同一个会员卡模板的会员卡。

Q: 会员卡是否能授权同时开卡？

A: 不可以。需要先授权获取 code，然后调用接口获取 access_token，最后再调用开发接口开卡，参见获取会员信息获取用户授权的 access_token 的方法。

Q：用户在支付宝客户端打开会员卡领卡链接提示“系统异常，请联系商家（ERR007）”，如何处理？

A：开卡表单未指定信息字段所致，建议核实 fields 表单字段是否正常入参。调用 alipay.marketing.card.formtemplate.set（会员卡开卡表单模板配置接口）时，fields 的 required 字段必填。

使用云排查查询请求参数是否正确。

pageExecute 传入 get 调用，打印接口返回的请求 URL，使用 URL 编码解码工具查看请求参数，核实是否有传入表单字段参数，若未正常入参表单字段信息,可查看 alipay.marketing.card.formtemplate.set（会员卡开卡表单模板配置）文档进行配置。

Q：会员卡授权领卡页面报错 “系统异常，请联系商家(ERR005)”，如何处理？

A：开卡表单模板配置不存在，检查 alipay.marketing.card.formtemplate.set（会员卡开卡表单模板配置）是否设置 fields.required。fields.required：表单必填字段配置。更多可查看商家会员卡升级指南。

Q：会员卡授权领卡页面报错“系统异常，请联系商家（ERR010）”，如何处理？

**A：**开卡表单 callback 地址与应用配置的授权回调地址不一致，解决方案：

开卡表单 callback 地址与应用配置的授权回调地址设置一致。

如果接口有传 app_auth_token，相当于是 app_auth_token 对应的授权商家在作接口调用，callback 参数要设置成和授权商家的授权回调地址一样。

Q：如何判断目前接入的版本号及是否支持公域推广？#

Q：修改卡模版信息后，已发放的卡实例信息会随之更新吗？#

Q：会员卡详情页链接如何获得？#

Q: 为什么创建会员卡模板"参数有误,门店数据有误"？#

Q: 支付宝商家平台的代金券可以从其他 APP 里领取添加到支付宝卡包吗？#

Q: 券出资方在支付宝客户端能不能看到优惠券实际抵扣情况？#

Q: 商家咨询代开通当面付 business_license_pic 是否必填？#

Q: 会员卡卡面上的会员等级，是我们在创建模板时候设置为初始等级吗？#

Q: write_off_type 参数设置卡包详情页面中展现出的卡码为必填参数，如果商家不需要卡码要如何处理呢？#

Q:商家会员卡的卡面背景图可以不同等级设置不同的背景图吗？#

Q：创建会员卡模板报错” isv 权限不足“ 怎么办？#

Q：会员卡领取过是不是就不能再领了？#

Q: 会员卡是否能授权同时开卡？#

Q：用户在支付宝客户端打开会员卡领卡链接提示“系统异常，请联系商家（ERR007）”，如何处理？#

Q：会员卡授权领卡页面报错 “系统异常，请联系商家(ERR005)”，如何处理？#

Q：会员卡授权领卡页面报错“系统异常，请联系商家（ERR010）”，如何处理？#