通用场景
会员卡开卡、用户授权确认
公共请求参数
业务请求参数
template_id｜会员卡模板id必选string[0,32]
【描述】会员卡模板id。调用alipay.marketing.card.template.create（会员卡模板创建接口）创建模板后同步返回。
【示例值】20170228000000000210102000300974
fields｜表单字段必选openformfielddo
【描述】会员卡开卡时的表单字段配置信息，即用户开卡时需填写内容。可定义多个通用表单字段，最大不超过20个。 注意：required必须填一个
required｜表单必填字段配置可选string[0,102400]
【描述】表单必填字段配置，common_fields属性定义一个表单字段数组，字段有效值如下列表所示：
open_form_field_mobile -- 手机号
open_form_field_gender -- 性别
open_form_field_name -- 姓名
open_form_field_birthday -- 生日
open_form_field_idcard -- 身份证
open_form_field_email -- 邮箱
open_form_field_address -- 地址
open_form_field_city -- 城市
open_form_field_is_student -- 是否学生认证
open_form_field_member_grade -- 会员等级
【示例值】{
"common_fields": [
"open_form_field_mobile"
]
}
optional｜表单可选字段配置可选string[0,102400]
【描述】表单可选字段配置，common_fields属性定义一个表单字段数组，表单字段有效值列表与required字段有效值列表相同。
可选字段配置中不能含有必须字段配置的有效值。
【示例值】{
"common_fields": [
"open_form_field_gender"
]
}
常见请求示例
推荐示例
默认示例
curl 'https://openapi.alipay.com/gateway.do?charset=utf-8&method=alipay.marketing.card.formtemplate.set&format=json&sign=${sign}&app_id=${appid}&version=1.0&sign_type=rsa2×tamp=${now}' \
-f 'biz_content={
"fields":{
"required":"{\n\n \"common_fields\": [\n\n \"open_form_field_mobile\"\n\n ]\n\n }"
},
"template_id":"20170228000000000210102000300974"
}' 说明：本示例仅供参考。
公共响应参数
业务响应参数
无业务响应参数
响应示例
正常示例
异常示例
{
"alipay_marketing_card_formtemplate_set_response": {
"code": "10000",
"msg": "success"
},
"sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}说明：本示例仅供参考。
公共错误码
业务错误码
| 错误码 | 错误描述 | 凯发app官方网站的解决方案 |
|---|---|---|
| system_error | 系统繁忙 | 服务器异常 可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试 |
| invalid_parameter | 参数有误 | 请根据接口返回的参数非法的具体错误信息，修改参数后进行重试 |
| card_template_not_exist | 会员卡模板不存在 | 请检查template_id参数的有效性 |
| duplicate_birthday_field | 不可同时配置两种类型的生日字段 | 不可同时配置两种类型的生日字段，请选择open_form_field_birthday和open_form_field_birthday_with_year之一 |
| duplicate_cert_no | 不可同时配置证件号和身份证号字段 | 不可同时配置证件号(open_form_field_cert_no)和身份证号(open_form_field_idcard)字段，请检查配置参数. |
| duplicate_form_field | 表单字段重复配置 | 请检查必填字段与可选字段是否配置了相同的表单字段名称 |
| form_field_invalid | 表单字段无效 | 请检查入参通用表单列表值的有效性 |
| illegal_null_argument | 有必填参数为空 | 请确认必填参数不为空 |
| invalid_cert_type_and_no | 证件类型和证件号两个字段需同时配置 | 证件类型(open_form_field_cert_type)和证件号(open_form_field_cert_no)需同时配置，请检查配置参数。 |
| open_form_set_fail | 表单配置失败 | 请稍后重试 |