BSS积分兑换接口文档.docx

1.1.1 积分扣减（查询受理分册） 1.1.1.1?业务描述 该接口用于电子渠道或合作伙伴发起的对用户消费积分的扣减或回退操作。 积分消费方式有兑换、抽奖、互换和消费四种。 积分回退是指当用户取消兑换或投诉时将用户积分返还的一种操作，将已 扣减积分返还；积分回退只适用于管理员处理用户投诉的情况。 1.1.1.2?业务流程 客户 客户登录 进行积分消费 电子渠道系统???????????枢纽系统?????????????用户归属省BSS 手机号码校验、积 分查询和消费确认 判断号码归属 发送扣减请求 地 发送扣减请求???????????????号码校验 积分值验证 发送扣减应答 进行积分扣减 操作 发送扣减应答 发送扣减应答 1) 客户登录电子渠道网站，查看可消费产品列表； 2) 客户进行积分消费； 3) 电子渠道系统检验用户手机号码，进行消费确认； 4) 电子渠道系统发送积分扣减请求； 5) 枢纽系统根据手机号码路由转发用户归属省?BSS； 6) 用户归属省?BSS?进行号码检验、可用积分值验证和积分扣减操作； 7) 用户归属省?BSS?返回积分扣减应答； 8) 枢纽系统返回积分扣减应答； 9) 电子渠道给客户返回积分消费结果； 在交易过程中，如果归属方?BSS?系统超时无应答，则认为该交易失败。发 起方可以用原交易流水重发请求，归属方应做查重，发现重复流水号的交易请 节点名称 父接口名称 约束 类型 长度 说明 PointsConsumeReq SvcCont 1 - ProcTime PointsConsumeReq 1 String F17 yyyyMMDDHH24MISSsss UserNumber PointsConsumeReq 1 String V20 现阶段是手机号码 OperType PointsConsumeReq 1 String F2 01-?扣减，02-回退 Points PointsConsumeReq 1 String V10 扣减、回退的积分数，正整数 扣减交易，省分应扣减用户积分； 回退交易，省分应增加用户积分； 名称 取值 编码 T2001107 需要冲正 0：不需要冲正 对帐标记 1：参与对帐 是否允许用原交易流水号重发 0:?不允许 发起方机构?DOMAIN ECIP 落地方机构?DOMAIN UCRM 路由类型 01：按照手机号码路由 编码 BIP2B001 冲正处理 不冲正 对帐 对账 1.1.1.3??业务属性 1.1.1.3??业务属性 1.1.1.4??交易属性 1.1.1.5??请求报文 求，直接返回原交易处理结果。 发起方连续重发失败，即认为交易失败，通过对账来调整，见对账接口描 述。 ChanType PointsConsumeReq 1 String F4 积分消费渠道 0XXX?电子渠道 0001?电子渠道网站 0002?WAP 1XXX?合作伙伴的编码 ConsumeType PointsConsumeReq 1 String F2 积分用途 01??????积分兑换 02??????积分抽奖 03??????积分互换 04??????积分消费 GoodsType PointsConsumeReq 1 String F2 物品类型的编码 01?通信类 02?非通信类 03?联盟类 GoodsCode PointsConsumeReq ? String V20 物品编码（兑换、消费类）(用于 无订单方式，有订单时不用填写 此字段) GoodsName PointsConsumeReq ? String V64 物品名称(用于无订单方式，有订 单时不用填写此字段) GoodsNum PointsConsumeReq ? String V10 物品数量(用于无订单方式，有订 单时不用填写此字段) OrderSeq PointsConsumeReq ? String V30 订单号（大订单号；无订单时不 用填写） Para1 PointsConsumeReq ? String V128 备注，可不填 节点名称 父接口名称 约束 类型 长度 说明 PointsConsumeRsp SvcCont 1 - EffectTime PointsConsumeRsp 1 String F14 生效时间 yyyyMMDDHH24MISS RespCode PointsConsumeRsp 1 String F2 应答码 00?成功 01?客户积分值不够 02?客户无积分 1.1.1.6 1.1.1.6??应答报文 现阶段扣减交易中，订单号为保留字段，可为空；回退交易中，订单号填 写原交易流水号。 目前积分扣减接口中产品描述不采用订单方式，产品信息直接填写在报文 相应字段；未