Skip to main content

【资产类】卡券包资产整合

基本信息

接口名称:卡券包资产整合(手机号变更)状  态:已完成
接口路径:POST /paas/micro/voucherwallet/apiMergeMemberAssets更新时间:2022-07-28 22:24:49
Mock地址:https://apimock.e-buychina.com/mock/77/paas/micro/voucherwallet/apiMergeMemberAssets

请求参数

Headers:

参数名称参数值是否必填
Content-Typeapplication/json
paas-jwteyJ0eXAiOiJKV.........................dQVzSF89hgis-k

Body:

参数名称类型必填默认值备注其他信息
uuidstring请求序列号最大长度:50
最小长度:1
Mock:@now('yyyyMMdd')-@string('lower',32)
appIdstring请求AppId最大长度:50
最小长度:1
Mock:@natural
actionstring交易类型最大长度:50
最小长度:1
Mock:apiMergeMemberAssets
timestampnumber请求时间戳Mock:@timestamp
signTypestring签名类型最大长度:20
最小长度:1
Mock:sha256
signstring签名值最大长度:32
最小长度:1
Mock:@natural
langstring语言最大长度:50
最小长度:1
Mock:zh_CN
contentobject返回报文
  orgPhoneNumberstring(条件必填)原始手机号(校验时与新手机号成对出现)最大长度:11
最小长度:1
Mock:@string
  tarPhoneNumberstring(条件必填)新手机号(校验时与原始手机号成对出现)最大长度:11
最小长度:1
Mock:@string
  originalMemberIdstring(条件必填)来源租户会员ID,上送原始手机号场景选填,校验时与目标租户会员ID成对出现最大长度:32
Mock:@string
  targetMemberIdstring(条件必填)目标租户会员ID,上送新手机号场景选填,校验时与来源租户会员ID成对出现最大长度:32
Mock:@string
  orgThirdOpenIdstring(选填)外部供应商原始会员ID最大长度:32
Mock:@string
  tarThirdOpenIdstring(选填)外部供应商新会员ID最大长度:32
Mock:@string

返回数据

参数名称类型必填默认值备注其他信息
uuidstring请求序列号最大长度:50
最小长度:1
Mock:@now('yyyyMMdd')-@string('lower',32)
actionstring交易类型最大长度:50
最小长度:1
Mock:apiMergeMemberAssets
timestampnumber返回时间戳Mock:@timestamp
signTypestring签名类型最大长度:20
最小长度:1
Mock:sha256
signstring签名值最大长度:500
最小长度:1
Mock:@natural
successboolean交易成功与否Mock:@boolean
errorCodestring错误码最大长度:50
Mock:@word
errorMessagestring错误描述最大长度:50
Mock:@csentence
contentobject
  tsnumber处理时间戳(Unix时间戳,单位:毫秒)Mock:@timestamp

备注

适用业务场景:
* 1) 租户用户资产数据注册租户会员后的资产整合(原用户ID转变为租户会员ID)
* 2) 租户会员手机号变更的资产整合,包括多手机号到指定手机号的资产整合(多次调用即可)
* 3) 虚拟租户会员(外部会员ID)与真实租户会员间的资产同步

特别说明:资产整合数据关系复杂涉及多表多分表位【不支持逆操作】

为了保证接口安全性,本接口使用JWT令牌处理进行请求校验,合法JWT令牌方可调用此接口
校验依据为原始手机号/原始租户会员ID(二选一)
令牌换取接口详见:https://book.e-buy.com/books/e-buy-paas-api/page/jwt
* 资产迁移的对接应用ID必须和查询应用ID保持一致(appId不一致会导致查询无结果,实际资产已迁移成功)


业务场景概述:
1)手机号变更场景【三方会员ID不变更】:仅上送原始手机号(orgPhoneNumber)与新手机号(tarPhoneNumber)即可、此时可视为orgThirdOpenId=tarThirdOpenId(可选上送)
2)手机号变更场景【三方会员ID也变更】:需同时上送原始手机号(orgPhoneNumber)与新手机号(tarPhoneNumber)、原始三方会员ID(orgThirdOpenId)与新三方会员ID(tarThirdOpenId)


内部逻辑概述
1)处理三方会员ID与租户会员ID关系(手机号关系),orgThirdOpenId不等于tarThirdOpenId场景,调用内部关系更新,更新后新老三方会员ID都将指向最新的租户会员ID(最新手机号)
2)处理卡券码明细与租户会员ID关系(卡券码关系),每张卡券码分表记录迁移成功将更新为最新的租户会员ID(最新手机号)
3)处理卡包记录关系(资产关系),原始数据将逻辑标记资产迁移状态(status=9),整合后的数据将会包含原始资产数据(并记录迁移来源相关信息到备注字段中)
* 以上处理逻辑保证事务一致性原则,如有失败则全部回滚


请求报文示例:

{
    "uuid": "20211224-kecwygdsipokqstbqtbwmqlpxijewfbf",
    "appId": "ebuytes100100100",
    "action": "apiMergeMemberAssets",
    "timestamp": 1640331603,
    "signType": "sha256",
    "sign": "1289147634148182",
    "content": {
        "orgPhoneNumber": "139xxxx2507",
        "tarPhoneNumber": "176xxxx3651",
        "originalMemberId": "3af2d2e1060d399c5ec5592fbfa87828",
        "targetMemberId": "d042e844e561a075aa2e1c6444638906"
    },
    "lang": "zh_CN"
}

响应报文示例:

{
    "uuid": "20211224-kecwygdsipokqstbqtbwmqlpxijewfbf",
    "action": "apiMergeMemberAssets",
    "content": {
        "ts": 1652424343684
    },
    "success": true,
    "errorCode": "",
    "errorMessage": "",
    "timestamp": 1640332092481,
    "signType": "sha256",
    "sign": "f94ddcbf0ab5bc28ad0fb018a4365b7164c9dbfb46de458e704813d7757b4bd7"
}

注意:为保证签名的一致性,返回报文中的content字段将以string形式的进行返回,例如:

{
	"content": {
		"userId": 1,
		"userName": "Trump"
	}
}

将返回为:

{
	"content": "{\"userId\":1,\"userName\":\"Trump\"}"
}




变更历史

变更日期变更内容
2022-05-16
2022-05-13
2022-05-11
2022-05-11
2022-05-11
2022-05-11
2022-05-11
2022-05-11
2022-05-11
2022-05-11
2022-05-11
2022-05-11
2022-05-11
2022-05-11
api-id=35483