接口说明
接口英文名称：alipay.marketing.card.message.notify
请求url：https://openapi.alipay.com/v3/alipay/marketing/card/message/notify
请求方式：post
path指该参数为路径参数
query指该参数需在请求url传参
body指该参数需在请求json传参
通用场景
商户触发消息通知用户
注意：
商户触发消息通知用户
公共请求参数
业务请求参数
body参数
target_card_no_type｜卡号id类型必选string[0,32]
【描述】卡号id类型
【枚举值】
支付宝业务卡号: biz_card
【示例值】biz_card
target_card_no｜支付宝业务卡号必选string[0,32]
【描述】支付宝业务卡号，即通过 alipay.marketing.card.open 接口开卡后获取的 card_info.biz_card_no 值。
【示例值】000001
occur_time｜业务发生时间必选date
【描述】标识业务发生时间，时间格式为"yyyy-mm-dd hh:mm:ss"。
匹配格式yyyy-mm-dd hh:mm:ss的date类型
【示例值】2020-12-27 12:12:12
notify_no｜消息通知流水号可选string[0,64]
【描述】消息通知幂等标识，业务流水号
【示例值】2000000000001
notify_type｜通知类型可选string[0,32]
【描述】消息通知类型,
point_remind 积分过期提醒
point_remind 积分过期提醒
【示例值】point_remind
notify_info｜消息通知详情可选string[0,1028]
【描述】消息通知详情，包含消息通知需要的信息，map 格式存储。
积分过期提醒：
expired_point 过期积分值
expired_time 过期时间
expired_point 过期积分值
expired_time 过期时间
【示例值】{"expired_point":"121"}
常见请求示例
默认示例
curl -x post \
"https://openapi.alipay.com/v3/alipay/marketing/card/message/notify" \
-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 '{
"notify_type":"point_remind",
"target_card_no_type":"biz_card",
"occur_time":"2020-12-27 12:12:12",
"target_card_no":"000001",
"notify_no":"2000000000001",
"notify_info":"{\"expired_point\":\"121\"}"
}'
说明：本示例仅供参考。
公共响应参数
业务响应参数
result_code｜错误码可选string(64)
【描述】二级错误处理结果（如果公用返回结果为false，则可以看这个接口判断明细原因） 如果公用返回为true，则该字段为空
【示例值】isv.update-usercard-fail
响应示例
正常示例
异常示例
{
"result_code":"isv.update-usercard-fail"
}说明：本示例仅供参考。
公共错误码
前往查看业务错误码
| 状态码 | 错误码 | 错误描述 | 凯发app官方网站的解决方案 |
|---|---|---|---|
| 400 | system_error | 系统繁忙 | 服务器异常 可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试 |
| 400 | invalid_parameter | 参数有误 | 请根据接口返回的参数非法的具体错误信息，修改参数后进行重试 |
| 400 | card_not_exit | 会员卡不存在 | 核对 target_card_no ，和开卡时的是否一致（包括支付宝业务卡号、商户外部卡号） |