任务描述
暂无
需求描述


背景: 公司目前已有支持P 卡,连连支付通道,应财务需求新增支付通道,万里汇支付,前期需求已经对接过该余额,账单接口,新增需求对接管理账号接口是为虚拟账号进行关联关系。




1.2. 验收目标


            1.新增账号列表页面,用于查询万里汇所有账号

            2.对接账号管理接口(inquiry_account)



2. 功能设计

2.3. 管理接口关联场景

             1. 对接管理账号接口--》请求账单接口(历史需求)---》关联管理账号接口信息--》可区分已收款账号/无收款账号信息---》页面展示使用





2.2.1 操作路径


财务管理---万里汇平台---我的收款




2.2.3 新增账号列表页面,用于查询万里汇所有账号

2.2.3.1  功能点描述:

万里汇收款账号(RA账户),公司信息,状态,银行卡号,账号状态, 银行卡尾数;这些信息是从inquiry_account 接口得出;

另外需要关联查询余额,通过之前对接的余额接口关联查询请求







2.2.3 对接账号管理接口(inquiry_account)

2.2.3.1  功能点描述:


存储字段需求

 customerId ,customerCompanyName,accountNo,accountType,accountStatus,bankaccountNo


请求参数

字段名

数据类型

是否必填

描述

referenceCustomerId

字符串

是(有条件)

集成商分配给注册用户的唯一用户ID。

更多信息:

  • 目前推荐使用此字段查询RA信息。
  • 字符串最大值:64
  • referenceCustomerId, customerId, accessToken 不能同时为空

customerId

字符串

是(有条件)

由万里汇定义、用于唯一标识某万里汇账户。

更多信息:

  • 字符串最大值:64
  • referenceCustomerId, customerId, accessToken 不能同时为空

accessToken

字符串

是(有条件)

用于OAuth校验的访问令牌

更多信息:

  • 字符串最大值:64
  • referenceCustomerId, customerId, accessToken 不能同时为空

accountType

字符串

否

查询账号类型。目前此字段取值

固定为RECEIVE_ACCOUNT

更多取值详见:AccountType

响应参数

字段名

数据类型

是否必填

描述

result

Result 类型

是

代表接口调用结果

responseId

字符串

是

由万里汇定义,用于唯一标识某次响应的ID。

更多信息:

  • 字段最大长度:32

customerId

字符串

是

由万里汇定义、用于唯一标识某万里汇账户。

更多信息:

  • 字符串最大值:64

accountInfos

列表<AccountInfo 类型>

是

账号信息

customer

Customer 类型

否

客户信息。


AccountInfo

字段名

数据类型

是否必填

描述

accountNo

字符串

是

万里汇收款账户(RA)账号

更多信息:

  • 字段最大长度:64

currencyList

列表<字符串>

是

由3字母ISO-4217代码组成的列表,代表账户币种

支持以下币种:

  • USD,EUR,GBP,NZD,CAD,AUD,JPY,SGD,HKD,CNH

更多信息:

  • 当此字段为空时,万里汇返回全部币种

accountType

字符串

是

查询账号类型。目前此字段取值

固定为RECEIVE_ACCOUNT

更多取值详见:AccountType

accountStatus

字符串

是

账户状态。取值范围为:

  • ACTIVE: 账户已激活
  • ABNORMAL: 账户状态异常

bankAccount

Bank Account 对象

否

账号银行账户信息

更多信息:

  • 当accountType 为BANK_ACCOUNT 或 VIRTUAL_ACCOUNT时,此字段为必填

BankAccount

字段名

数据类型

是否必填

描述

accountNo

字符串

是

银行账号

更多信息:

  • 字段最大长度:64

bankBIC

字符串

是

银行的BIC代码,长度为8-11位。

更多信息:

  • 规则:{"checkRules": "^[A-Z]{6,6}[A-Z2-9][A-NP-Z0-9]([A-Z0-9]{3,3}){0,1}$"}
  • 字段最大长度:11

bankName

字符串

否

银行名称

更多信息:

  • 字段最大长度:128

bankRegion

字符串

否

代表银行所在国家/地区的二字母ISO-3166 代码

更多信息:

  • 字段最大长度:2

holderAddress

Address 对象

否

账号户主地址

holderAccountName

UserName 对象

是

账号户主姓名。转账代发到中国大陆时使用中文名,转账代发到US或EU时使用英文名。

更多信息:

  • 规则:{"checkRules": "^[A-Za-z0-9_,()\\s.,]{0,70}$"}
验收标准
暂无
历史记录  
  1. 2022-12-26 09:30:16, 由 许瑞丰 创建。
  2. 2022-12-27 18:55:05, 由 姜凡 完成。
    修改了 总计消耗,旧值为 "0",新值为 "3"。
    修改了 指派给 ,旧值为 "jiangfan",新值为 "xuruifeng"。
    修改了 实际完成,旧值为 "",新值为 "2022-12-27 18:54:52"。
    修改了 任务状态,旧值为 "wait",新值为 "done"。
    修改了 实际开始,旧值为 "0000-00-00 00:00:00",新值为 "2022-12-27 18:55:05"。
    修改了 预计剩余,旧值为 "2",新值为 "0"。
    修改了 由谁完成,旧值为 "",新值为 "jiangfan"。
  3. 2023-10-31 15:03:06, 由 周杰 关闭。
    修改了 任务状态,旧值为 "done",新值为 "closed"。
    修改了 指派给 ,旧值为 "xuruifeng",新值为 "closed"。
    修改了 由谁关闭,旧值为 "",新值为 "zhoujie"。
    修改了 关闭时间,旧值为 "0000-00-00 00:00:00",新值为 "2023-10-31 15:03:06"。
    修改了 关闭原因,旧值为 "",新值为 "done"。
所属迭代 金蝶对接平台四期项目
所属模块 /
相关需求 万里汇账户管理接口
指派给 Closed 于 2023-10-31 15:03:06
任务类型 后端
任务标签 初始
开发组 多平台开发组
任务状态 已关闭
进度 100%
优先级 P2
关键词
抄送给
由谁创建 许瑞丰 于 2022-12-26 09:30:16
由谁完成 姜凡 于 2022-12-27 18:54:52
由谁取消 暂无
由谁关闭 周杰 于 2023-10-31 15:03:06
关闭原因 已完成
最后编辑 周杰 于 2023-10-31 15:03:06
团队 最初预计 总计消耗 预计剩余
工时信息
最初预计 2工时
总计消耗 3工时
预计剩余 0工时
预计开始 2022-12-26
实际开始 2022-12-27
截止日期 2022-12-26