接口说明
接口英文名称：alipay.marketing.card.delete
请求url：https://openapi.alipay.com/v3/alipay/marketing/card/delete
请求方式：delete
path指该参数为路径参数
query指该参数需在请求url传参
body指该参数需在请求json传参
通用场景
通过 api 接口删除商家会员卡。
公共请求参数
业务请求参数
query参数
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 -x delete \
"https://openapi.alipay.com/v3/alipay/marketing/card/delete?out_serial_no=2016062700001&target_card_no=0000001&target_card_no_type=biz_card&reason_code=user_unbund&ext_info={"new_card_no":"12345"," donee_user_id":"2088102130652460"}" \
-h "authorization: alipay-sha256withrsa app_id=${appid},timestamp=${now},nonce=${uuid},expired_seconds=600,sign=${sign}" \
-h "alipay-request-id: ${requestid}" \
-h "content-type: application/json" \
-d '{}'
说明：本示例仅供参考。
公共响应参数
业务响应参数
biz_serial_no｜支付宝端删卡业务流水号可选string(32)
【描述】支付宝端删卡业务流水号
【示例值】2016062700001
响应示例
正常示例
异常示例
{
"biz_serial_no":"2016062700001"
}说明：本示例仅供参考。
公共错误码
前往查看业务错误码
| 状态码 | 错误码 | 错误描述 | 凯发app官方网站的解决方案 |
|---|---|---|---|
| 400 | system_error | 系统繁忙 | 服务器异常 可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试 |
| 400 | invalid_parameter | 参数有误 | 请根据接口返回的参数非法的具体错误信息，修改参数后进行重试 |
| 400 | card_is_deleted_already | 会员卡在此之前已被（用户主动）删除 | 在此调用之前已被删除，业务上可视作删除成功 |
| 400 | card_not_exit | 会员卡不存在 | 确认卡信息 |
| 400 | no_card_type | 卡类型不正确 | 确认是否创建模板 |