koubei.marketing.tool.points.update(更新卡集点) 在线调试(沙箱环境)

更新集点卡上的集点

公共参数

请求地址

环境HTTPS请求地址
正式环境 https://openapi.alipay.com/gateway.do

公共请求参数

参数 类型 是否必填最大长度描述示例值
app_id String 32 支付宝分配给开发者的应用ID 2014072300007148
method String 128 接口名称 koubei.marketing.tool.points.update
format String 40 仅支持JSON JSON
charset String 10 请求使用的编码格式,如utf-8,gbk,gb2312等 utf-8
sign_type String 10 商户生成签名字符串所使用的签名算法类型,目前支持RSA2和RSA,推荐使用RSA2 RSA2
sign String 344 商户请求参数的签名串,详见签名 详见示例
timestamp String 19 发送请求的时间,格式"yyyy-MM-dd HH:mm:ss" 2014-07-24 03:07:50
version String 3 调用的接口版本,固定为:1.0 1.0
app_auth_token String 40 详见应用授权概述
biz_content String 请求参数的集合,最大长度不限,除公共参数外所有请求参数都必须放在这个参数中传递,具体参照各产品快速接入文档

请求参数

参数 类型 是否必填 最大长度 描述 示例值
req_id String 必选 32 外部流水号, 由开发者提供, 用于控制业务幂等 778712860805461247257
user_id String 必选 32 用户ID, 开发者通过用户信息授权产品获取 2088123412341234
activity_account String 必选 32 活动集点帐户ID, 开发者通过查询集点活动详情获取 39201608190015500100016011040139
trans_type String 可选 16 集点交易类型,目前支持:
DEPOSIT,增加集点
FREEZE,冻结集点
COMMIT,提交冻结集点
CANCEL,取消冻结集点
CONSUME, 消费集点
DEPOSIT
trans_amount String 可选 16 集点交易数量,必须为正整数字符串 10
shop_id String 可选 32 门店ID,集点交易类型为DEPOSIT时填写 2016041200077000000003277104
biz_no String 可选 32 业务流水号,集点交易类型为
DEPOSIT, 传入支付交易号;
CANCEL/COMMIT, 传入冻结集点的集点流水号;
CONSUME/FREEZE, 不允许传入biz_no;
2016082221001004150200139999
memo String 可选 256 交易备注 积分扣减用于兑换奖品
ext_info String 可选 2000 扩展信息 {'EXTRA_INFO_KEY':'SAMPLE_VALUE'}

响应参数

参数 类型 是否必填 最大长度 描述 示例值
point_log_no String 必填 32 集点变更流水号 2016041200032000000001132000

请求示例

AlipayClient alipayClient = new DefaultAlipayClient("https://openapi.alipay.com/gateway.do","app_id","your private_key","json","GBK","alipay_public_key","RSA2");
KoubeiMarketingToolPointsUpdateRequest request = new KoubeiMarketingToolPointsUpdateRequest();
request.setBizContent("{" +
"\"req_id\":\"778712860805461247257\"," +
"\"user_id\":\"2088123412341234\"," +
"\"activity_account\":\"39201608190015500100016011040139\"," +
"\"trans_type\":\"DEPOSIT\"," +
"\"trans_amount\":\"10\"," +
"\"shop_id\":\"2016041200077000000003277104\"," +
"\"biz_no\":\"2016082221001004150200139999\"," +
"\"memo\":\"积分扣减用于兑换奖品\"," +
"\"ext_info\":\"{'EXTRA_INFO_KEY':'SAMPLE_VALUE'}\"" +
"  }");
KoubeiMarketingToolPointsUpdateResponse response = alipayClient.execute(request);
if(response.isSuccess()){
System.out.println("调用成功");
} else {
System.out.println("调用失败");
}

响应示例

{
    "koubei_marketing_tool_points_update_response": {
        "code": "10000",
        "msg": "Success",
        "point_log_no": "2016041200032000000001132000"
    },
    "sign": "ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE"
}

异常示例

{
    "koubei_marketing_tool_points_update_response": {
        "code": "20000",
        "msg": "Service Currently Unavailable",
        "sub_code": "isp.unknow-error",
        "sub_msg": "系统繁忙"
    },
    "sign": "ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE"
}

业务错误码

公共错误码

错误码错误描述解决方案
INVALID_PARAMETER 参数有误。 修改参数重试
SYSTEM_ERROR 系统繁忙 稍后重试
SYSTEM_ERROR 系统繁忙 稍后重试
INVALID_PARAMETER 参数有误。 修改参数重试
BIZ_ERROR 业务异常。 满足业务执行条件后再试
INVALID_PARAMETER 参数有误。 修改集点帐户后重试
INVALID_PARAMETER 参数有误。 修改集点流水号后重试
INVALID_PARAMETER 参数有误。 修改请求号后重试
onlineServer