通用场景
通过 api 接口删除商家会员卡。
公共请求参数
业务请求参数
out_serial_no｜商户端删卡业务流水号必选string[0,43]
【描述】商户端删卡业务流水号，商户自定义且需确保流水号唯一性。
【示例值】2016062700001
target_card_no｜支付宝业务卡号必选string[0,32]
【描述】支付宝业务卡号。即开卡接口返回结果中的card_info.biz_card_no。
【示例值】0000001
target_card_no_type｜卡号id类型必选string[0,32]
【描述】卡号id类型
【枚举值】
支付宝业务卡号: biz_card
【示例值】biz_card
reason_code｜删卡原因必选string[0,32]
【描述】删卡原因
user_unbund：用户解绑（可以重新绑定）
cancel：销户（完成销户后，就不能再重新绑定）
present：转赠（可以重新绑定）
【枚举值】
用户解绑: user_unbund
销户: cancel
转赠: present
【示例值】user_unbund
ext_info｜删卡扩展参数可选string[0,1024]
【描述】删卡扩展参数，json格式。
用于商户的特定业务信息的传递，只有商户与支付宝约定了传递此参数且约定了参数含义，此参数才有效。
目前支持如下key：
new_card_no：新卡号
donee_user_id：受赠人userid
【示例值】{"new_card_no":"12345"," donee_user_id":"2088102130652460"}
常见请求示例
默认示例
curl 'https://openapi.alipay.com/gateway.do?charset=utf-8&method=alipay.marketing.card.delete&format=json&sign=${sign}&app_id=${appid}&version=1.0&sign_type=rsa2×tamp=${now}' \
-f 'biz_content={
"out_serial_no":"2016062700001",
"reason_code":"user_unbund",
"target_card_no":"0000001",
"ext_info":"{\"new_card_no\":\"12345\",\" donee_user_id\":\"2088102130652460\"}",
"target_card_no_type":"biz_card"
}' 说明：本示例仅供参考。
公共响应参数
业务响应参数
biz_serial_no｜支付宝端删卡业务流水号可选string(32)
【描述】支付宝端删卡业务流水号
【示例值】2016062700001
响应示例
正常示例
异常示例
{
"alipay_marketing_card_delete_response": {
"biz_serial_no": "2016062700001"
}
}说明：本示例仅供参考。
公共错误码
业务错误码
| 错误码 | 错误描述 | 凯发app官方网站的解决方案 |
|---|---|---|
| system_error | 系统繁忙 | 服务器异常 可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试 |
| invalid_parameter | 参数有误 | 请根据接口返回的参数非法的具体错误信息，修改参数后进行重试 |
| card_is_deleted_already | 会员卡在此之前已被（用户主动）删除 | 在此调用之前已被删除，业务上可视作删除成功 |
| card_not_exit | 会员卡不存在 | 确认卡信息 |
| no_card_type | 卡类型不正确 | 确认是否创建模板 |