财资云开放平台(开发版)
  1. 虚拟户接口
财资云开放平台(开发版)
  • 接入指南V3
    • 创建应用
    • APIFOX脚本及外部程序使用教程
    • 规则说明
      • 基本原则
      • 错误码
    • 密钥与签名
      • 接口加签方式
      • 签名规则
      • 验签规则
      • 请求内容加密
    • 服务端SDK
      • SDK使用帮助
      • Java
    • 应用开发配置
      • IP白名单
        • 服务器IP白名单
    • 常见问题
  • 接入指南
    • 接口调用方式说明
    • 创建应用
    • APIFOX脚本及外部程序使用教程
    • 应用开发配置
      • 接口加签方式
        • 接口加签方式说明
        • 设置密钥加签方式
        • 开发指南
          • 如何使用密钥
          • 密钥格式说明
          • 自行实现签名
          • 自行实现验签
        • 常见问题
          • 常见问题
        • SAP加签验签指南
      • IP白名单
        • 服务器IP白名单
      • 接口内容加密方式
        • 接口内容加密方式说明
      • 错误码
        • 公共错误码
    • 开发工具包
      • 开发工具包简介
      • 服务端SDK
        • 概述
        • Java
        • PHP
        • .Net
        • Python
        • NodeJS
    • 密钥工具
      • 密钥工具简介
      • 生成密钥
      • 密钥匹配
      • 格式转换
      • 同步验签
      • 签名
      • 异步验签
  • 产品能力
    • 示例产品
      • 示例功能
        • 产品介绍
        • 接入准备
        • 接入指南
        • 常见问题
        • 更新日志
        • API列表
          • API接口列表示例
    • 账户产品
      • 产品介绍
      • 接入准备
      • 接入指南
      • 常见问题
      • 更新日志
      • 账户管理
        • 实体户接口
          • 新增实体账户信息
          • 变更实体账户状态
          • 修改实体账户信息
          • 查询实体账户信息
        • 三方户接口
          • 新增三方户(商户号)信息
          • 变更三方户(商户号)状态
          • 修改三方户(商户号)信息
          • 查询三方户(商户号)信息
        • 内部户接口
          • 新增内部账户信息
          • 变更内部账户状态
          • 修改内部户信息
          • 查询内部账户信息
        • 现金户接口
          • 新增现金户信息
          • 变更现金账户状态
          • 变更现金户信息
          • 查询现金账户信息
        • 虚拟户接口
          • 新增虚拟子账户信息
            POST
          • 变更虚拟子账户信息
            POST
          • 销户虚拟子账户
            POST
          • 查询虚拟子账户信息
            GET
      • 账户余额
        • 查询账户余额
        • 同步账户余额(含RPA)--先不处理
      • 账户明细
        • 查询三方账户明细
        • 同步实体账户明细(含RPA)---先不处理
      • 回单(作废)
        • 同步电子回单(含RPA)--先不处理
      • 关联关系(作废)
        • 根据明细查回单
      • 流水
        • 流水
      • 实物资产
        • 实物资产查询接口
      • 合作银行
        • 合作银行查询接口
      • 交易对手
        • 交易对手查询接口
    • 结算产品
      • 应付
        • 产品介绍
        • 接入准备
        • 接入指南
        • 常见问题
        • 更新日志
        • API列表
          • 创建应付款单
          • 应付单查询接口
      • 国内付款
        • 产品介绍
        • 接入准备
        • 接入指南
        • 常见问题
        • 更新日志
        • API列表
          • 创建国内付款
        • 国内支付填写要求
      • 费用报销
        • 产品介绍
        • 接入准备
        • 接入指南
        • 常见问题
        • 更新日志
        • API列表
          • 创建批量报销
      • 工资发放
        • 产品介绍
        • 接入指南
        • 接入准备
        • 常见问题
        • 更新日志
        • API列表
          • 创建工资代发
          • 创建工资批次总额信息
      • 全球付款
        • 产品介绍
        • 接入准备
        • 接入指南
        • 常见问题
        • 更新日志
        • API列表
          • 创建全球付款
      • 撤销付款
        • API列表
          • 撤销付款
      • 付款结果
        • 支付结果通知
        • 支付结果查询
        • 应付结果通知
        • 应付结果查询
      • 单据查询
    • 其他通用产品
      • 系统
        • 组织部门
          • 资源介绍
          • API列表
            • 创建组织部门
            • 修改组织部门
            • 删除组织部门
            • 获取单个组织部门信息
            • 组织部门批量查询
          • 事件列表
            • 组织创建
            • 组织创建
            • 组织变更
            • 删除组织
        • 开户行
          • 开户行查询
        • 系统字典
          • 资源介绍
          • API列表
            • 系统字典查询
            • 银行查询
        • 业务字典
          • 资源介绍
          • API列表
            • 新增业务字典
            • 修改业务字典
            • 重置字典
            • 删除单个业务字典
            • 删除指定类型字典
            • 业务字典批量查询
            • 单个业务字典查询
          • 事件列表
            • 新增业务字典
            • 修改业务字典
            • 删除单个业务字典
            • 删除指定类型字典
            • 重置字典
        • 汇率
          • 新增汇率
          • 修改汇率
          • 删除汇率
          • 查询单条汇率
          • 批量查询汇率
        • 会计科目
          • 新增会计科目
          • 修改会计科目
          • 删除会计科目
          • 查询单个会计科目
          • 批量查询会计科目
        • 交易对手
          • 交易对手信息
        • 通用文件上传
          • 上传文件
    • 票证产品
      • 票据
        • 查询
          • 附件查询
          • 票据正背面查询
        • 操作
          • 签收/承兑 /付款
          • 质押申请
          • 背书申请
          • 贴现申请
          • 撤回操作
          • 撤票操作
          • 提示付款申请
          • 票据同步
          • 票据异常处理
        • 出票申请
        • 票据查询(拆开)
        • 交易状态查询
        • 异步通知(同步 票据当前操作 状态)
        • 票据详情查询
        • 对方是否签收状态查询
      • 新版票据
        • 外部对接
          • 票据贴现对外接口
          • 票据出票对外接口
        • 资产池对接
          • 入池校验/跨行调拨操作
          • 资产池通知操作
      • 信用证
        • 信用证信息查询
        • 【老版本停止维护】信用证信息-推送(全字段版,部分字段改造前暂无)
        • 信用证信息-推送(新版信用证)
      • 贴现运营
        • 查询票据贴现运营列表信息
        • 贴现运营配票进度缓存查询接口
        • 贴现运营-配票接口
    • 对账产品
      • 认领接口
    • 投融资
      • 融资
        • 授信&发行申报
          • 【上报】查询授信&发行申报合同
          • 查询授信合同
          • 授信新增
          • 授信查询
        • 发行申报
          • 查询发行申报
        • 融资合同&内部往来&债券登记
          • 查询融资合同
          • 【上报】查询融资&往来&债券合同
        • 债券登记
          • 查询债券合同
        • 往来借款
          • 内部往来新增
          • 查询往来借款合同
        • 提款&放款
          • 【上报】查询提款&放款列表
        • 贷后
          • 【上报】查询贷后列表
          • 【上报】查询还款记录列表
        • 保函
          • 【上报】查询保函列表
        • 资产台账
          • 【上报】查询资产台账列表
        • 担保
          • 【上报】查询担保列表
        • 融资新增
        • 融资查询
        • 内部往来查询
        • 提款
        • 放款
        • 按期还款
        • 提前还款
      • 投资
        • 存款
          • 存款新增
          • 存款详情查询
          • 存款支取
          • 存款申购
          • 转让
          • 存款结息
          • 存款作废
        • 理财
          • 理财详情查询
          • 理财新增
          • 理财作废
    • 预算和计划
      • API列表
        • 预算控制
      • 资金预算
        • 预算编制查询
        • 预算编制更新接口
    • 身份认证
      • 获取登录预授权码
    • 结算中心
      • 结算中心计息单查询接口
    • 事件中心
      • webhook
        • 明细
          • 实体户明细删除
          • 三方明细删除
        • 对账
          • 应收单
          • 应收单实体账户流水
          • 应收单虚拟户流水
          • 应收单票据流水
          • 实体账户流水票据流水
        • 账户
          • 账户变更销
    • 组织架构
      • 员工
        • 资源介绍
        • API列表
          • 新增员工
          • 员工转用户
          • 修改员工
          • 删除员工信息
          • 查询单个员工信息
          • 批量查询员工信息
        • 事件列表
          • 新增员工
          • 修改员工
          • 删除员工
          • 员工转用户
      • 组织
        • 通过企业名称查询详细信息
        • API列表
          • 通过企业名称查询详细信息
  • 更新日志
    • 产品更新日志
    • 工具更新日志
  • 枚举值
    • 预算跨度
    • 预算颗粒度
    • 滚动颗粒度
    • 滚动期数
    • 参考值取数
    • 预算类型
    • 编制状态
    • 审批状态
    • 编制总状态
    • 催办状态
    • 执行状态
    • 预算旬
    • 预算周
    • 科目分类
    • 收支方向
    • 收支类型
    • 余额模板类型
    • 币种
    • 交易对手种类
    • 账户性质
    • 支付方式
    • 应付来源
  1. 虚拟户接口

变更虚拟子账户信息

开发中
POST
openapi/virtualaccount/modify
变更虚拟子账户信息(含内部户子账户信息)

请求参数

Body 参数application/json
array of:
OID
string 
账户ID
必需
资金系统账户唯一标识
orgCode
string 
组织编码
必需
orgCodeName
string 
组织名称
必需
userDeptCode
string 
使用部门编码
可选
userDeptName
string 
使用部门名称
可选
managerOrgCode
string 
归口管理部门编码
可选
managerOrgName
string 
归口管理部门名称
必需
bankCode
string 
银行编码
必需
bankName
string 
银行名称
必需
bankLocation
string 
开户行名称
必需
cnaps
string 
联行号
可选
swiftCode
string 
swift号
可选
stopPayCode
string 
止付编码
可选
accountNumber
string 
账号
可选
accountName
string 
账户名称
可选
accountEngName
string 
账户英文名称
可选
memonicCode
string 
助记码
可选
accountPropertyCode
string 
账户性质编码
可选
填写账户性质编码
accountTypeCode
string 
账户种类编码
可选
BZJZH 保证金(包括:安全、质量等) DKZH 贷款 DPZH 电票专户 DQZH 定期 HQZH 活期 LCZH 理财 SUPERVISION_ACCOUNT 监管账户 THIRDPAY 第三方支付 TZZH 通知 XDZH 协定 XJH 现金户 XMZH 项目专户 NBZH 内部账户 JSK 结算卡 GWK 公务卡 DQCK 定期存款 NRA NRA LA 离岸 NFT NFT NBZZH 内部子账户
accountUseType
integer 
账户用途
可选
账户种类为“内部户”时填写 1-通用 2-现金池往来专用 3-内部贷款 4-内部存款 5-结算中心专用 6-内部业务结算 7-票据业务专用
fundTypeRange
string 
账户标签
可选
多值,用","分割;返回账户标签名称
currencyCode
string 
币种
可选
三位编码(国际标准)
isMultiCurrency
integer 
是否多币种
可选
0-否 1-是 默认0
currencyRange
string 
币种范围
可选
多值,用","分割; 三位编码(国际标准)
boundaryFlag
integer 
境内境外标志
可选
1-境内 2-境外
countryCode
string 
国家或地区
可选
三位编码(国际标准)
areaCode
string 
行政区域
可选
目前仅中国地区行政区域
citibankOpn
string 
花旗OPN标识
可选
花旗银行必填
residentType
string 
居民类型
可选
relatedAccountNumber
string 
关联购汇账户
可选
isSupervision
integer 
是否受监管
可选
0-否 1-是 默认0
isManageByGroup
integer 
是否集团代管
可选
0-否 1-是 默认0
isLinkedVirtualAccount
integer 
是否下挂虚拟户
可选
0-否 1-是 默认0
isBillSettlement
integer 
是否用于票据结算的标识
可选
0-否 1-是 默认0
accountState
integer 
账户状态
可选
2-正常 3-冻结 4-销户
isDirect
integer 
是否直联
可选
0-否 1-是 默认0
projectItemCodeOrName
string 
项目
可选
填写项目编码或名称
legalPerson
string 
法人信息
可选
address
string 
账户地址
可选
enquiryAddress
string 
询证地址
可选
reservedSeal
string 
预留印鉴
可选
memo
string 
备注说明
可选
extensionInfo
string 
扩展信息
可选
creditCode
string 
统一社会信用代码
可选
dedepositorQueryCode
string 
存款人查询码
可选
taxRate
number 
税率
可选
currencyPayment
integer 
是否开通网银支付权限
可选
0-否 1-是 默认0
centralizedFundAccount
integer 
是否纳入集中资金账户
可选
0-否 1-是 默认0
projectSpecialAccount
integer 
是否项目专户
可选
0-否 1-是 默认0
registration
string 
注册地
可选
signFormat
string 
报文签约格式
可选
对接AMH时填写 1-FIN,2-FILEACT
payFlag
integer 
是否支持支付指令
可选
对接AMH时填写 0-是,1-否
enterpriseCode
string 
企业BOC编码
可选
对接AMH时填写
contactInfo
array [object {5}] 
联系信息
可选
contact
string 
联系人
可选
phone
string 
联系电话
可选
email
string 
电子邮箱
可选
position
string 
职位
可选
description
string 
备注
可选
aliPayNumber
string 
三方账号
可选
账户种类为“第三方账户”时填写;支付宝、微信账号等
bindingAccount
array [object {6}] 
三方户提现账户
可选
账户种类为“第三方账户”时填写;
accountNumber
string 
账号
可选
accountName
string 
户名
必需
bankCode
string 
银行编码
必需
bankName
string 
银行名称
必需
bankLocation
string 
开户行名称
必需
description
string 
备注
必需
source
integer 
数据来源
必需
示例
[
    {
        "OID": "string",
        "orgCode": "string",
        "orgCodeName": "string",
        "userDeptCode": "string",
        "userDeptName": "string",
        "managerOrgCode": "string",
        "managerOrgName": "string",
        "bankCode": "string",
        "bankName": "string",
        "bankLocation": "string",
        "cnaps": "string",
        "swiftCode": "string",
        "stopPayCode": "string",
        "accountNumber": "string",
        "accountName": "string",
        "accountEngName": "string",
        "memonicCode": "string",
        "accountPropertyCode": "string",
        "accountTypeCode": "string",
        "accountUseType": 0,
        "fundTypeRange": "string",
        "currencyCode": "string",
        "isMultiCurrency": 0,
        "currencyRange": "string",
        "boundaryFlag": 0,
        "countryCode": "string",
        "areaCode": "string",
        "citibankOpn": "string",
        "residentType": "string",
        "relatedAccountNumber": "string",
        "isSupervision": 0,
        "isManageByGroup": 0,
        "isLinkedVirtualAccount": 0,
        "isBillSettlement": 0,
        "accountState": 0,
        "isDirect": 0,
        "projectItemCodeOrName": "string",
        "legalPerson": "string",
        "address": "string",
        "enquiryAddress": "string",
        "reservedSeal": "string",
        "memo": "string",
        "extensionInfo": "string",
        "creditCode": "string",
        "dedepositorQueryCode": "string",
        "taxRate": 0,
        "currencyPayment": 0,
        "centralizedFundAccount": 0,
        "projectSpecialAccount": 0,
        "registration": "string",
        "signFormat": "string",
        "payFlag": 0,
        "enterpriseCode": "string",
        "contactInfo": [
            {
                "contact": "string",
                "phone": "string",
                "email": "string",
                "position": "string",
                "description": "string"
            }
        ],
        "aliPayNumber": "string",
        "bindingAccount": [
            {
                "accountNumber": "string",
                "accountName": "string",
                "bankCode": "string",
                "bankName": "string",
                "bankLocation": "string",
                "description": "string"
            }
        ],
        "source": 0
    }
]

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'openapi/virtualaccount/modify' \
--header 'Content-Type: application/json' \
--data-raw '[
    {
        "OID": "string",
        "orgCode": "string",
        "orgCodeName": "string",
        "userDeptCode": "string",
        "userDeptName": "string",
        "managerOrgCode": "string",
        "managerOrgName": "string",
        "bankCode": "string",
        "bankName": "string",
        "bankLocation": "string",
        "cnaps": "string",
        "swiftCode": "string",
        "stopPayCode": "string",
        "accountNumber": "string",
        "accountName": "string",
        "accountEngName": "string",
        "memonicCode": "string",
        "accountPropertyCode": "string",
        "accountTypeCode": "string",
        "accountUseType": 0,
        "fundTypeRange": "string",
        "currencyCode": "string",
        "isMultiCurrency": 0,
        "currencyRange": "string",
        "boundaryFlag": 0,
        "countryCode": "string",
        "areaCode": "string",
        "citibankOpn": "string",
        "residentType": "string",
        "relatedAccountNumber": "string",
        "isSupervision": 0,
        "isManageByGroup": 0,
        "isLinkedVirtualAccount": 0,
        "isBillSettlement": 0,
        "accountState": 0,
        "isDirect": 0,
        "projectItemCodeOrName": "string",
        "legalPerson": "string",
        "address": "string",
        "enquiryAddress": "string",
        "reservedSeal": "string",
        "memo": "string",
        "extensionInfo": "string",
        "creditCode": "string",
        "dedepositorQueryCode": "string",
        "taxRate": 0,
        "currencyPayment": 0,
        "centralizedFundAccount": 0,
        "projectSpecialAccount": 0,
        "registration": "string",
        "signFormat": "string",
        "payFlag": 0,
        "enterpriseCode": "string",
        "contactInfo": [
            {
                "contact": "string",
                "phone": "string",
                "email": "string",
                "position": "string",
                "description": "string"
            }
        ],
        "aliPayNumber": "string",
        "bindingAccount": [
            {
                "accountNumber": "string",
                "accountName": "string",
                "bankCode": "string",
                "bankName": "string",
                "bankLocation": "string",
                "description": "string"
            }
        ],
        "source": 0
    }
]'

返回响应

🟢200成功
application/json
Body
object {0}
示例
{}
上一页
新增虚拟子账户信息
下一页
销户虚拟子账户
Built with