BSS积分兑换接口文档.docx

积分扣减（查询受理分册）业务描述该接口用于电子渠道或合作伙伴发起的对用户消费积分的扣减或回退操作。积分消费方式有兑换、抽奖、互换和消费四种。积分回退是指当用户取消兑换或投诉时将用户积分返还的一种操作，将已扣减积分返还；积分回退只适用于管理员处理用户投诉的情况。业务流程客户登录电子渠道网站，查看可消费产品列表；客户进行积分消费；电子渠道系统检验用户手机号码，进行消费确认；电子渠道系统发送积分扣减请求；枢纽系统根据手机号码路由转发用户归属省BSS；用户归属省BSS进行号码检验、可用积分值验证和积分扣减操作；用户归属省BSS返回积分扣减应答；枢纽系统返回积分扣减应答；电子渠道给客户返回积分消费结果；在交易过程中，如果归属方BSS系统超时无应答，则认为该交易失败。发起方可以用原交易流水重发请求，归属方应做查重，发现重复流水号的交易请求，直接返回原交易处理结果。发起方连续重发失败，即认为交易失败，通过对账来调整，见对账接口描述。业务属性编码BIP2B001冲正处理不冲正对帐对账交易属性名称取值编码T2001107需要冲正0：不需要冲正对帐标记1：参与对帐是否允许用原交易流水号重发0:不允许发起方机构DOMAINECIP落地方机构DOMAINUCRM路由类型01：按照手机号码路由请求报文节点名称父接口名称约束类型长度说明PointsConsumeReqSvcCont1-ProcTimePointsConsumeReq1StringF17yyyyMMDDHH24MISSsssUserNumberPointsConsumeReq1StringV20现阶段是手机号码OperTypePointsConsumeReq1StringF201- 扣减，02-回退PointsPointsConsumeReq1StringV10扣减、回退的积分数，正整数扣减交易，省分应扣减用户积分；回退交易，省分应增加用户积分；ChanTypePointsConsumeReq1StringF4积分消费渠道0XXX电子渠道0001电子渠道网站0002 WAP1XXX合作伙伴的编码ConsumeTypePointsConsumeReq1StringF2积分用途01 积分兑换02 积分抽奖03 积分互换04 积分消费GoodsTypePointsConsumeReq1StringF2物品类型的编码01 通信类02 非通信类03 联盟类GoodsCodePointsConsumeReq?StringV20物品编码（兑换、消费类）(用于无订单方式，有订单时不用填写此字段)GoodsNamePointsConsumeReq?StringV64物品名称(用于无订单方式，有订单时不用填写此字段)GoodsNumPointsConsumeReq?StringV10物品数量(用于无订单方式，有订单时不用填写此字段)OrderSeqPointsConsumeReq?StringV30订单号（大订单号；无订单时不用填写）Para1PointsConsumeReq?StringV128备注，可不填现阶段扣减交易中，订单号为保留字段，可为空；回退交易中，订单号填写原交易流水号。目前积分扣减接口中产品描述不采用订单方式，产品信息直接填写在报文相应字段；未来对于复杂业务将采用订单方式，即将积分扣减与订单明细分开，本接口只用于积分扣减，订单详细信息通过订单发送。应答报文节点名称父接口名称约束类型长度说明PointsConsumeRspSvcCont1-EffectTimePointsConsumeRsp1String F14生效时间yyyyMMDDHH24MISSRespCodePointsConsumeRsp1StringF2应答码00 成功01客户积分值不够02 客户无积分03 用户不存在99其他原因，见结果描述当应答码为00，Head中的应答码填0000，表示交易完成，业务成功。当应答码非00，Head中应答码填2990，表示交易完成但是业务失败RespDescPointsConsumeRsp?StringV256结果描述.给用户的提示信息，要简单明了ComsumePointsPointsConsumeRsp1StringV10实际扣减、回退积分RemainPointsPointsConsumeRsp1StringV10剩余积分总部H2接口方式包头数据包头格式：内容为一定长ASCII字符串（102位），具体内容如下：字段名称长度说明A0版本号信息（2位）标识当前使用的协议版本号（默认值：11）A1数据包大小（5位）以字节为单位，不足右补空格A2流水号（20位）业务流水号，标志每笔具体交易。数据校验包可以无流水号（发起方随机生成）A3标志（1位）1表示成功 0表示失败，仅适用于响应包A