获取补充材料问题详情

获取当前调单详情

端点目标 URL

沙盒环境请求地址：POST https://preapi.futurepay-develop.com/api/v1/virtual-account/queryVaExpandDetail

生产环境请求地址：POST https://api.futurepay.global/api/v1/virtual-account/queryVaExpandDetail

调用的特定输入参数

字段名称	必填	类型	描述
`merchantReference`	M	String	虚拟账户创建时的请求流水号

响应data参数

字段名	类型	说明
`merchantReference`	`String`	请求参数中的请求流水号
`dynamicTemplateData`	`Object`	补充材料问题

dynamicTemplateData字段结构

字段名	类型	说明
`templateId`	`String`	当前模板id
`templateVersionId`	`String`	版本id
`businessId`	`String`	业务id
`fieldList`	`list<fieldObj>`	字段列表

fieldObj字段结构

字段名	类型	说明
`field`	`String`	字段标识
`label`	`String`	字段名
`fieldType`	`String`	字段类型
`required`	`String`	是否必填（1：必填，0：非必填）
`sorted`	`String`	排序
`config`	`config`	字段配置(fieldType值返回对应的类型)
`children`	`list<fieldObj>`	子字段

config字段可能的类型

fieldType	类型
`TEXT`	`textConfig`
`LONG`	`textConfig`
`DECIMAL`	`textConfig`
`MUL_TEXT`	`textConfig`
`AMOUNT`	`amountConfig`
`DATE`	`dateConfig`
`DATE_RANGE`	`dateConfig`
`SELECT`	`selectConfig`
`MULTI_SELECT`	`selectConfig`
`CHECKBOX`	`selectConfig`
`FILE`	`fileConfig`
`IMAGE`	`fileConfig`
`CASCADER`	`cascaderConfig`
`TREE_SELECT`	`cascaderConfig`
`LIST`	`listConfig`
`CONTAINER`	`containerConfig`

textConfig对象信息

字段名	类型	说明
`regex`	`String`	字段正则校验表达式
`regexTips`	`String`	字段正则校验错误提示
`placeholder`	`String`	字段填写提示语

amountConfig对象信息

字段名	类型	说明
`amount.placeholder`	`String`	字段填写提示语
`currency.dictKey`	`String`	可选币种字典key

dateConfig对象信息

字段名	类型	说明
`min`	`String`	可以选择的最小时间（yyyy-MM-dd HH:mm:ss）
`max`	`String`	可以选择的最大时间（yyyy-MM-dd HH:mm:ss）

selectConfig对象信息

字段名	类型	说明
`dictKey`	`String`	可选项字典key

fileConfig对象信息

字段名	类型	说明
`placeholder`	`String`	字段填写提示语
`maxCount`	`String`	最大文件数量
`maxSize`	`String`	单个文件大小
`extensions`	`String`	允许的文件类型（多个用,隔开）

cascaderConfig对象信息

字段名	类型	说明
`dictKey`	`String`	可选项字典key
`multiple`	`String`	是否多选（1：是，0：否）

listConfig对象信息

字段名	类型	说明
`rows`	`String`	默认行数
`maxRows`	`String`	最大行数
`minRows`	`String`	最小行数
`content`	`String`	描述

containerConfig对象信息

字段名	类型	说明
`content`	`String`	描述

集成

当前获取补充材料问题调用输出

{
    "code": "0",
    "msg": "succeeded",
    "serverTime": 1778840713915,
    "data": {
        "merchantReference": "VA_PPXFUGGMZD",
        "dynamicTemplateData": {
            "templateId": "189",
            "templateVersionId": "550",
            "businessId": "110",
            "fieldList": [
                {
                    "field": "CONTAINER",
                    "label": " ",
                    "fieldType": "CONTAINER",
                    "required": "0",
                    "sorted": "1",
                    "config": {
                        "content": ""
                    },
                    "children": [
                        {
                            "field": "mcc",
                            "label": "mcc",
                            "fieldType": "SELECT",
                            "required": "1",
                            "sorted": "1",
                            "config": {
                                "dictKey": "mcc_two"
                            },
                            "children": null
                        }
                    ]
                }
            ]
        }
    },
    "success": true
}

获取字典

端点目标 URL

沙盒环境请求地址：GET https://preapi.futurepay-develop.com/api/v1/survey/questions/getDictByDictKeys

生产环境请求地址：GET https://api.futurepay.global/api/v1/survey/questions/getDictByDictKeys

字段说明

调用的特定输入参数

字段名称	必填	类型	描述
`dictKey`	M	string	字典key

响应data参数

字段名	类型	说明
`label`	`String`	字典名
`value`	`String`	字典值
`describe`	`String`	字典描述
`childDict`	`List`	下级字典

集成

获取字典调用输出

{
    "code": "0",
    "msg": "success",
    "serverTime": "1769665336362",
    "data": {
        "value": "web_collec_met",
        "dictId": "149",
        "label": "网站的收款方式",
        "describe": "",
        "childDict": [
            {
                "value": "ACH",
                "dictId": "150",
                "label": "ACH",
                "describe": ""
            },
            {
                "value": "PayPal",
                "dictId": "151",
                "label": "PayPal",
                "describe": ""
            },
            {
                "value": "other",
                "dictId": "152",
                "label": "其他",
                "describe": ""
            }
        ]
    },
    "success": true
}

提交补充材料问题材料

获取当前调单详情

端点目标 URL

沙盒环境请求地址：POST https://preapi.futurepay-develop.com/api/v1/virtual-account/submitVaExpand

生产环境请求地址：POST https://api.futurepay.global/api/v1/virtual-account/submitVaExpand

调用的特定输入参数

字段名称	必填	类型	描述
`merchantReference`	M	String	虚拟账户创建时的请求流水号
`templateId`	M	`String`	当前模板id
`templateVersionId`	M	`String`	版本id
`businessId`	M	`String`	业务id
`templateType`	M	`String`	模板类型，固定填写`VA_INCREMENTAL_INFORMATION`
`data`	M	`Map<String,valueObject>`	材料填写内容(key为前面获取到的field)

valueObject可能的类型

fieldType	类型
`TEXT`	`String`
`LONG`	`String`
`DECIMAL`	`String`
`MUL_TEXT`	`String`
`AMOUNT`	`amountValue`
`DATE`	`String`
`DATE_RANGE`	`dateRangeValue`
`SELECT`	`String`
`MULTI_SELECT`	`List<String>`
`CHECKBOX`	`List<String>`
`FILE`	`List<String>`
`IMAGE`	`List<String>`
`CASCADER`	`List<String>`
`TREE_SELECT`	`List<String>`
`LIST`	`List<Map<String,configValue>`
`CONTAINER`	`/`

amountValue对象信息

字段名	类型	说明
`amount`	`String`	金额数值
`currency`	`String`	金额币种

dateRangeValue对象信息

字段名	类型	说明
`dateS`	`String`	时间段开始时间（yyyy-MM-dd HH:mm:ss）
`dateE`	`String`	时间段结束时间（yyyy-MM-dd HH:mm:ss）

集成

当前提交补充材料问题材料调用输出

{
    "templateId": 18292,
    "templateVersionId": 1302,
    "businessId": 42322,
    "templateType": "VA_INCREMENTAL_INFORMATION",
    "data": {
        "mcc": "1520",
        "field105":"11111111111111111"
    },
    "merchantReference": "merchantReference"
}