通用场景
商户触发消息通知用户
注意：
商户触发消息通知用户
公共请求参数
业务请求参数
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 'https://openapi.alipay.com/gateway.do?charset=utf-8&method=alipay.marketing.card.message.notify&format=json&sign=${sign}&app_id=${appid}&version=1.0&sign_type=rsa2×tamp=${now}' \
-f 'biz_content={
"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
响应示例
正常示例
异常示例
{
"alipay_marketing_card_message_notify_response": {
"code": "10000",
"msg": "success",
"result_code": "isv.update-usercard-fail"
},
"sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}说明：本示例仅供参考。
公共错误码
业务错误码
| 错误码 | 错误描述 | 凯发app官方网站的解决方案 |
|---|---|---|
| system_error | 系统繁忙 | 服务器异常 可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试 |
| invalid_parameter | 参数有误 | 请根据接口返回的参数非法的具体错误信息，修改参数后进行重试 |
| card_not_exit | 会员卡不存在 | 核对 target_card_no ，和开卡时的是否一致（包括支付宝业务卡号、商户外部卡号） |