TransferEasy接口商户API接口

## 1.引言
本部分对 TransferEasy 跨境汇兑接口进行详细地描述，通过该文档可以对本接口有个全
面地了解，使商户技术人员尽快掌握本接口，并能够在此基础上进行开发。
#### 1.1概述
本部分详细介绍了 TransferEasy 跨境汇兑接口进行了详细描述。接口采用 https+数据签
名的方式来保证商户与交易平台间的身份验证、中间信息传递的完整性，以便进行电子商务安
全当中非常重要的交易身份辨识、不可抵赖、防止篡改等功能。
#### 1.2适用对象
TransferEasy商户的网上应用开发人员、维护人员和管理人员，他们应具备以下基本知识:
1. 了解上述系统上的网站设置和网页制作方法;
2. 了解HTML语言或了解JAVA、PHP、.NET 等开发语言;[详见表格](#aaa) 
3. 了解信息安全的基本概念。

#### 1.3需求栏
| 标记 | 含义   |
|----|------|
| M  | 必填   |
| C  | 有条件的 |
| O  | 可选   |

#### 1.4接入规范
TransferEasy所有的数据提交和接收的方式皆是以post方式提交和接收，我们的异步回调是以流的方式返回。
#### 1.4.1数字签名
- i.若无特殊说明，Transfereasy API 均需签名，以便 Transfereasy 确认使用者身份
- ii.生成私钥
	- 用途：商户端请求 API 时对参数进行签名的重要参数
	- 存储：请商户端妥善保存，切勿泄露
	- 本地生成私钥：openssl genrsa 2048 | openssl pkcs8 -topk8 -nocrypt -out private.key
- iii.生成公钥
	- 用途：Transfereasy 对请求签名验证的重要参数
	- 存储：登录 Transfereasy 商户后台系统填写保存
	- 本地生成公钥：openssl rsa -pubout -in private.key -out public.key
- iv.生成待签名字符串
	- a.求参数（GET 请求的 query string，POST 请求的 form 内容）按照参数名 ASCII 码从小到大排序（字典序）后，使用 URL 键值对的格式（即key1=value1&key2=value2…）拼接成参数字符串，注意：键值中的 value需要进行 URL 编码
	- b.在参数字符串后面拼接上 Timestamp，用,隔开,得到待签名字符串。
- v. 生成签名
	- a. 将待签名字符串用 RSA 加密，哈希算法采用 SHA256，密钥使用申请服务时提交的密钥对的私钥
	- b. 将加密结果使用 base64 进行编码，得到最终的签名结果
- vi. 添加请求头
	- 每个接口的请求和响应 header 中都包含以下参数：
| header参数     | 说明     | 生成方法                         |
|--------------|--------|------------------------------|
| Content-Type | 内容编码类型 | 固定值：application/json         |
| AgencyNO   | 代理商户号 | 由Transfereasy统一生成分配 |
| SubMerchantNo   | 子商户号 | 由Transfereasy统一生成分配 |
| MerchantIdentity   | 角色 | 代理商:AGENT |
| Timestamp    | 时间戳    | 即生成待签名字符串时的Timestamp         |
| Signature    | API签名  | 即生成签名中得到的结果                  |
- vii. 在接收 Transfereasy 的异步通知时，商家应该用平台公钥核验签名，以确认通知是Transfereasy 发出且未被篡改，验签方法如下:
	- a. 将收到的支付结果回调通知 POST 请求的 form 内容按照参数名 ASCII 码从小 到 大 排 序 （ 字 典 序 ） ， 使 用 URL 键 值 对 的 格 式 （ 即key1=value1&key2=value2…）拼接成签名字符串，注意：需要对键值中的 value 值进行 URL 编码
	- b. 在签名字符串后面拼接上 POST 请求 header 中的 Timestamp 值，用,隔开，得到 query_string。
	- c. 将query_string以及POST请求header中的Signature值，先进行base64解码后，再使用 SHA-256 验签。
	- 应答机制（订单异步返回）是指当贵公司系统收到TransferEasy的支付成功或者取消数据通知（服务器点对点通讯形式）时，必须输出“success”TransferEasy收到 “success”，便认为贵公司已收到；否则将继续发送通知，以递增的时间间隔再次重发 17 次；时间间隔分别为 1s/5s/10s/30s/1m/2m/3m/4m/5m/6m/7m/8m/9m/10m/20m/30m/1h，以确保订单通知成功。(特别提醒：同样的通知可能会多次发送给商户、商户侧系统必须能够正确处理重复的通知，即做幂等处理。 推荐的做法是，当商户侧系统收到通知进行处理时，先检查对应业务数据的状态，并判断该通知是否已经处理，如果未处理，则进行处理；如果已处理，则直接返回结果成功。在对业务数据进行状态检查和处理之前，要采用数据锁进行并发控制，以避免造成数据混乱。如果在所有通知频率后没有收到我方回调，商户应调用查询订单接口确认订单状态。)

#### 1.4.3notifyUrl 填写注意事项
- i. notifyUrl 需要填写商户自己系统的真实地址，不能填写接口文档或 demo 上的示例地址。
- ii. notifyUrl 必须是以 https://或 http://开头的完整全路径地址，并且确保 url 中的域名和 IP 是外网可以访问的，不能填写 localhost、127.0.0.1、192.168.x.x等本地或内网 IP。
- iii. 常见错误举例：
| 错误示例 | 错误描述 |
| --- | --- |
| http://www.xxxxx.com | url 中只有域名，缺少具体的路径 |
| /apspay/payment | url 不是以 https://或 http://开头，缺少域名或 IP |
| http://127.0.0.1/apspay/payment | url 中填写了本地或者内网 IP |
| xxxxxxx，1234567，test | 填写了不是 url 格式的字符串 |

## 2.商户入网

### 2.1功能描述
商户入网

### 2.2 接口地址

请求地址：/busniness/creat
请求方式：POST

### 2.3请求参数

| 参数名称 | 参数中文名称 | 类型/长度 | 参数说明 | 是否必填 |
| -------------------------- | --------------------------------------- | ------------------- | ------------------------------------------------------------ | -------- |
| regTypeS | 类型（个人/企业） | String（20） | PERSONAL:个人资料 ENTERPRISE:公司资料 例：ENTERPRISE | M |
| contractEntityS | TE签约主体 | String（3） | 当regTypeS为ENTERPRISE时必填 TE签约主体： SAL：SINO ALLIED (HK) Limited TKL：TransferEasy KAZ Limited TUI：TransferEasy USA INC 例：SAL | M |
| occupation | 个人职业 | String（50） | 当regTypeS为PERSONAL时必填 | C |
| email | 邮箱 | String（100） | 邮箱 例：232xxxxx334@ qq.com | M |
| phone | 联系电话 | String（50） | 联系电话，必填 例：1736728393 | M |
| regName | 名称 | String（100） | 当regTypeS为PERSONAL时，填写个人名称全称 当regTypeS为ENTERPRISE时，填写企业法定名称 例：王小明 | M |
| regEngName | 英文名称 | String（100） | 当regTypeS为PERSONAL时，填写个人名称全称英文 当regTypeS为ENTERPRISE时，填写企业法定英文名称 例：WangXiaoMing | M |
| tradeName | 别名/商用名称 | String（100） | 当regTypeS为ENTERPRISE时选填 别名/商用名称 例：安全 | C |
| companyTypeS | 企业类型 | String（10） | 当regTypeS为ENTERPRISE时必填 企业类型： IEN：个体企业 SOE：国有企业 NGO：非政府组织/慈善机构 LCO：上市公司 PRE：个人投资 PAR：合伙人 INC：股份有限公司 LLC：有限责任公司 例：LLC | C |
| companyIndustryS | 企业所属行业 | Integer（5） | 当regTypeS为ENTERPRISE时需要填写，必填 企业所属行业： 4121:旅游、运输、住宿及物流 5943:办公、工业、汽车以药品器械灯专用品商店 5712:生活方式及零售类商店 7379:互联网计算机及电子服务 5047:医疗、教育、咨询等专业服务 7299:商业及其他类服务 例：7299 | C |
| merchantCredentialsType | 企业证件类型 | String（10） | 当regTypeS为ENTERPRISE时必填 企业证件类型： BRC:商业注册登记 TRC：税务登记证（大陆） COI：公司成立证明 COITC：企业三证合一证照（大陆） USC：统一社会信用代码证（大陆） RCS：社会团体法人登记证明（大陆） IBI：个体工商户营业执照（大陆） BRCM：商业登记证（大陆） OTHER:其它有相同效力的文件 例：OTHER | C |
| personalCredentialsType | 个人证件类型 | String（40） | 当regTypeS为PERSONAL时必填 个人证件类型： DRIVING_LICENSE：驾照 HONGKONG_PERMANENT_IDCARD：香港永久身份证 PASSPORT：护照 IDENTITY_CARD：身份证 OTHER：其他 例：HONGKONG_PERMANENT_IDCARD | C |
| credentialsNum | 证件号 | String（255） | 必填 证件号码 例：8288xxxxx2833 | M |
| credentialsStartTime | 证件有效期开始时间 | Date | 必填 证件有效期日期 例：2022-12-29 | M |
| credentialsValidityTime | 证件有效期截止时间 | Date | 必填 证件有效期截止日期 例：2022-12-29 | M |
| incorporationTime | 企业成立日期 | Date | 成当regTypeS为ENTERPRISE时必填 企业成立日期 例：2022-12-29 | C |
| companyWebsite | 公司网站 | String（100） | 当regTypeS为ENTERPRISE时选填 公司网址 | C |
| businessIntroduction | 企业及业务介绍 | String（1000） | 当regTypeS为ENTERPRISE时必填 企业及业务介绍 例：本司运输为主 | C |
| address | 个人常住地址/企业注册地址详细地址 | String（255） | 必填 详细地址必须为英文 例：中国北京海淀苏州街 | M |
| countryId | 个人常住地址/企业注册地址所属国家 | String（9） | 必填 所属国家 地区请填写ISO国际标准国家编码 例：784 （表示：阿拉伯联合酋长国） | M |
| addressState | 个人常住地址/企业注册地址所属洲/省 | String（255） | 必填 所属州/省 例：Al Anbar Governorate | M |
| addressCity | 个人常住地址/企业注册地址所属 | String（30） | 必填 所属城市 例：Anah | M |
| addressPostalCode | 个人常住地址/企业注册地址邮编 | String（20） | 必填 邮编 例：92938882 | M |
| operationAddress | 运营地址详细地址 | String（255） | 当regTypeS为ENTERPRISE时必填 运营详细地址，填写信息必须为英文 例：中国北京海淀 | C |
| operationCountryId | 运营地址所属国家 | String（10） | 当regTypeS为ENTERPRISE时必填 运营国家地区 地区请填写ISO国际标准国家编码 例：784 （表示：阿拉伯联合酋长国） | C |
| operationAddressState | 运营地址所属洲/省 | String（255） | 当regTypeS为ENTERPRISE时必填 运营地址州/省 例：Al Anbar Governorate | C |
| operationAddressCity | 运营地址所属城市 | String（30） | 当regTypeS为ENTERPRISE时必填 运营地址城市 例：‘Anah | C |
| operationAddressPostalCode | 运营地址邮编 | String（20） | 当regTypeS为ENTERPRISE时必填 运营地址邮编 | C |
| developCountryCode | 企业主要展业国家 | String（255） | 当regTypeS为ENTERPRISE时必填 请填写ISO国际标准的国家编号，多地区用逗号隔开 例：020 （表示：安道尔） | C |
| wealthSource | 财富和资金来源 | String（1000） | 必填 财富和资金来源 例：出售货物 | M |
| accountPurpose | 开立账户或建立业务关系的目的 | String（1000） | 必填 开立账户或建立业务关系的目的 例：世界和平 | M |
| purposeType | 开立账户或建立业务关系的目的类型 | Integer（5） | 当regTypeS为PERSONAL时必填 523:家庭支持/生活费用 524:存款/投资 525:礼物 526:商品和服务支付/商业买卖 527:差旅费用 528:教育/学费 529:租金/房屋抵押贷款 530:紧急/医疗救助 531:慈善/援助付款 532:奖励或彩票费用/税收 533:其它-请描述 例：530 | C |
| expectedCurrency | 预期的交易币种 | String（100） | 多币种是逗号分隔 例：USD,EUR | M |
| receiptSourceCountry | 收款资金的来源地 | String（100） | 填写可从查询国家地区接口查询 如果涉及多地区，逗号分隔收款资金的来源地 地区请填写ISO国际标准的国家编号 例：004,020 （表示：阿富汗，安道尔） | M |
| yearRemittance | 预计年收付款金额 | BigDecimal（16，3） | 币种：USD 预计年汇款额度,最大可有三位小数 例：1000 （表示：1000.000USD） | M |
| avgRemittance | 平均单笔收付款金额 | BigDecimal（16，3） | 必填 币种：USD 最大可填写三位小数 例：10 （表示：10.000USD） | M |
| remittancePurposeCountry | 汇款资金的目的地 | String（255） | 填写信息可查询国家地区接口 汇款资金的目的地，多地区请用逗号隔开 例：368,020 （表示：伊拉克，安道尔） | M |
| directorList | 董事信息 | arry | 当regTypeS为ENTERPRISE时必填 | C |
| shareholderList | 股东信息 | arry | 当regTypeS为ENTERPRISE时必填 | C |
| controlList | 实际控制人信息 | arry | 当regTypeS为ENTERPRISE时必填 | C |
| relevantList | 利益相关方信息 | arry | 当regTypeS为ENTERPRISE时选填 | O |
| companyFiles | 企业概况披露文件 | arry | 当regTypeS为ENTERPRISE时必填 信息填写必须是通过本地上传文件接口返回信息 官方出具的披露公司董事、高级管理人员及股东的文件 | C |
| structureFiles | 企业股权架构 | arry | 当regTypeS为ENTERPRISE时必填 信息填写必须是通过本地上传文件接口返回信息 请披露到持股在 25%及以上(≥25%)的自然人(公司有两层及以上股权架构适用) | C |
| companyBankFiles | 企业银行账户开户证明 | arry | 当regTypeS为ENTERPRISE时选填 填写证明文件地址，填写信息必须是通过本司上传文件返回的信息 开户证明或月结单[优先]或银行对账单,对账单或月结单须在90天有效期内或三个月内企业公户的银行对账单或最近的网银截屏。 | C |
| incorporationFiles | 企业注册证明 | arry | 当regTypeS为ENTERPRISE时必填 信息填写必须是通过本地上传文件接口返回信息 支持Certificate of Incorporation、Business Registration等，中国大陆企业为统一信用代码证，需在有效期内。 | C |
| operationAddressFiles | 运营地址证明 | arry | 当regTypeS为ENTERPRISE时必填 信息填写必须是通过本地上传文件接口返回信息 例如水、电、燃气费账单或固定电话账单或网络费用账单或公司银行对账单或税务及社保缴费账单或房租发票，租房合同等 | C |
| applicationFiles | 申请表扫描件 | arry | 必填 信息填写必须是通过本地上传文件接口返回信息 | M |
| premisesFiles | 经营场所照片 | arry | 当regTypeS为ENTERPRISE时选填 信息填写必须是通过本地上传文件接口返回信息 | C |
| rateFiles | 费率表 | arry | 必填 信息填写必须是通过本地上传文件接口返回信息 | M |
| certificatePhotoFiles | 手持证件照照片 | arry<Object> | 当regTypeS为PERSONAL时必填 信息填写必须是通过本地上传文件接口返回信息 | C |
| files | 其他文件 | arry | 选填 信息填写必须是通过本地上传文件接口返回信息 | O |
| contacts | 联系信息 | arry | 当regTypeS为ENTERPRISE时必填 | C |
| sReceiptSyle | 是否是收单业务 | Boolean（10） | 当regTypeS为ENTERPRISE时选填 FALSE：否， TRUE：是 例：TRUE | C |
| dockingMethodSly | 申请产品（对接方式） | String（10） | 当regTypeS为ENTERPRISE，且isReceiptS为TRUE时选填 取值为三种业务类型： ONLINE：线上 OFFLINE：线下 BOTH：线上和线下 例：BOTH | C |
| regAbbreviationName | 申请产品（商户简称） | String（50） | 当regTypeS为ENTERPRISE时，且dockingMethodSly为ONLINE时必填 例：JC | C |
| app | 申请产品（app） | String（255） | 当regType为ENTERPRISE时，且dockingMethodSly为ONLINE时选填 例：8338393 | C |
| appIds | 申请产品（appID） | String（100） | 当regType为ENTERPRISE时，且dockingMethodSly为ONLINE时必填 例：92477489 | C |
| websiteUrl | 申请产品（网址） | String（1000） | 当regType为ENTERPRISE时，且dockingMethodSly为ONLINE时必填 例：http://百/sdinfn | C |
| applets | 申请产品（小程序） | String（255） | 当regType为ENTERPRISE时，且dockingMethodSly为ONLINE时选填 例：xiaochengxu | C |
| officialAccountsName | 申请产品（公众号名称） | String（100） | 当regType为ENTERPRISE时，且dockingMethodSly为ONLINE时选填 | C |
| websiteName | 申请产品（网站名称） | String（255） | 当regType为ENTERPRISE时，且dockingMethodSly为ONLINE时选填 | C |
| stores | 线下门店信息 | arry | 当regType为ENTERPRISE时，且dockingMethodSly为OFFLINE时必填 当对接方式为线下时可填 | C |
| surname | 姓氏 | String（40） | 当regType为PERSONAL时必填 例：陈 | C |
| lastName | 姓氏英文 | String（40） | 当regType为PERSONAL时必填 例：Chen | C |
| middleName | 中间名字 | String（40） | 当regType为PERSONAL时选填 例：平 | C |
| middleEngName | 中间名字英语 | String（40） | 当regType为PERSONAL时选填 例：Ping | C |
| name | 名字的字 | String（80） | 当regType为PERSONAL时必填 例：安 | C |
| firstName | 名字的字英文 | String（80） | 当regType为PERSONAL时必填 例：An | C |
| previousName | 曾用名 | String（50） | 当regType为PERSONAL时选填 例：富贵 | C |
| nationality | 国籍 | String（20） | 当regType为PERSONAL时必填 例：156 | C |
| genderls | 性别 | String（2） | 当regType为PERSONAL时必填 性别： T:男， O:女， S:未知 例：S | C |
| dateOfBirth | 出生日期 | String（20） | 当regTypeS为PERSONAL时必填 出生日期，格式：yyyy-MM-dd 例：2022-01-02 | C |
| countriesInvolved | 业务是否涉及的国家 | Boolean | 涉及国家：白俄罗斯、乌克兰卢甘斯克地区、乌克兰顿涅茨克地区、克里米亚、伊朗、北朝鲜、缅甸、苏丹、南苏丹、叙利亚、古巴、利比亚、委内瑞拉。 例：true | M |
| notOrIssuedOr | 是否可发行或已发行不记名股票/持票人股份 | Boolean | 当regTypeS为PERSONAL时选填 是否可发行或已发行不记名股票/持票人股份 例：true | |
| submitReview | 提交审核 | Boolean | FALSE:否 TRUE:是 例：TRUE | M |

董事、股东、实际控制人、利益相关人相关信息
directorList、shareholderList、controlList、relevantList：

| 参数名称 | 参数中文名称 | 类型 | 参数说明 | 是否必填 |
| -------------------- | ----------------------- | ------------------- | ------------------------------------------------------------ | -------- |
| identity | 身份 | String（20） | 身份 director：董事信息 shareholder：股东信息 controller：实际控制人信息 relevant：利益相关人信息 例：director | M |
| stock | 股份占比 | BigDecimal（10，6） | 股份占比 当identity为director时必填 当identity为shareholder时必填 当identity为controller时必填 | C |
| occupation | 职位 | String（50） | 职位 当identity为director时必填 NON_EXECUTIVE_DIRECTOR：非执行董事 EXECUTIVE_DIRECTOR：执行董事 例：EXECUTIVE_DIRECTOR | C |
| identityTypeS | 股东类型/实际控制人类型 | String（20） | 股东类型/实际控制人类型 当identity为shareholder时必填 当identity为controller时必填 PERSONAL：个人 ENTERPRISE：企业 例：PERSONAL | C |
| companyTypeS | 企业类型 | String（10） | 企业类型 当identity为shareholder，且identityTypeS为ENTERPRISE时必填 当identity为controller，且identityTypeS为ENTERPRISE时必填 IEN：个体企业 SOE：国有企业 NGO：非政府组织/慈善机构 LCO：上市公司 PRE：个人投资 PAR：合伙人 INC：股份有限公司 LLC：有限责任公司 例：LLC | C |
| typesOfStakeholders | 利益相关方类型 | String（30） | 利益相关方类型 当identity为relevant时必填 ACCOUNT_AUTHORIZER：账户授权人 LEGAL_REPRESENTATIVE：法定代表人 AUTHORIZED_SIGNATORY：有权签字人 例：AUTHORIZED_SIGNATORY | C |
| surname | 姓氏 | String（40） | 姓氏 当identity为director时必填 当identity为shareholder，且identityTypeS为PERSONAL时必填 当identity为controller，且identityTypeS为PERSONAL时必填 当identity为relevant时必填 例：陈 | C |
| surEname | 姓氏英文 | String（40） | 姓氏英语 当identity为director时必填 当identity为shareholder，且identityTypeS为PERSONAL时必填 当identity为controller，且identityTypeS为PERSONAL时必填 当identity为relevant时必填 例：Chen | C |
| middleName | 中间名字 | String（40） | 中间名字 当identity为shareholder，且identityTypeS为PERSONAL时选填 当identity为controller，且identityTypeS为PERSONAL时选填 当identity为relevant时选填 例：平 | C |
| middleEname | 中间名字英文 | String（40） | 中间名字英文 当identity为shareholder，且identityTypeS为PERSONAL时选填 当identity为controller，且identityTypeS为PERSONAL时选填 当identity为relevant时选填 例：Ping | C |
| lastName | 姓名的名 | String（40） | 姓名的名 当identity为director时必填 当identity为shareholder，且identityTypeS为PERSONAL时必填 当identity为controller，且identityTypeS为PERSONAL时必填 当identity为relevant时必填 例：安 | C |
| lastEname | 姓名的名英文 | String（40） | 姓名的名英文 当identity为director时必填 当identity为shareholder，且identityTypeS为PERSONAL时必填 当identity为controller，且identityTypeS为PERSONAL时必填 当identity为relevant时必填 例：An | C |
| name | 姓名 | String（80） | 姓名 当identity为director时必填 当identity为shareholder，且identityTypeS为PERSONAL时必填，且填写个人姓名 当identity为shareholder，且identityTypeS为ENTERPRISE时必填，填写企业法定名称。 当identity为controller，且identityTypeS为PERSONAL时必填，填写个人姓名 当identity为controller，且identityTypeS为ENTERPRISE时必填，填写企业法定名称 当identity为relevant时必填 例：陈平安 | C |
| engName | 姓名英文 | String（80） | 姓名英文 当identity为director时必填 当identity为shareholder，且identityTypeS为PERSONAL时必填，填写个人姓名英文。 当identity为shareholder，且identityTypeS为ENTERPRISE时必填，填写企业法定名称。 当identity为controller，且identityTypeS为PERSONAL时必填，填写个人姓名英文 当identity为controller，且identityTypeS为ENTERPRISE时必填，填写企业法定名称英文 当identity为relevant时必填 例：ChenPingAn | C |
| nationality | 国籍 | String（10） | 国籍 当identity为director时必填 当identity为shareholder，且identityTypeS为PERSONAL时必填。 当identity为controller，且identityTypeS为PERSONAL时必填，填写个人国籍 当identity为relevant时必填 例：020 （表示：安道尔） | C |
| genderls | 性别 | String（2） | 当identity为director时必填 当identity为shareholder，且identityTypeS为PERSONAL时必填 当identity为controller，且identityTypeS为PERSONAL时必填，填写个人性别 当identity为relevant时必填 性别： T:男 O:女 S:未知 例：S | C |
| birthTime | 出生日期 | Date | 出生日期 时间格式：yyyy-MM-dd 当identity为shareholder，且identityTypeS为PERSONAL时必填。 当identity为controller，且identityTypeS为PERSONAL时必填，填写个人出生日期。 当identity为director时必填 当identity为relevant时必填 | C |
| documentType | 证件类型 | String（40） | 当identity为director时必填 当identity为shareholder，且identityTypeS为PERSONAL时必填。 当identity为controller，且identityTypeS为PERSONAL时必填，填写个人证件类型。 当identity为relevant时必填 证件类型： DRIVING_LICENSE：驾照 HONGKONG_PERMANENT_IDCARD：香港永久身份证 PASSPORT：护照 IDENTITY_CARD：身份证 OTHER：其他 例：HONGKONG_PERMANENT_IDCARD | C |
| certificateNum | 证件号 | String（255） | 证件号码 当identity为director时必填 当identity为shareholder，且identityTypeS为PERSONAL时必填。 当identity为controller，且identityTypeS为PERSONAL时必填，填写个人证件号。 当identity为relevant时必填 例：22838372 | C |
| startValidityDate | 证件有效期开始时间 | Date | 证件有效期开始时间 当identity为director时必填。 当identity为shareholder，且identityTypeS为PERSONAL时必填。 当identity为controller，且identityTypeS为PERSONAL时必填，填写个人证件有效期开始时间。 当identity为relevant时必填 时间格式：yyyy-MM-dd | C |
| validityDate | 证件有效期结束时间 | Date | 证件有效期结束时间 当identity为director时必填 当identity为shareholder，且identityTypeS为PERSONAL时必填 当identity为controller，且identityTypeS为PERSONAL时必填，填写个人证件有效期结束时间。 当identity为relevant时必填 时间格式：yyyy-MM-dd | C |
| address | 常住地址所在详细地址 | String（255） | 详细地址，填写信息必须为英文 当identity为director时必填 当identity为shareholder，且identityTypeS为PERSONAL时必填，填写个人常住详细地址 当identity为shareholder，且identityTypeS为ENTERPRISE时必填，填写企业注册详细地址 当identity为controller，且identityTypeS为PERSONAL时必填，填写个人常驻详细地址。 当identity为controller，且identityTypeS为ENTERPRISE时必填，填写企业注册详细地址 当identity为relevant时必填 | C |
| countryId | 常住地址所属国家 | String（5） | 国家/地区 当identity为director时必填 当identity为shareholder，且identityTypeS为PERSONAL时必填，填写个人常住国家 当identity为shareholder，且identityTypeS为ENTERPRISE时必填，填写企业注册国家 当identity为controller，且identityTypeS为PERSONAL时必填，填写个人常住地区所属国家。 当identity为controller，且identityTypeS为ENTERPRISE时必填，填写企业注册国家 当identity为relevant时必填 例：020 表示：安道尔 | C |
| addressState | 常住地址所属省/州 | String（50） | 省/州 当identity为director时必填 当identity为shareholder，且identityTypeS为PERSONAL时必填，填写个人常住州/省 当identity为shareholder，且identityTypeS为ENTERPRISE时必填，填写企业注册州/省 当identity为controller，且identityTypeS为PERSONAL时必填，填写个人常住地区所属省/州。 当identity为controller，且identityTypeS为ENTERPRISE时必填，填写企业注册省/州 当identity为relevant时必填 | C |
| addressCity | 常住地址所处城市 | String（50） | 城市 当identity为director时必填。 当identity为shareholder，且identityTypeS为PERSONAL时必填，填写个人常住城市。 当identity为shareholder，且identityTypeS为ENTERPRISE时必填，填写企业注册城市 当identity为controller，且identityTypeS为PERSONAL时必填，填写个人常住地区所属城市。 当identity为controller，且identityTypeS为ENTERPRISE时必填，填写企业注册城市 当identity为relevant时必填 | C |
| addressPostalCode | 常住地址邮编 | String（50） | 邮编 当identity为director时必填。 当identity为shareholder，且identityTypeS为PERSONAL时必填，填写个人常住地区邮编。 当identity为shareholder，且identityTypeS为ENTERPRISE时必填，填写企业注册国地区邮编 当identity为controller，且identityTypeS为PERSONAL时必填，填写个人常住地区邮编。 当identity为controller，且identityTypeS为ENTERPRISE时必填，填写企业注册邮编 当identity为relevant时必填 | C |
| identityFiles | 身份证明 | arry<object> | 身份证明 当identity为director时必填 当identity为shareholder，且identityTypeS为PERSONAL时必填 当identity为controller，且identityTypeS为PERSONAL时必填 当identity为relevant时必填 | C |
| residentAddressFiles | 常驻地址证明 | arry<object> | 常住地址证明 当identity为director时必填 当identity为shareholder，且identityTypeS为PERSONAL时必填 当identity为controller，且identityTypeS为PERSONAL时必填 当identity为relevant时必填 常驻地址证明 | C |
| authorizationFiles | 授权函 | arry<object> | 授权函 当identity为relevant时必填 | C |

contacts：联系信息

| 参数名称 | 参数中文名称 | 类型 | 参数说明 | 是否必填 |
| ----------- | ------------ | ------------- | ------------------------------------------------------------ | -------- |
| name | 姓名 | String（55） | 联系人姓名 例：张三 | M |
| phone | 电话 | String（255） | 联系人电话 例：183xxxxx1173 | M |
| responsible | 负责业务 | String（55） | 联系人负责业务 SALES：业务 TECHNOLOGY：技术 FINANCE：财务 CUSTOMERSERVICE：客服 RISK：风险 例：RISK | M |
| email | 邮箱 | String（100） | 联系人邮箱 例：823781@q q.com | M |

stores：申请产品--线下--商店信息

| 参数名称 | 参数中文名称 | 类型/长度 | 参数说明 | 是否必填 |
| ------------ | ------------ | ------------- | ------------------------------------------------------ | -------- |
| storeName | 店铺名称 | String（255） | 线下商店名称 例：正宗螺丝混 | M |
| storeArea | 商店所处国家 | String（5） | 线下商店所处国家 例：020 表示：安道尔 | M |
| storeAddress | 店铺详细地址 | String（255） | 门店详细地址，填写信息必须为英文 例：中国北京昌平 | M |
| files | 门店图片 | arry | 信息填写必须是通过本地上传文件接口返回信息 | M |

companyBankFiles、operationAddressFiles、applicationFiles、structureFiles、companyFiles、files、incorporationFiles、premisesFiles、residentAddressFiles、identityFiles、authorizationFiles、certificatePhotoFiles

传输文件信息

| 参数名称 | 参数中文名称 | 类型/长度 | 参数说明 | 是否必填 |
| -------- | ------------ | ------------- | --------------------------------------------------- | -------- |
| fileName | 文件名称 | String（255） | 文件名称 例：开户证明.jpg | M |
| filePath | 文件地址 | String（255） | 文件地址 例：https://开户证明/29/zhengming.jpg | M |

提示：
1:如果您确定您所提供的信息已全面后，请在最后一次提交信息中，submitReview字段输入true

2:如果您进件的是企业版信息，并且提供的信息中存有申请产品中的线下商店信息，请在每次的信息输入中把您的所有的商店信息全部输入一遍，申请产品中的线下商店信息以最后一次提供的信息为准

3.传输信息中的国家、省、市、区都可在接口（查询国家、省、市、区）中查询的到

#### 2.3.1 示例
```html
{
  "email": "1834568929@182.com",
  "requisitionNumber": "12345678929",
  "regAbbreviationName": "zhutijiancheng",
  "operationAddressFiles": [
    {
      "fileName": "常住地址证明.jpg",
      "filePath": "https://0/16760174012581749.jpg"
    }
  ],
  "contractEntityS": "SAL",
  "regName": "赵四",
  "regTypeS": "ENTERPRISE",
  "accountPurpose": "开立账户或建立业务关系的目的",
  "remittancePurposeCountry": "156,344",
  "operationAddressState": "Anhui",
  "operationAddressCity": "Bozhou",
  "addressCity": "Bozhou",
  "app": "qiqiangapp",
  "applicationFiles": [
    {
      "fileName": "常住地址证明.jpg",
      "filePath": "https://16760174012581749.jpg"
    }
  ],
  "credentialsValidityTime": 1677655380955,
  "controlList": [
    {
      "lastName": "拔",
      "eMiddleName": "Ni",
      "documentType": "DRIVING_LICENSE",
      "birthTime": 1677655380958,
      "countryId": "156",
      "residentAddressFiles": [
        {
          "fileName": "常住地址证明.jpg",
          "filePath": "https://16760174012581749.jpg"
        }
      ],
      "addressPostalCode": "youbian",
      "engName": "HanNiBa",
      "identityTypeS": "PERSONAL",
      "identity": "controller",
      "surname": "汉",
      "stock": 10,
      "eLastName": "Ba",
      "genderls": "T",
      "addressCity": "Bozhou",
      "address": "常住地址-详细地址",
      "eName": "HanNiBa",
      "surEname": "Han",
      "eSurname": "Han",
      "addressState": "Anhui",
      "startValidityDate": 1677655380958,
      "middleEname": "Ni",
      "nationality": "344",
      "lastEname": "Ba",
      "validityDate": 1677655380958,
      "name": "汉尼拔",
      "middleName": "尼",
      "identityFiles": [
        {
          "fileName": "常住地址证明.jpg",
          "filePath": "https://0/16760174012581749.jpg"
        }
      ],
      "certificateNum": "uz1C2g7WVmIUccSSfDjx+CE1Q1x24bfces1B42tXMZVkfsGyn0ixptT6aREAHEmgm6VBUvlVzrA6zSSqPEs81NERK12/8bvj9+u8KHNoJnvI1drNcN6HShhd0w6+9p6KQ9JGUU6U63aQMIAvl+kyQ4aNfYI6MWoMBa7oZ83ktP5MvoETJX6qGYRsVdA06pKJdblM4omq1MvZMntbWkZKHy/mphflTQeCoLq8ek3p5SiaCWmiKhreiZZzWnaCsSLl652GIrOsw7WHQq5GRRTLpeLDAAdGTtjcYfp5ywboLK7N9EhYGSeT6bgxyrE0K2EVBiaYnjpZkgGF8MLdDxvacQ=="
    }
  ],
  "structureFiles": [
    {
      "fileName": "常住地址证明.jpg",
      "filePath": "https://t16760174012581749.jpg"
    }
  ],
  "expectedCurrency": "USD",
  "businessIntroduction": "企业及业务介绍",
  "companyFiles": [
    {
      "fileName": "常住地址证明.jpg",
      "filePath": "https://60174012581749.jpg"
    }
  ],
  "wealthSource": "资金来源--刮刮乐",
  "appIds": "appid",
  "phone": "uz1C2g7WVmIUccSSfDjx+CE1Q1x24bfces1B42tXMZVkfsGyn0ixptT6aREAHEmgm6VBUvlVzrA6zSSqPEs81NERK12/8bvj9+u8KHNoJnvI1drNcN6HShhd0w6+9p6KQ9JGUU6U63aQMIAvl+kyQ4aNfYI6MWoMBa7oZ83ktP5MvoETJX6qGYRsVdA06pKJdblM4omq1MvZMntbWkZKHy/mphflTQeCoLq8ek3p5SiaCWmiKhreiZZzWnaCsSLl652GIrOsw7WHQq5GRRTLpeLDAAdGTtjcYfp5ywboLK7N9EhYGSeT6bgxyrE0K2EVBiaYnjpZkgGF8MLdDxvacQ==",
  "regEngName": "英文名称",
  "operationAddressPostalCode": "yobian",
  "files": [
    {
      "fileName": "常住地址证明.jpg",
      "filePath": "https://760174012581749.jpg"
    }
  ],
  "receipt": true,
  "yearRemittance": 100000000,
  "developCountryCode": "344,156",
  "companyIndustryS": 4121,
  "dockingMethodSly": "BOTH",
  "receiptSourceCountry": "156,344",
  "operationCountryId": "156",
  "countryId": "156",
  "relevantList": [
    {
      "lastName": "拔",
      "eMiddleName": "Ni",
      "documentType": "DRIVING_LICENSE",
      "birthTime": 1677655380958,
      "countryId": "156",
      "residentAddressFiles": [
        {
          "fileName": "常住地址证明.jpg",
          "filePath": "https://60174012581749.jpg"
        }
      ],
      "typesOfStakeholders": "LEGAL_REPRESENTATIVE",
      "addressPostalCode": "youbian",
      "engName": "HanNiBa",
      "identity": "relevant",
      "surname": "汉",
      "eLastName": "Ba",
      "genderls": "T",
      "addressCity": "Bozhou",
      "address": "常住地址-详细地址",
      "eName": "HanNiBa",
      "surEname": "Han",
      "eSurname": "Han",
      "addressState": "Anhui",
      "startValidityDate": 1677655380958,
      "middleEname": "Ni",
      "nationality": "344",
      "lastEname": "Ba",
      "validityDate": 1677655380958,
      "authorizationFiles": [
        {
          "fileName": "常住地址证明.jpg",
          "filePath": "https://74012581749.jpg"
        }
      ],
      "name": "汉尼拔",
      "middleName": "尼",
      "identityFiles": [
        {
          "fileName": "常住地址证明.jpg",
          "filePath": "https://174012581749.jpg"
        }
      ],
      "certificateNum": "uz1C2g7WVmIUccSSfDjx+CE1Q1x24bfces1B42tXMZVkfsGyn0ixptT6aREAHEmgm6VBUvlVzrA6zSSqPEs81NERK12/8bvj9+u8KHNoJnvI1drNcN6HShhd0w6+9p6KQ9JGUU6U63aQMIAvl+kyQ4aNfYI6MWoMBa7oZ83ktP5MvoETJX6qGYRsVdA06pKJdblM4omq1MvZMntbWkZKHy/mphflTQeCoLq8ek3p5SiaCWmiKhreiZZzWnaCsSLl652GIrOsw7WHQq5GRRTLpeLDAAdGTtjcYfp5ywboLK7N9EhYGSeT6bgxyrE0K2EVBiaYnjpZkgGF8MLdDxvacQ=="
    }
  ],
    "relevantList": [
      {
        "identity": "relevant",
        "stock": null,
        "occupation": null,
        "identityTypeS": null,
        "typesOfStakeholders": "LEGAL_REPRESENTATIVE",
        "surname": "汉",
        "surEname": "Han",
        "middleName": "尼",
        "middleEname": "Ni",
        "lastName": "拔",
        "lastEname": "Ba",
        "name": "汉尼拔",
        "engName": "HanNiBa",
        "nationality": "344",
        "genderls": "T",
        "birthTime": "2023-03-01 15:23:00",
        "documentType": "DRIVING_LICENSE",
        "certificateNum": "Wmjk95wY0Pg7WHw/hyBjeLDiVITnnTtC8BgSK02utAxtUldGg1/r0IquqOgTLlI34WAcyTRYsr0reSSY/BmzH+4RLG54i4qPZp2quNuxTiRXsrr39rlDVaAjN4YQWGs5Py+NvwwTrs69u9Bo/EWlXn+/Nu221k7ygouEi9OANQQ20rfP3Fmp3mttjKa/D5jlthx+JF+vZ3AiX/tytwzZLF8ajhedeBKSodJGyisnUi0ww6nLdY5I2IWzdMheZoy6EswzqdJ3Cghj76EnDkQ3UyD+5f6+1YAV6b38WygeqM/UAmeWYA+344ebsbHtYj1AEah5O+UT4XpVFpvMjkMkbw==",
        "startValidityDate": "2023-03-01 15:23:00",
        "validityDate": "2023-03-01 00:00:00",
        "address": "常住地址-详细地址",
        "countryId": "156",
        "addressState": "Anhui",
        "addressCity": "Bozhou",
        "addressPostalCode": "youbian",
        "companyTypeS": null,
        "residentAddressFiles": [
          {
            "fileName": "常住地址证明.jpg",
            "filePath": "https://t2581749.jpg"
          }
        ],
        "identityFiles": [
          {
            "fileName": "常住地址证明.jpg",
            "filePath": "https://16760174012581749.jpg"
          }
        ],
        "authorizationFiles": [
          {
            "fileName": "常住地址证明.jpg",
            "filePath": "https://0174012581749.jpg"
          }
        ]
      }
    ],
  "addressPostalCode": "SAL",
  "shareholderList": [
    {
        "countryId":"156",
      "companyTypeS": "LLC",
      "addressPostalCode": "youbian",
      "engName": "HanNiBa",
      "identityTypeS": "ENTERPRISE",
      "identity": "shareholder",
      "stock": 10,
      "addressCity": "Bozhou",
      "address": "常住地址-详细地址",
      "eName": "HanNiBa",
      "addressState": "Anhui",
      "startValidityDate": 1677655380958,
      "nationality": "344",
      "validityDate": 1677655380958,
      "name": "汉尼拔"
    }
  ],
  "websiteUrl": "www.qiqiang.com",
  "regType": 2,
  "isReceipt": 1,
  "incorporationTime": 1677655380955,
  "applets": "qiqiangmini",
  "address": "中国",
  "credentialsNum": "uz1C2g7WVmIUccSSfDjx+CE1Q1x24bfces1B42tXMZVkfsGyn0ixptT6aREAHEmgm6VBUvlVzrA6zSSqPEs81NERK12/8bvj9+u8KHNoJnvI1drNcN6HShhd0w6+9p6KQ9JGUU6U63aQMIAvl+kyQ4aNfYI6MWoMBa7oZ83ktP5MvoETJX6qGYRsVdA06pKJdblM4omq1MvZMntbWkZKHy/mphflTQeCoLq8ek3p5SiaCWmiKhreiZZzWnaCsSLl652GIrOsw7WHQq5GRRTLpeLDAAdGTtjcYfp5ywboLK7N9EhYGSeT6bgxyrE0K2EVBiaYnjpZkgGF8MLdDxvacQ==",
  "submitReview": false,
  "stores": [
    {
      "storeAddress": "旧厂街",
      "files": [
        {
          "fileName": "常住地址证明.jpg",
          "filePath": "https://760174012581749.jpg"
        }
      ],
      "storeName": "高启强鱼店",
      "storeArea": "156"
    },
    {
      "storeAddress": "旧厂街",
      "files": [
        {
          "fileName": "常住地址证明.jpg",
          "filePath": "https://0174012581749.jpg"
        }
      ],
      "storeName": "汉尼拔精品肉店",
      "storeArea": "156"
    }
  ],
  "officialAccountsName": "强盛兰公众号",
  "operationAddress": "中国",
  "addressState": "Anhui",
  "directorList": [
    {
      "lastName": "拔",
      "eMiddleName": "Ni",
      "occupation": "NON_EXECUTIVE_DIRECTOR",
      "documentType": "DRIVING_LICENSE",
      "birthTime": 1677655380958,
      "countryId": "156",
      "residentAddressFiles": [
        {
          "fileName": "常住地址证明.jpg",
          "filePath": "https://174012581749.jpg"
        }
      ],
      "addressPostalCode": "SAL",
      "engName": "HanNiBa",
      "identity": "director",
      "surname": "汉",
      "stock": 10,
      "eLastName": "Ba",
      "genderls": "T",
      "addressCity": "Bozhou",
      "address": "常住地址-详细地址",
      "eName": "HanNiBa",
      "surEname": "Han",
      "eSurname": "Han",
      "addressState": "Anhui",
      "startValidityDate": 1677655380958,
      "middleEname": "Ni",
      "nationality": "344",
      "lastEname": "Ba",
      "validityDate": 1677655380958,
      "name": "汉尼拔",
      "middleName": "尼",
      "identityFiles": [
        {
          "fileName": "常住地址证明.jpg",
          "filePath": "https://t174012581749.jpg"
        }
      ],
      "certificateNum": "uz1C2g7WVmIUccSSfDjx+CE1Q1x24bfces1B42tXMZVkfsGyn0ixptT6aREAHEmgm6VBUvlVzrA6zSSqPEs81NERK12/8bvj9+u8KHNoJnvI1drNcN6HShhd0w6+9p6KQ9JGUU6U63aQMIAvl+kyQ4aNfYI6MWoMBa7oZ83ktP5MvoETJX6qGYRsVdA06pKJdblM4omq1MvZMntbWkZKHy/mphflTQeCoLq8ek3p5SiaCWmiKhreiZZzWnaCsSLl652GIrOsw7WHQq5GRRTLpeLDAAdGTtjcYfp5ywboLK7N9EhYGSeT6bgxyrE0K2EVBiaYnjpZkgGF8MLdDxvacQ==",
      "certificateType": "domicile_certificate"
    }
  ],
  "incorporationFiles": [
    {
      "fileName": "常住地址证明.jpg",
      "filePath": "https://4012581749.jpg"
    }
  ],
  "websiteName": "qiqiang",
  "avgRemittance": 100000000,
  "credentialsStartTime": 1677655380955,
  "merchantCredentialsType": "OTHER",
  "rateFiles": [
    {
      "fileName": "常住地址证明.jpg",
      "filePath": "https://2581749.jpg"
    }
  ],
  "companyTypeS": "LLC",
  "contacts": [
    {
      "business": "sales",
      "phone": "uz1C2g7WVmIUccSSfDjx+CE1Q1x24bfces1B42tXMZVkfsGyn0ixptT6aREAHEmgm6VBUvlVzrA6zSSqPEs81NERK12/8bvj9+u8KHNoJnvI1drNcN6HShhd0w6+9p6KQ9JGUU6U63aQMIAvl+kyQ4aNfYI6MWoMBa7oZ83ktP5MvoETJX6qGYRsVdA06pKJdblM4omq1MvZMntbWkZKHy/mphflTQeCoLq8ek3p5SiaCWmiKhreiZZzWnaCsSLl652GIrOsw7WHQq5GRRTLpeLDAAdGTtjcYfp5ywboLK7N9EhYGSeT6bgxyrE0K2EVBiaYnjpZkgGF8MLdDxvacQ==",
      "responsible": "SALES",
      "name": "张三",
      "email": "zhang@222.com"
    }
  ],
  "countriesInvolved":true,
  "notOrIssuedOr":false
}
```

### 2.4 返回参数

| 参数名称 | 参数中文名称 | 类型 | 参数说明 | 是否必填 |
| -------- | ------------ | ------ | -------------------------- | -------- |
| code | 编码 | String | 接口返回编码 例：200 | M |
| msg | 返回信息 | String | 接口返回信息 例：成功 | M |
| data | 详细信息 | Object | 接口返回详细信息 | O |

#### 2.4.1 示例

```html
{
  "code": 200,
  "msg": "成功",
  "data": null
}
```

### 2.5 商户入网审核异步返回列表

注意：此表格的参数为NotifyUrl的服务器返回参数

| 参数名称 | 参数中文名称 | 类型 | 参数说明 |
| ----------------- | ------------ | ------ | ----------------------------------- |
| regName | 商户名称 | String | 商户名称 |
| regEngName | 商户英文名称 | String | 商户英文名称 |
| requisitionNumber | 商户请求单号 | String | 商户请求单号 |
| status | 状态 | String | SUCCESS：成功 FAILE：失败 |
| accountNo | 商户号 | String | 只有入网成功才会有返回 |
| notifyUrl | 通知地址 | String | 通知地址 |
| msgType | 通知类型 | String | 通知类型 例：MERCHANT_INCOMING |

#### 2.5.1 示例
```html
{
    "notifyUrl":"http://fsdifnsdifisf",
    "msgType":"MERCHANT_INCOMING",
    "regName": "张三",
    "regEngName": "ZhangSan",
    "requisitionNumber": "23494491",
    "status": "SUCCESS",
    "accountNo": "8xxxxx92"
}
```

## 3.查询入网详情

### 3.1功能描述

查询入网信息详情

### 3.2 接口地址

请求地址：/busniness/details
请求方式：POST

### 3.3请求参数

| 参数名称          | 参数中文名称 | 类型        | 参数说明 | 是否必填 |
| ----------------- | ------------ | ----------- | -------- | -------- |
| email             | 邮箱         | String(100) | 邮箱     | O        |
| requisitionNumber | 请求单号     | String(50)  | 请求单号 | O        |

注：邮箱和请求单号至少选填一个

#### 3.3.1 示例
```html
{
  "requisitionNumber": "1234",
  "email": "1234@123.com"
}
```

### 2.4 返回参数

| 参数名称 | 参数中文名称 | 参数说明                                 |
| -------- | ------------ | ---------------------------------------- |
| code     | 状态码       | 请求状态码，详见附录                     |
| msg      | 状态描述     | 状态描述                                 |
| data     | 数据信息     | 返回数据对象信息，在请求状态为成功时返回 |

data:

| 参数名称 | 参数中文名称 | 类型/长度 | 参数说明 |
| -------------------------- | -------------------------------- | ------------------- | ------------------------------------------------------------ |
| regTypeS | 类型（个人/企业） | String（20） | PERSONAL:个人资料 ENTERPRISE:公司资料 例：ENTERPRISE |
| contractEntityS | TE签约主体 | String（3） | 当regTypeS为ENTERPRISE时必填 TE签约主体 SAL：SINO ALLIED (HK) Limited TKL：TransferEasy KAZ Limited TUI：TransferEasy USA INC 例：SAL |
| occupation | 个人职业 | String（50） | 当regTypeS为PERSONAL时必填 |
| email | 邮箱 | String（100） | 必填 邮箱 例：232xxxxx334@ qq.com |
| phone | 联系电话 | String（50） | 联系电话，必填 例：1736728393 |
| regName | 名称 | String（100） | 当regTypeS为PERSONAL时，填写个人名称全称 当regTypeS为ENTERPRISE时，填写企业法定名称 例：陈平安 |
| regEngName | 英文名称 | String（100） | 当regTypeS为PERSONAL时，填写个人名称全称英文 当regTypeS为ENTERPRISE时，填写企业法定名称英文 例：ChenPingAn |
| tradeName | 别名/商用名称 | String（100） | 当regTypeS为ENTERPRISE时选填 别名/商用名称 例：安全 |
| companyTypeS | 企业类型 | String（10） | 当regTypeS为ENTERPRISE时必填 IEN：个体企业 SOE：国有企业 NGO：非政府组织/慈善机构 LCO：上市公司 PRE：个人投资 PAR：合伙人 INC：股份有限公司 LLC：有限责任公司 例：LLC |
| companyIndustryS | 企业所属行业 | Integer（5） | 当regTypeS为ENTERPRISE时需要填写，必填 4121:旅游、运输、住宿及物流 5943:办公、工业、汽车以药品器械灯专用品商店 br /> 5712:生活方式及零售类商店 7379:互联网计算机及电子服务 5047:医疗、教育、咨询等专业服务 7299:商业及其他类服务 例：7299 |
| merchantCredentialsType | 企业证件类型 | String（10） | 当regTypeS为ENTERPRISE时必填 BRC:商业注册登记 OTHER:其它有相同效力的文件 TRC：税务登记证（大陆） COI：公司成立证明 COITC：企业三证合一证照（大陆） USC：统一社会信用代码证（大陆） RCS：社会团体法人登记证明（大陆） IBI：个体工商户营业执照（大陆） BRCM：商业登记证（大陆） 例：OTHER |
| personalCredentialsType | 个人证件类型 | String（40） | 当regTypeS为PERSONAL时必填 DRIVING_LICENSE：驾照 HONGKONG_PERMANENT_IDCARD：香港永久身份证 PASSPORT：护照 IDENTITY_CARD：身份证 OTHER：其他 例：HONGKONG_PERMANENT_IDCARD |
| credentialsNum | 证件号 | String（255） | 必填 证件号码 例：8288xxxxx2833 |
| credentialsStartTime | 证件有效期开始时间 | Date | 必填 证件有效期日期 例：2022-12-29 |
| credentialsValidityTime | 证件有效期截止时间 | Date | 必填 证件有效期截止日期 例：2022-12-29 |
| incorporationTime | 企业成立日期 | Date | 成当regTypeS为ENTERPRISE时必填 立日期 例：2022-12-29 |
| companyWebsite | 公司网站 | String（100） | 当regTypeS为ENTERPRISE时选填 公司网址 |
| businessIntroduction | 企业及业务介绍 | String（1000） | 当regTypeS为ENTERPRISE时必填 企业及业务介绍 例：本司运输为主 |
| address | 个人常住地址/企业注册地址 | String（255） | 必填 注册详细地址 例：中国北京海淀苏州街 |
| countryId | 个人常住地址/企业注册地址 | String（9） | 必填 注册地国家 地区请填写ISO国际标准的国家编号 例：784 表示：阿拉伯联合酋长国 |
| addressState | 个人常住地址/企业注册地址 | String（255） | 必填 注册地州/省 例：Al Anbar Governorate |
| addressCity | 个人常住地址/企业注册地址 | String（30） | 必填 注册地址城市 例：‘Anah |
| addressPostalCode | 个人常住地址/企业注册地址 | String（20） | 必填 注册地址邮编 例：92938882 |
| operationAddress | 运营地址 | String（255） | 当regTypeS为ENTERPRISE时必填 公司运营详细地址 例：中国北京海淀 |
| operationCountryId | 运营地址 | String（10） | 当regTypeS为ENTERPRISE时必填 运营国家地区 地区请填写ISO国际标准的国家编号 例：784 表示：阿拉伯联合酋长国 |
| operationAddressState | 运营地址 | String（255） | 当regTypeS为ENTERPRISE时必填 运营地址州/省 例：Al Anbar Governorate |
| operationAddressCity | 运营地址 | String（30） | 当regTypeS为ENTERPRISE时必填 运营地址城市 例：‘Anah |
| operationAddressPostalCode | 运营地址 | String（20） | 当regTypeS为ENTERPRISE时必填 运营地址邮编 |
| developCountryCode | 企业主要展业国家 | String（255） | 当regTypeS为ENTERPRISE时必填 请填写ISO国际标准的国家编号，多地区用逗号隔开 例：020 表示：安道尔 |
| wealthSource | 财富和资金来源 | String（1000） | 必填 财富和资金来源 例：出售货物 |
| accountPurpose | 开立账户或建立业务关系的目的 | String（1000） | 必填 开立账户或建立业务关系的目的 例：世界和平 |
| purposeType | 开立账户或建立业务关系的目的类型 | Integer（5） | 当regTypeS为PERSONAL时必填 523:家庭支持/生活费用 524:存款/投资 525:礼物 526:商品和服务支付/商业买卖 527:差旅费用 528:教育/学费 529:租金/房屋抵押贷款 530:紧急/医疗救助 531:慈善/援助付款 532:奖励或彩票费用/税收 533:其它-请描述 例：530 |
| expectedCurrency | 预期的交易币种 | String（100） | 必填 多币种是逗号分隔 例：USD,EUR |
| receiptSourceCountry | 收款资金的来源地 | String（100） | 必填 如果涉及多地区，逗号分隔收款资金的来源地 地区请填写ISO国际标准的国家编号 例：004,020 代表的是：阿富汗，安道尔 |
| yearRemittance | 预计年收付款金额 | BigDecimal（100） | 必填 币种：USD 预计年汇款额度,最大可有两位小数 例：1000 表示1000.00USD |
| avgRemittance | 平均单笔收付款金额 | BigDecimal（16，3） | 必填 币种：USD 最大可填写两位小数 例：10 表示：10.00USD |
| remittancePurposeCountry | 汇款资金的目的地 | String（255） | 必填 汇款资金的目的地，多地区请用逗号隔开 例：368,020 表示：伊拉克，安道尔 |
| directorList | 董事信息 | arry | 当regTypeS为ENTERPRISE时必填 |
| shareholderList | 股东信息 | arry | 当regTypeS为ENTERPRISE时必填 |
| controlList | 实际控制人信息 | arry | 当regTypeS为ENTERPRISE时必填 |
| relevantList | 利益相关方信息 | arry | 当regTypeS为ENTERPRISE时选填 |
| companyFiles | 企业概况披露文件 | arry | 当regTypeS为ENTERPRISE时必填 信息填写必须是通过本地上传文件接口返回信息 官方出具的披露公司董事、高级管理人员及股东的文件 |
| structureFiles | 企业股权架构 | arry | 当regTypeS为ENTERPRISE时必填 信息填写必须是通过本地上传文件接口返回信息 请披露到持股在 25%及以上(≥25%)的自然人(公司有两层及以上股权架构适用) |
| companyBankFiles | 企业银行账户开户证明 | arry | 当regTypeS为ENTERPRISE时选填 填写证明文件地址，填写信息必须是通过本司上传文件返回的信息 开户证明或月结单[优先]或银行对账单,对账单或月结单须在90天有效期内或三个月内企业公户的银行对账单或最近的网银截屏。 |
| incorporationFiles | 企业注册证明 | arry | 当regTypeS为ENTERPRISE时必填 信息填写必须是通过本地上传文件接口返回信息 支持Certificate of Incorporation、Business Registration等，中国大陆企业为统一信用代码证，需在有效期内。 |
| operationAddressFiles | 运营地址证明 | arry | 当regTypeS为ENTERPRISE时必填 信息填写必须是通过本地上传文件接口返回信息 例如水、电、燃气费账单或固定电话账单或网络费用账单或公司银行对账单或税务及社保缴费账单或房租发票，租房合同等 |
| applicationFiles | 申请表扫描件 | arry | 必填 信息填写必须是通过本地上传文件接口返回信息 |
| premisesFiles | 经营场所照片 | arry | 当regTypeS为ENTERPRISE时选填 信息填写必须是通过本地上传文件接口返回信息 |
| certificatePhotoFiles | 手持证件照照片 | arry | 当regTypeS为PERSONAL时必填 信息填写必须是通过本地上传文件接口返回信息 |
| rateFiles | 费率表 | arry | 必填 信息填写必须是通过本地上传文件接口返回信息 |
| files | 其他文件 | arry | 选填 信息填写必须是通过本地上传文件接口返回信息 |
| contacts | 联系信息 | arry | 当regTypeS为ENTERPRISE时必填 |
| sReceiptSyle | 是否是收单业务 | Boolean（10） | 当regTypeS为ENTERPRISE时选填 FALSE：否， TRUE：是 例：TRUE |
| dockingMethodSly | 申请产品（对接方式） | String（10） | 当regTypeS为ENTERPRISE，且isReceiptS为TRUE时选填 取值为三种业务类型： ONLINE：线上 OFFLINE：线下 BOTH：线上和线下 例：BOTH |
| regAbbreviationName | 申请产品（商户简称） | String（50） | 当regTypeS为ENTERPRISE时，且dockingMethodSly为ONLINE时必填 例：JC |
| app | 申请产品（app） | String（255） | 当regType为ENTERPRISE时，且dockingMethodSly为ONLINE时选填 例：8338393 |
| appIds | 申请产品（appID） | String（100） | 当regType为ENTERPRISE时，且dockingMethodSly为ONLINE时必填 例：92477489 |
| websiteUrl | 申请产品（网址） | String（1000） | 当regType为ENTERPRISE时，且dockingMethodSly为ONLINE时必填 例：http://百/sdinfn |
| applets | 申请产品（小程序） | String（255） | 当regType为ENTERPRISE时，且dockingMethodSly为ONLINE时选填 例：xiaochengxu |
| officialAccountsName | 申请产品（公众号名称） | String（100） | 当regType为ENTERPRISE时，且dockingMethodSly为ONLINE时选填 |
| websiteName | 申请产品（网站名称） | String（255） | 当regType为ENTERPRISE时，且dockingMethodSly为ONLINE时选填 |
| stores | 线下门店信息 | arry | 当regType为ENTERPRISE时，且dockingMethodSly为OFFLINE时必填 当对接方式为线下时可填 |
| surname | 姓氏 | String（40） | 当regType为PERSONAL时必填 |
| lastName | 姓氏英文 | String（40） | 当regType为PERSONAL时必填 |
| middleName | 中间名字 | String（40） | 当regType为PERSONAL时选填 |
| middleEngName | 中间名字英语 | String（40） | 当regType为PERSONAL时选填 |
| name | 名字的字 | String（80） | 当regType为PERSONAL时必填 |
| firstName | 名字的字英文 | String（80） | 当regType为PERSONAL时必填 |
| previousName | 曾用名 | String（50） | 当regType为PERSONAL时选填 |
| nationality | 国籍 | String（20） | 当regType为PERSONAL时必填 |
| genderls | 性别 | String（2） | 当regType为PERSONAL时必填 T:男， O:女， S:未知 例：S |
| dateOfBirth | 出生日期 | String（20） | 当regTypeS为PERSONAL时需要填写，必填 出生日期，格式：yyyy-MM-dd 例：2022-01-02 |
| countriesInvolved | 业务是否涉及的国家 | Boolean | 涉及国家：白俄罗斯、乌克兰卢甘斯克地区、乌克兰顿涅茨克地区、克里米亚、伊朗、北朝鲜、缅甸、苏丹、南苏丹、叙利亚、古巴、利比亚、委内瑞拉。 |
| notOrIssuedOr | 是否可发行或已发行不记名股票/持票人股份 | Boolean | 当regTypeS为PERSONAL时选填 是否可发行或已发行不记名股票/持票人股份 |

董事、股东、实际控制人、利益相关人相关信息
directorList、shareholderList、controlList、relevantList：

| 参数名称 | 参数中文名称 | 类型 | 参数说明 |
| -------------------- | ----------------------- | ------------------- | ------------------------------------------------------------ |
| identity | 身份 | String（20） | 身份 director：董事信息 shareholder：股东信息 controller：实际控制人信息 relevant：利益相关人信息 例：director |
| stock | 股份占比 | BigDecimal（10，6） | 股份占比 当identity为director时必填 当identity为shareholder时必填 当identity为controller时必填 |
| occupation | 职位 | String（50） | 职位 当identity为director时必填 NON_EXECUTIVE_DIRECTOR：非执行董事 EXECUTIVE_DIRECTOR：执行董事 例：EXECUTIVE_DIRECTOR |
| identityTypeS | 股东类型/实际控制人类型 | String（20） | 股东类型/实际控制人类型 当identity为shareholder时必填 当identity为controller时必填 PERSONAL：个人 ENTERPRISE：企业 例：PERSONAL |
| companyTypeS | 企业类型 | String（10） | 企业类型 当identity为shareholder，且identityTypeS为ENTERPRISE时必填 当identity为controller，且identityTypeS为ENTERPRISE时必填 IEN：个体企业 SOE：国有企业 NGO：非政府组织/慈善机构 LCO：上市公司 PRE：个人投资 PAR：合伙人 INC：股份有限公司 LLC：有限责任公司 例：LLC |
| typesOfStakeholders | 利益相关方类型 | String（30） | 利益相关方类型 当identity为relevant时必填 ACCOUNT_AUTHORIZER：账户授权人 LEGAL_REPRESENTATIVE：法定代表人 AUTHORIZED_SIGNATORY：有权签字人 例：AUTHORIZED_SIGNATORY |
| surname | 姓氏 | String（40） | 姓氏 当identity为director时必填 当identity为shareholder，且identityTypeS为PERSONAL时必填 当identity为controller，且identityTypeS为PERSONAL时必填 当identity为relevant时必填 |
| surEname | 姓氏英文 | String（40） | 姓氏英语 当identity为director时必填 当identity为shareholder，且identityTypeS为PERSONAL时必填 当identity为controller，且identityTypeS为PERSONAL时必填 当identity为relevant时必填 |
| middleName | 中间名字 | String（40） | 中间名字 当identity为shareholder，且identityTypeS为PERSONAL时选填 当identity为controller，且identityTypeS为PERSONAL时选填 当identity为relevant时选填 |
| middleEname | 中间名字英文 | String（40） | 中间名字英文 当identity为shareholder，且identityTypeS为PERSONAL时选填 当identity为controller，且identityTypeS为PERSONAL时选填 当identity为relevant时选填 |
| lastName | 姓名的名 | String（40） | 姓名的名 当identity为director时必填 当identity为shareholder，且identityTypeS为PERSONAL时必填 当identity为controller，且identityTypeS为PERSONAL时必填 当identity为relevant时必填 |
| lastEname | 姓名的名英文 | String（40） | 姓名的名英文 当identity为director时必填 当identity为shareholder，且identityTypeS为PERSONAL时必填 当identity为controller，且identityTypeS为PERSONAL时必填 当identity为relevant时必填 |
| name | 姓名 | String（80） | 姓名 当identity为director时必填 当identity为shareholder，且identityTypeS为PERSONAL时必填，且填写个人姓名 当identity为shareholder，且identityTypeS为ENTERPRISE时必填，填写企业法定名称。 当identity为controller，且identityTypeS为PERSONAL时必填，填写个人姓名 当identity为controller，且identityTypeS为ENTERPRISE时必填，填写企业法定名称 当identity为relevant时必填 |
| engName | 姓名英文 | String（80） | 姓名英文 当identity为director时必填 当identity为shareholder，且identityTypeS为PERSONAL时必填，填写个人姓名英文。 当identity为shareholder，且identityTypeS为ENTERPRISE时必填，填写企业法定名称。 当identity为controller，且identityTypeS为PERSONAL时必填，填写个人姓名英文 当identity为controller，且identityTypeS为ENTERPRISE时必填，填写企业法定名称英文 当identity为relevant时必填 |
| nationality | 国籍 | String（10） | 国籍 当identity为director时必填 当identity为shareholder，且identityTypeS为PERSONAL时必填。 当identity为controller，且identityTypeS为PERSONAL时必填，填写个人国籍 当identity为relevant时必填 例：020 表示：安道尔 |
| genderls | 性别 | String（2） | 性别 当identity为director时必填 当identity为shareholder，且identityTypeS为PERSONAL时必填 当identity为controller，且identityTypeS为PERSONAL时必填，填写个人性别 当identity为relevant时必填 T:男 O:女 S:未知 例：S |
| birthTime | 出生日期 | Date | 出生日期 时间格式：yyyy-MM-dd 当identity为shareholder，且identityTypeS为PERSONAL时必填。 当identity为controller，且identityTypeS为PERSONAL时必填，填写个人出生日期。 当identity为director时必填 当identity为relevant时必填 |
| documentType | 证件类型 | String（40） | 证件类型 当identity为director时必填 当identity为shareholder，且identityTypeS为PERSONAL时必填。 当identity为controller，且identityTypeS为PERSONAL时必填，填写个人证件类型。 当identity为relevant时必填 DRIVING_LICENSE：驾照 HONGKONG_PERMANENT_IDCARD：香港永久身份证 PASSPORT：护照 IDENTITY_CARD：身份证 OTHER：其他 例：HONGKONG_PERMANENT_IDCARD |
| certificateNum | 证件号 | String（255） | 证件号码 当identity为director时必填 当identity为shareholder，且identityTypeS为PERSONAL时必填。 当identity为controller，且identityTypeS为PERSONAL时必填，填写个人证件号。 当identity为relevant时必填 例：22838372 |
| startValidityDate | 证件有效期开始时间 | Date | 证件有效期开始时间 当identity为director时必填。 当identity为shareholder，且identityTypeS为PERSONAL时必填。 当identity为controller，且identityTypeS为PERSONAL时必填，填写个人证件有效期开始时间。 当identity为relevant时必填 时间格式：yyyy-MM-dd |
| validityDate | 证件有效期结束时间 | Date | 证件有效期结束时间 当identity为director时必填 当identity为shareholder，且identityTypeS为PERSONAL时必填 当identity为controller，且identityTypeS为PERSONAL时必填，填写个人证件有效期结束时间。 当identity为relevant时必填 时间格式：yyyy-MM-dd |
| address | 常住地址 | String（255） | 详细地址 当identity为director时必填 当identity为shareholder，且identityTypeS为PERSONAL时必填，填写个人常住详细地址 当identity为shareholder，且identityTypeS为ENTERPRISE时必填，填写企业注册详细地址 当identity为controller，且identityTypeS为PERSONAL时必填，填写个人常驻详细地址。 当identity为controller，且identityTypeS为ENTERPRISE时必填，填写企业注册详细地址 当identity为relevant时必填 |
| countryId | 常住地址 | String（5） | 国家/地区 当identity为director时必填 当identity为shareholder，且identityTypeS为PERSONAL时必填，填写个人常住国家 当identity为shareholder，且identityTypeS为ENTERPRISE时必填，填写企业注册国家 当identity为controller，且identityTypeS为PERSONAL时必填，填写个人常住地区所属国家。 当identity为controller，且identityTypeS为ENTERPRISE时必填，填写企业注册国家 当identity为relevant时必填 例：020 表示：安道尔 |
| addressState | 常住地址 | String（50） | 省/州 当identity为director时必填 当identity为shareholder，且identityTypeS为PERSONAL时必填，填写个人常住州/省 当identity为shareholder，且identityTypeS为ENTERPRISE时必填，填写企业注册州/省 当identity为controller，且identityTypeS为PERSONAL时必填，填写个人常住地区所属省/州。 当identity为controller，且identityTypeS为ENTERPRISE时必填，填写企业注册省/州 当identity为relevant时必填 |
| addressCity | 常住地址 | String（50） | 城市 当identity为director时必填。 当identity为shareholder，且identityTypeS为PERSONAL时必填，填写个人常住城市。 当identity为shareholder，且identityTypeS为ENTERPRISE时必填，填写企业注册城市 当identity为controller，且identityTypeS为PERSONAL时必填，填写个人常住地区所属城市。 当identity为controller，且identityTypeS为ENTERPRISE时必填，填写企业注册城市 当identity为relevant时必填 |
| addressPostalCode | 常住地址 | String（50） | 邮编 当identity为director时必填。 当identity为shareholder，且identityTypeS为PERSONAL时必填，填写个人常住地区邮编。 当identity为shareholder，且identityTypeS为ENTERPRISE时必填，填写企业注册国地区邮编 当identity为controller，且identityTypeS为PERSONAL时必填，填写个人常住地区邮编。 当identity为controller，且identityTypeS为ENTERPRISE时必填，填写企业注册邮编 当identity为relevant时必填 |
| identityFiles | 身份证明 | arry<object> | 身份证明 当identity为director时必填 当identity为shareholder，且identityTypeS为PERSONAL时必填 当identity为controller，且identityTypeS为PERSONAL时必填 当identity为relevant时必填 |
| residentAddressFiles | 常驻地址证明 | arry<object> | 常住地址证明 当identity为director时必填 当identity为shareholder，且identityTypeS为PERSONAL时必填 当identity为controller，且identityTypeS为PERSONAL时必填 当identity为relevant时必填 常驻地址证明 |
| authorizationFiles | 授权函 | arry<object> | 授权函 当identity为relevant时必填 |

contacts：联系信息

| 参数名称 | 参数中文名称 | 类型 | 参数说明 |
| ----------- | ------------ | ------------- | ------------------------------------------------------------ |
| name | 姓名 | String（55） | 联系人姓名 例：张三 |
| phone | 电话 | String（255） | 联系人电话 例：183xxxxx1173 |
| responsible | 负责业务 | String（55） | 联系人负责业务 SALES：业务 TECHNOLOGY：技术 FINANCE：财务 CUSTOMERSERVICE：客服 RISK：风险 例：RISK |
| email | 邮箱 | String（100） | 联系人邮箱 例：823781@q q.com |

stores：申请产品--线下--商店信息

| 参数名称 | 参数中文名称 | 类型/长度 | 参数说明 |
| ------------ | ------------ | ------------- | ----------------------------------------------- |
| storeName | 店铺名称 | String（255） | 线下商店名称 例：正宗螺丝混 |
| storeArea | 商店所处国家 | String（5） | 线下商店所处国家 例：020 表示：安道尔 |
| storeAddress | 店铺详细地址 | String（255） | 门店详细地址 例：中国北京昌平 |
| files | 门店图片 | arry | 信息填写必须是通过本地上传文件接口返回信息 |

companyBankFiles、operationAddressFiles、applicationFiles、structureFiles、companyFiles、files、incorporationFiles、premisesFiles、residentAddressFiles、identityFiles、authorizationFiles、certificatePhotoFiles

传输文件信息

| 参数名称 | 参数中文名称 | 类型/长度 | 参数说明 |
| -------- | ------------ | ------------- | --------------------------------------------------- |
| fileName | 文件名称 | String（255） | 文件名称 例：开户证明.jpg |
| filePath | 文件地址 | String（255） | 文件地址 例：https://开户证明/29/zhengming.jpg |

#### 3.4.1 示例
```html
{
    "code": 200,
    "msg": "成功",
    "data": {
        "regTypeS": "ENTERPRISE",
        "contractEntityS": "SAL",
        "occupation": null,
        "email": "1834568929@182.com",
        "phone": "gJAP+jsS9puskrO8Fvhzl11gf1DxfQ+OzbbLuP8gm5AYPwbTSq9C9lMNsBYtTQ4MTq/a7//4Uva2rHmfgJ1Y7yO5lqfGgrTPG4HegF2TZS0Du8f0TavtqMSTa8U7+bLVaa50FxZGsjOjYCe4t9PsyTCGxBjGXDxIuqYOppEzO2lQAxn6LgneBJ5UkU4ij2x+/pFrChucDx2qdpFbiRnACD+ZZUqLgyh3dbTF3hmvC1r7Eeni9fAi+rRDZmZyS9nMrdE7q0C9U6LftwZwOyWxkEYi3gQCbIN1KpLhlhmXnA92rZvFY2ptlO+Kr0OLw5RcvHNQ9B6yN6EASM967lkcLg==",
        "regName": "赵四",
        "regEngName": "英文名称",
        "tradeName": null,
        "companyTypeS": "LLC",
        "companyIndustryS": 4121,
        "merchantCredentialsType": "OTHER",
        "personalCredentialsType": null,
        "credentialsNum": "2345678",
        "credentialsStartTime": "2023-03-01 15:23:00",
        "credentialsValidityTime": "2023-03-01 15:23:00",
        "incorporationTime": "2023-03-01 15:23:00",
        "companyWebsite": null,
        "businessIntroduction": "企业及业务介绍",
        "address": "中国",
        "countryId": "156",
        "addressState": "Anhui",
        "addressCity": "Bozhou",
        "addressPostalCode": "SAL",
        "operationAddress": "中国",
        "operationCountryId": "156",
        "operationAddressState": "Anhui",
        "operationAddressCity": "Bozhou",
        "operationAddressPostalCode": "yobian",
        "developCountryCode": "344,156",
        "wealthSource": "资金来源",
        "purposeType": null,
        "accountPurpose": "开立账户或建立业务关系的目的",
        "countriesInvolved": true,
        "notOrIssuedOr": false,
        "expectedCurrency": "USD",
        "receiptSourceCountry": "156,344",
        "yearRemittance": 100000000.000,
        "avgRemittance": 100000000.000,
        "remittancePurposeCountry": "156,344",
        "surname": null,
        "lastName": "Han",
        "middleName": null,
        "middleEngName": null,
        "name": null,
        "firstName": "Ba",
        "previousName": null,
        "nationality": null,
        "genderls": null,
        "dateOfBirth": null,
        "directorList": [
            {
                "identity": "director",
                "stock": 10.000000,
                "occupation": "NON_EXECUTIVE_DIRECTOR",
                "identityTypeS": null,
                "typesOfStakeholders": null,
                "surname": "汉",
                "surEname": "Han",
                "middleName": "尼",
                "middleEname": "Ni",
                "lastName": "拔",
                "lastEname": "Ba",
                "name": "汉尼拔",
                "engName": "HanNiBa",
                "nationality": "344",
                "genderls": "T",
                "birthTime": "2023-03-01 15:23:00",
                "documentType": null,
                "certificateNum": "q/TlNkxoB1KavYeDCBLwoW5UFWYcUa9RuIiDWaVitbiUykzEou1WvFps2/pJKLfMejDOqpApJzIX/TXCDXk8IHYJnLqKmfHD71rfiyvgSxlwBZDXP4wZgSimcXVORU2LxqwngSU83aJVfqK/04b/7x4EOKdLdoKIY9c2IkekttNeOrBJzpt8yTTgTi71RYyz4NMIGA3NcFEKs271LC0cG7OKcHX3JI1e2hypByfAMqoJKO5w47wmUXu/NvTR3mb0PHll/oxtkBChkBRi2DOJLg9yC+2vTYAWgSDYvoksJ3RzD4jmFw3kQOp9YkJUpcQ6nQXd6otVo4jeZBMAr4GcXg==",
                "startValidityDate": "2023-03-01 15:23:00",
                "validityDate": "2023-03-01 00:00:00",
                "address": "常住地址-详细地址",
                "countryId": "156",
                "addressState": "Anhui",
                "addressCity": "Bozhou",
                "addressPostalCode": "SAL",
                "companyTypeS": null,
                "residentAddressFiles": [
                    {
                        "fileName": "常住地址证明.jpg",
                        "filePath": "https://16760174012581749.jpg"
                    }
                ],
                "identityFiles": [
                    {
                        "fileName": "常住地址证明.jpg",
                        "filePath": "https://16760174012581749.jpg"
                    }
                ],
                "authorizationFiles": null
            }
        ],
        "shareholderList": [
            {
                "identity": "shareholder",
                "stock": 10.000000,
                "occupation": null,
                "identityTypeS": "ENTERPRISE",
                "typesOfStakeholders": null,
                "surname": null,
                "surEname": null,
                "middleName": null,
                "middleEname": null,
                "lastName": null,
                "lastEname": null,
                "name": "汉尼拔",
                "engName": "HanNiBa",
                "nationality": "344",
                "genderls": null,
                "birthTime": null,
                "documentType": null,
                "certificateNum": null,
                "startValidityDate": "2023-03-01 15:23:00",
                "validityDate": "2023-03-01 00:00:00",
                "address": "常住地址-详细地址",
                "countryId": "156",
                "addressState": "Anhui",
                "addressCity": "Bozhou",
                "addressPostalCode": "youbian",
                "companyTypeS": "LLC",
                "residentAddressFiles": null,
                "identityFiles": null,
                "authorizationFiles": null
            }
        ],
        "controlList": [
            {
                "identity": "controller",
                "stock": 10.000000,
                "occupation": null,
                "identityTypeS": "PERSONAL",
                "typesOfStakeholders": null,
                "surname": "汉",
                "surEname": "Han",
                "middleName": "尼",
                "middleEname": "Ni",
                "lastName": "拔",
                "lastEname": "Ba",
                "name": "汉尼拔",
                "engName": "HanNiBa",
                "nationality": "344",
                "genderls": "T",
                "birthTime": "2023-03-01 15:23:00",
                "documentType": "DRIVING_LICENSE",
                "certificateNum": "jlOAB+TGHBUff4k/N6Lw+EnEp2fItLoJTQFAU5RSjz1da660TdVk58uCbvv8gbVM1Ec3SySk+77BnePOCKXntAL4tpUhQsn+opa7CC2g6xoeuuZs8zRg5uFrzRWfIUoKX5/IgGfvaMF0ITgyDJsI9Pnf4D+RIMDxmdfIakBT5L+2P+mCtEDUVs3Q8Hu6OCMN7YPGtS7DZLjfFPkKsD5GB/DRz9lixsw8VhQWffS/y7sJBT9gFBCiS5ro+GQZR+A5IKLkavItcpJpDyK8yXDTcXuYjgO5/WyIqDRprnkMRf1ucyX8W33Xy0To8YoxNGcHrZWuNV7ZsR5i3B0RiYC1BA==",
                "startValidityDate": "2023-03-01 15:23:00",
                "validityDate": "2023-03-01 00:00:00",
                "address": "常住地址-详细地址",
                "countryId": "156",
                "addressState": "Anhui",
                "addressCity": "Bozhou",
                "addressPostalCode": "youbian",
                "companyTypeS": null,
                "residentAddressFiles": [
                    {
                        "fileName": "常住地址证明.jpg",
                        "filePath": "https://74012581749.jpg"
                    }
                ],
                "identityFiles": [
                    {
                        "fileName": "常住地址证明.jpg",
                        "filePath": "https://6760174012581749.jpg"
                    }
                ],
                "authorizationFiles": null
            }
        ],
        "relevantList": null,
        "companyFiles": [
            {
                "fileName": "常住地址证明.jpg",
                "filePath": "https://581749.jpg"
            }
        ],
        "structureFiles": [
            {
                "fileName": "常住地址证明.jpg",
                "filePath": "https://0174012581749.jpg"
            }
        ],
        "companyBankFiles": null,
        "incorporationFiles": [
            {
                "fileName": "常住地址证明.jpg",
                "filePath": "https://UARY/10/16760174012581749.jpg"
            }
        ],
        "operationAddressFiles": [
            {
                "fileName": "常住地址证明.jpg",
                "filePath": "https://174012581749.jpg"
            }
        ],
        "applicationFiles": [
            {
                "fileName": "常住地址证明.jpg",
                "filePath": "https://6760174012581749.jpg"
            }
        ],
        "premisesFiles": null,
        "rateFiles": [
            {
                "fileName": "常住地址证明.jpg",
                "filePath": "https://RY/10/16760174012581749.jpg"
            }
        ],
        "files": [
            {
                "fileName": "常住地址证明.jpg",
                "filePath": "https://FEBRUARY/10/16760174012581749.jpg"
            }
        ],
        "certificatePhotoFiles": null,
        "identityFiles": null,
        "residentAddressFiles": null,
        "contacts": null,
        "receipt": true,
        "dockingMethodSly": "BOTH",
        "regAbbreviationName": "zhutijiancheng",
        "app": "qiqiangapp",
        "appIds": "appid",
        "websiteUrl": "www.qiqiang.com",
        "applets": "qiqiangmini",
        "officialAccountsName": "测试公众号",
        "websiteName": "qiqiang",
        "stores": [
            {
                "storeName": "测试商店",
                "storeArea": "156",
                "storeAddress": "旧厂街",
                "files": [
                    {
                        "fileName": "常住地址证明.jpg",
                        "filePath": "https://Z9ArZN0aHJw%3D"
                    }
                ]
            },
            {
                "storeName": "测试商店2",
                "storeArea": "156",
                "storeAddress": "旧厂街",
                "files": [
                    {
                        "fileName": "常住地址证明.jpg",
                        "filePath": "https://p688jz74Fu8tTXP%2Be7%2BpdGE5E%3D"
                    }
                ]
            }
        ],
        "requisitionNumber": "12345678929"
    }
}
```

## 4.账户查询

### 4.1 功能描述

查询账户信息

### 4.2 接口地址

请求地址：/account/accountInfo
请求方式：POST

### 4.3 返回参数

| 参数名称 | 参数中文名称 | 类型 | 参数说明 |
| -------- | ------------ | ------ | -------------------------- |
| code | 编码 | String | 接口返回编码 例：200 |
| msg | 返回信息 | String | 接口返回信息 例：成功 |
| data | 详细信息 | Object | 接口返回详细信息 |

data:

| 参数名称 | 参数中文名称 | 类型 | 参数说明 |
| ----------- | ------------ | ------- | ------------------------------------------------------------ |
| accountName | 商户名称 | String | 接口返回编码 例：200 |
| email | 邮箱 | String | 邮箱 |
| status | 状态 | String | 账户状态 |
| mobile | 电话 | String | 电话 例：183892xxxx23 |
| accountNo | 商户ID号 | String | 商户ID号 |
| secret | 商户API 密钥 | String | 商户API 密钥 |
| payAuth | 免密支付 | Boolean | 注：开启此功能后,换汇、汇款订单会在下单时从余额中自动扣款。 true：开启 false：关闭 例：true |

#### 4.3.1 示例

```html
{
  "code": 200,
  "msg": "成功",
  "data": {
    "accountName": "Test ACCOUT",
    "email": "hu@transfereasy.com",
    "status": "新用户",
    "mobile": "OiqTtQ==",
    "accountNo": 8xxxxx8,
    "secret": "-----BEGIN PUBLIC KEY-----\nMIIBIjANBg2w3VKYoJp2rSjjQmZBB4RZesG9R\nwQIDAQAB\n-----END PUBLIC KEY-----",
    "payAuth": true
  }
}
```

## 5.创建收款人账户

### 5.1 功能描述

创建收款人账户

### 5.2 接口地址

请求地址：/account/creatBank
请求方式：POST

### 5.3 请求参数

| 参数名称 | 参数中文名称 | 类型 | 参数说明 | 是否必填 |
| ----------------- | ------------ | ------------- | ------------------------------------------------------------ | -------- |
| accountName | 账户名 | String（200） | 账户名 | M |
| bankAccountNum | 银行账号 | String（100） | 银行账号 | M |
| bankAddress | 银行所在地区 | String（20） | 银行所在地区 例：ARE | M |
| bankCurrency | 银行支持币种 | String（30） | 银行支持币种 例：USD | M |
| bankName | 银行名称 | String（255） | 银行名称 例：中国工商银行 | M |
| bankCode | 银行编号 | String（55） | 银行编号 注：银行所在地为香港时必填，格式为3位数字 | C |
| branchBankName | 分行名称 | String（255） | 分行名称 注：银行所在地为中国大陆时必填 例：分行名称 | C |
| branchCode | 分行编号 | String（55） | 分行编号 | C |
| swiftCode | swift_code | String（55） | SWIFTCODE 格式：必须为8或11位英文字母或阿拉伯数字组成 注：银行所在国家/地区为中国大陆地区开户时选填，否则为必填 | C |
| iban | iban | String（55） | IBAN 注：银行所在地为时欧洲国家必填，包括英国 | C |
| aba | aba | String（55） | ABA 注：银行所在地为时美国必填 | C |
| bsb | bsb | String（55） | BSB 注：银行所在地为时澳大利亚必填 | C |
| requisitionNumber | 请求单号 | String（50） | 请求单号 | M |

注：
	当需要填写swiftCode时，字段必须为8或11位英文字母或阿拉伯数字组成
	传输所需的国家地区信息可通过接口（查询国家、省、市、区）查询获取

#### 5.3.1 示例

```html
{
  "aba": "ceshi",
  "accountName": "ceshi",
  "bankAccountNum": "ceshi",
  "bankAddress": "ARE",
  "bankCurrency": "USD",
  "bankName": "ceshi",
  "branchBankName": "ceshi",
  "iban": "ceshi",
  "requisitionNumber": "26382328",
  "swiftCode": "sdsdsdsd",
  "bankCode":"29393",
  "bsb":"2303993",
  "branchCode":"122323"
}
```

### 5.4 返回参数

| 参数名称 | 参数中文名称 | 类型 | 参数说明 |
| -------- | ------------ | ------ | -------------------------- |
| code | 编码 | String | 接口返回编码 例：200 |
| msg | 返回信息 | String | 接口返回信息 例：成功 |
| data | 详细信息 | Object | 接口返回详细信息 |

#### 5.4.1 示例

```html
{
  "code": 200,
  "msg": "成功",
  "data": null
}
```

### 5.5 创建收款账户审核异步返回列表

注意：此表格的参数为NotifyUrl的服务器返回参数

| 参数名称 | 参数中文名称 | 类型 | 参数说明 |
| -------------- | ------------ | ------ | ------------------------------------------------------------ |
| accountType | 账户主体类型 | String | PERSONAL：个人 ENTERPRISE：企业 例：ENTERPRISE |
| bankAddress | 银行所在地区 | String | 银行所在地 例：USA |
| bankAccountNum | 银行账号 | String | 银行账号 例：123456789 |
| bankCurrency | 银行支持币种 | String | 支持币种 例：USD |
| accountName | 账户名 | String | 账户名 例：ZHMC |
| bankName | 银行名称 | String | 银行名称 例：中国工商银行 |
| branchBankName | 分行名称 | String | 分行名称 例：北京分行 |
| branchCode | 分行编号 | String | 分行编号 例：12342 |
| bankCode | 银行编号 | String | 银行编号 例：347438 |
| swiftCode | swift_code | String | swift_code |
| iban | iban | String | iban |
| aba | aba | String | aba |
| bsb | bsb | String | bsb |
| status | 状态 | String | AUTHENTICATING：正在审核认证中 NORMAL：正常 AUDITFAILED：审核失败 例：NORMAL |
| notifyUrl | 通知地址 | String | 通知地址 |
| msgType | 通知状态 | String | 通知状态 例：BANK_ACCOUNT |

#### 5.5.1 示例

```html
 {
      "notifyUrl":"http://fsdifnsdifisf",
      "msgType":"INNER_TRANS",
      "bankAddress": "USA",
      "bankAccountNum": "123456789",
      "bankCurrency": "USD",
      "accountName": "ZHMC",
      "bankName": "YHMC-MG",
      "branchBankName": null,
      "branchCode": null,
      "bankCode": null,
      "swiftCode": "12345678",
      "accountType": "ENTERPRISE",
      "iban": null,
      "aba": "123",
      "bsb": null,
      "status": "NORMAL"
}
```

## 6.删除收款人账户

### 6.1 功能描述

删除收款人账户

### 6.2 接口地址
请求地址：/account/removeBank
请求方式：POST

### 6.3 请求参数

| 参数名称          | 参数中文名称 | 类型   | 参数说明                                                     | 是否必填 |
| ----------------- | ------------ | ------ | ------------------------------------------------------------ | -------- |
| requisitionNumber | 请求编号     | String（50） | 创建收款账户时填写的请求编号                                 | M        |

#### 6.3.1 示例

```html
{
  "requisitionNumber": "26382328"
}
```

### 6.4 返回参数

| 参数名称 | 参数中文名称 | 类型 | 参数说明 | 是否必填 |
| -------- | ------------ | ------ | -------------------------- | -------- |
| code | 编码 | String | 接口返回编码 例：200 | M |
| msg | 返回信息 | String | 接口返回信息 例：成功 | M |
| data | 详细信息 | Object | 接口返回详细信息 | O |

#### 6.4.1 示例
```html
{
  "code": 200,
  "msg": "成功",
  "data": null
}
```

## 7.查询商户银行账户列表

### 7.1 功能描述

查询银行账户列表

### 7.2 接口地址

请求地址：/account/bank
请求方式：POST

### 7.3返回参数

| 参数名称 | 参数中文名称 | 类型 | 参数说明 |
| -------- | ------------ | ------ | -------------------------- |
| code | 编码 | String | 接口返回编码 例：200 |
| msg | 返回信息 | String | 接口返回信息 例：成功 |
| data | 详细信息 | Object | 接口返回详细信息 |

data：

| 参数名称 | 参数中文名称 | 类型 | 参数说明 |
| -------------- | ------------ | ------ | ------------------------------------------------------------ |
| accountType | 账户主体类型 | String | PERSONAL：个人 ENTERPRISE：企业 例：ENTERPRISE |
| bankAddress | 银行所在地区 | String | 银行所在地 例：USA |
| bankAccountNum | 银行账号 | String | 银行账号 例：123456789 |
| bankCurrency | 银行支持币种 | String | 支持币种 例：USD |
| accountName | 账户名 | String | 账户名 例：ZHMC |
| bankName | 银行名称 | String | 银行名称 例：中工商银行 |
| branchBankName | 分行名称 | String | 分行名称 例：北京分行 |
| branchCode | 分行编号 | String | 分行编号 例：12342 |
| bankCode | 银行编号 | String | 银行编号 例：347438 |
| swiftCode | swift_code | String | swift_code |
| iban | iban | String | iban |
| aba | aba | String | aba |
| bsb | bsb | String | bsb |
| status | 状态 | String | AUTHENTICATING：正在审核认证中 NORMAL：正常 AUDITFAILED：审核失败 例：NORMAL |

#### 7.3.1 示例

```html
{
  "code": 200,
  "msg": "成功",
  "data": [
    {
      "bankAddress": "USA",
      "bankAccountNum": "123456789",
      "bankCurrency": "USD",
      "accountName": "ZHMC",
      "bankName": "YHMC-MG",
      "branchBankName": null,
      "branchCode": null,
      "bankCode": null,
      "swiftCode": "12345678",
      "accountType": "ENTERPRISE",
      "iban": null,
      "aba": "123",
      "bsb": null,
      "status": "NORMAL"
    }
  ]
}
```

##  8.修改支付密码

### 8.1 功能描述

修改支付密码

### 8.2 接口地址

请求地址：/account/upPayPassword
请求方式：POST

### 8.3 请求参数

| 参数名称         | 参数中文名称 | 类型   | 参数说明                                                     | 是否必填 |
| ---------------- | ------------ | ------ | ------------------------------------------------------------ | -------- |
| payPasswordCode  | 验证码       | String | 验证码                                                       | M        |
| payPas           | 支付密码     | String | 支付密码                                                     | M        |
| username         | 邮箱         | String | 邮箱                                                         | M        |

#### 8.3.1 示例

```html
{
  "payPas": "913324",
  "payPasswordCode": "uN3f8X",
  "username": "zxxxx@tra.com"
}
```

### 8.4 返回参数

| 参数名称 | 参数中文名称 | 类型 | 参数说明 | 是否必填 |
| -------- | ------------ | ------ | -------------------------- | -------- |
| code | 编码 | String | 接口返回编码 例：200 | M |
| msg | 返回信息 | String | 接口返回信息 例：成功 | M |
| data | 详细信息 | Object | 接口返回详细信息 | O |

#### 8.4.1 示例
```html
{
  "code": 200,
  "msg": "成功",
  "data": null
}
```

## 9.上传API密钥

### 9.1 功能描述

上传API密钥

### 9.2 接口地址

请求地址：/account/uploadSecret
请求方式：POST

### 9.3 请求参数

| 参数名称         | 参数中文名称 | 类型   | 参数说明                                                     | 是否必填 |
| --------- | ------------ | ------ | ------ | -------- |
| secret           | API密钥      | String（50） | API密钥                                                      | M        |

#### 9.3.1 示例

```html
{
  "secret": "zhom"
}
```

### 9.4 返回参数

| 参数名称 | 参数中文名称 | 类型 | 参数说明 | 是否必填 |
| -------- | ------------ | ------ | -------------------------- | -------- |
| code | 编码 | String | 接口返回编码 例：200 | M |
| msg | 返回信息 | String | 接口返回信息 例：成功 | M |
| data | 详细信息 | Object | 接口返回详细信息 | O |

#### 9.4.1 示例
```html
{
  "code": 200,
  "msg": "成功",
  "data": null
}
```

## 10.免密支付状态修改

### 10.1 功能描述

免密支付状态修改

### 10.2 接口地址

请求地址：/account/editPayAuth
请求方式：POST

### 10.3 请求参数

| 参数名称 | 参数中文名称 | 类型 | 参数说明 | 是否必填 |
| -------- | ------------ | ------- | --------------------------- | -------- |
| payAuth | 免密支付 | Boolean | true：开启 false：关闭 | M |

#### 10.3.1 示例

```html
{
  "payAuth": false
}
```

### 10.4 返回参数

| 参数名称 | 参数中文名称 | 类型 | 参数说明 | 是否必填 |
| -------- | ------------ | ------ | -------------------------- | -------- |
| code | 编码 | String | 接口返回编码 例：200 | M |
| msg | 返回信息 | String | 接口返回信息 例：成功 | M |
| data | 详细信息 | Object | 接口返回详细信息 | O |

#### 10.4.1 示例
```html
{
  "code": 200,
  "msg": "成功",
  "data": null
}
```

## 11.发送验证码

### 11.1 功能描述

重置支付密码时发送验证码接口

### 11.2 接口地址

请求地址：/account/sendPayEmail
请求方式：POST

### 11.3请求参数

| 参数名称 | 参数中文名称 | 类型   | 参数说明 | 是否必填 |
| -------- | ------------ | ------ | -------- | -------- |
| email    | 邮箱         | String（100） | 邮箱     | M        |

#### 11.3.1 示例

```html
{
  "email": "zh@cahcuo.com"
}
```

### 11.4 返回参数

| 参数名称 | 参数中文名称 | 类型 | 参数说明 | 是否必填 |
| -------- | ------------ | ------ | -------------------------- | -------- |
| code | 编码 | String | 接口返回编码 例：200 | M |
| msg | 返回信息 | String | 接口返回信息 例：成功 | M |
| data | 详细信息 | Object | 接口返回详细信息 | O |

#### 11.4.1 示例

```html
{
  "code": 200,
  "msg": "成功",
  "data": null
}
```

## 12.账户钱包信息

### 12.1功能描述

账户钱包信息

### 12.2 接口地址

请求地址：/account/accountWallet
请求方式：POST

### 12.3 返回参数

| 参数名称 | 参数中文名称 | 类型 | 参数说明 | 是否必填 |
| -------- | ------------ | ------ | -------------------------- | -------- |
| code | 编码 | String | 接口返回编码 例：200 | M |
| msg | 返回信息 | String | 接口返回信息 例：成功 | M |
| data | 详细信息 | Object | 接口返回详细信息 | M |

data:

| 参数名称 | 参数中文名称 | 类型 | 参数说明 | 是否必填 |
| --------------- | ------------ | ------------ | ---------------- | -------- |
| currency | 币种 | String | 币种 | M |
| totalBalance | 账户总金额 | BigDecimal | 账户总金额 | M |
| accountBalance | 账户余额 | BigDecimal | 可用余额 | M |
| unsettleBalance | 未结算余额 | BigDecimal | 未结算余额 | M |
| freezeBalance | 冻结金额 | BigDecimal | 冻结金额 | M |
| childAccount | | Arry<Object> | 币种下的账户列表 | O |

childAccount:

| 参数名称        | 参数中文名称 | 类型       | 参数说明   | 是否必填 |
| --------------- | ------------ | ---------- | ---------- | -------- |
| balanceNo       | 账户号       | String     | 账户号     | M        |
| accountName     | 账户名称     | String     | 账户名称   | M        |
| area            | 地区         | String     | 地区       | M        |
| areaNameCN      | 地区(中文)   | String     | 地区(中文) | M        |
| totalBalance    | 账户总金额   | BigDecimal | 账户总金额 | M        |
| accountBalance  | 账户余额     | BigDecimal | 可用余额   | M        |
| unsettleBalance | 未结算余额   | BigDecimal | 未结算余额 | M        |
| freezeBalance   | 冻结金额     | BigDecimal | 冻结金额   | M        |
| currency   | 币种     | String | 币种   | M        |

#### 12.3.1 示例

```html
{
  "code": 200,
  "msg": "成功",
  "data": [
    {
      "currency": "HKD",
      "totalBalance": 9096.78,
      "accountBalance": 8650.08,
      "unsettleBalance": 0,
      "freezeBalance": 446.7,
      "childAccount": [
        {
          "currency": "HKD",
          "balanceNo": "1xxxxxxx8",
          "accountName": "测试账号",
          "area": "HK",
          "areaNameCN": "中国香港特别行政区",
          "totalBalance": 6911.2,
          "accountBalance": 6713.2,
          "unsettleBalance": 0,
          "freezeBalance": 198
        }
      ]
    }
  ]
}
```

## 13.创建全球收款账户

### 13.1 功能描述

创建全球收款账户

### 13.2 接口地址

请求地址：/va/create
请求方式：POST

### 13.3 请求参数

| 参数名称 | 参数中文名称 | 类型 | 参数说明 | 是否必填 |
| ----------------- | -------------- | ------------- | ------------------------------------------------------------ | -------- |
| accountName | 账户名称 | String（255） | 账户名称 例：ceshi | M |
| preAccountName | 预申请账户名称 | String（100） | 预申请账户名称 例：ceshi1 | O |
| regionalCountry | 账户国家地区 | String（2） | 账户所在地 GB：英国 HK：香港 US：美国 CA：加拿大 例：GB | M |
| orderCurrency | 申请币种 | List< String> | 申请账户币种 账户国家为其他国家时，币种只能填写一个 例：GBP | M |
| requisitionNumber | 请求单号 | String（50） | 商户请求单号，请确保请求单号的唯一性 例：83xxx2 | M |
| files | 资料 | Arry< Object> | 如果账户名称与预申请账户名称不同，需要填写证明资料 能证明客户与预申请账户名称关联性的资料 | O |

BFile

| 参数名称 | 参数中文名称 | 类型 | 参数说明 | 是否必填 |
| -------- | ------------ | ------ | --------------------------------------------- | -------- |
| fileName | 文件名 | String（255） | 主商户号 例：证明资料。jpg | M |
| filePath | 文件地址 | String（255） | 文件地址 例：https://证t-bj-B%2FlSONA%3D | M |

注：
	国家为HK时币种必须为：AUD,CAD,CHF,CNH,EUR,GBP,HKD,JPY,NZD,SEK,SGD,USD
	传输所需的国家地区信息可通过接口（查询国家、省、市、区）查询获取

#### 13.3.1 请求示例

```html
{
    "accountName":"CeShi",
    "regionalCountry":"GB",
    "orderCurrency":["GBP"],
    "requisitionNumber":"29338434338",
    "preAccountName":"ceshide",
    "files":
        [{
             "fileName":"ceshi.jpg",
             "filePath":"https://t-bj-B%2FlSONA%3D"
        }]
}
```

### 13.4 返回参数

| 参数名称 | 参数中文名称 | 类型 | 参数说明 |
| -------- | ------------ | ------ | -------------------------- |
| code | 编码 | String | 接口返回编码 例：200 |
| msg | 返回信息 | String | 接口返回信息 例：成功 |
| data | 详细信息 | Object | 接口返回详细信息 |

#### 13.4.1 返回示例

```html
{
  "code": 200,
  "msg": "成功",
  "data": null
}
```

### 13.5 创建全球账户审核异步返回列表

注意：此表格的参数为NotifyUrl的服务器返回参数

| 参数名 | 参数中文 | 类型 | 描述 |
| --------------- | ---------- | ------------ | -------------------------------------------------------- |
| accountStatus | 状态 | String | 状态 NORMAL：正常 REFUSE：失败 例：NORMAL |
| accountName | 账户名称 | String | 账户名称 |
| regionalCountry | 账户所在地 | String | 账户所在地 |
| applyTime | 申请时间 | String | 申请时间 |
| currency | 币种 | String | 币种 |
| bankInfo | 银行信息 | arry<Object> | 银行信息 |
| notifyUrl | 通知地址 | String | 通知地址 |
| msgType | 通知状态 | String | 通知状态 例：GLOBAL_ACCOUNTS |

bankInfo:银行信息

| 参数名 | 描述 | 类型 |
| ------------- | ------------ | ------------ |
| accountName | 账户名称 | String |
| accountNumber | 银行账户号 | String |
| bankName | 银行名称 | String |
| bankAddress | 银行地址 | String |
| bankCountry | 银行所处国家 | String |
| routingInfo | 详细信息 | arry<Object> |
| currency | 币种 | String |
| status | 状态 | String |
| effectiveTime | 有效时间 | String |

routingInfo:

| 参数名          | 描述              | 类型   |
| --------------- | ----------------- | ------ |
| routingCode     | routing_code      | String |
| routingCodeType | routing_code_type | String |
| bankCode        | bank_code         | String |
| branchCode      | branch_code       | String |
| swiftCode       | swift_code        | String |

#### 13.5.1 示例
```html
{
  "accountStatus": "NORMAL",
  "bankInfo": [
    {
      "routingInfo": [
        {
          "branchCode": "478",
          "bankCode": "016",
          "swiftCode": "DHBKHKHH"
        }
      ],
      "accountName": "ceshide",
      "effectiveTime": "长期",
      "bankName": "DBS Bank (Hong Kong) Limited, Hong Kong Branch",
      "currency": "AUD,CAD,CHF,CNH,EUR,GBP,HKD,JPY,NZD,SEK,SGD,USD",
      "accountNumber": "799409861",
      "bankAddress": "11th Floor, The Center, 99 Queen's Road Central, Central, Hong Kong",
      "bankCountry": "HKG",
      "status": "NORMAL"
    }
  ],
  "accountName": "CeShi",
  "regionalCountry": "HK",
  "notifyUrl": "http://ack",
  "msgType":"GLOBAL_ACCOUNTS",
  "currency": "AUD,CAD,CHF,CNH,EUR,GBP,HKD,JPY,NZD,SEK,SGD,USD",
  "applyTime": 1677662937000
}
```

## 14.查询VA列表

### 14.1 功能描述

查询创建全球账户列表

### 14.2 接口地址

请求地址：/va/vaList
请求方式：POST

### 14.3请求参数
| 参数名称 | 参数中文名称 | 类型/长度 | 参数说明 | 是否必填 |
| ----------------- | ---------------- | ------------- | ------------------------------------------------------------ | -------- |
| accountName | 账户名称 | String（255） | 账户名称 | O |
| vaStatus | 账户状态 | String（20） | 账户状态 NORMAL：正常 FROZEN：冻结 EXPIRATION：授权到期 DISABLE：禁用 UNDERREVIEW：审核中 REFUSE：拒绝 例：NORMAL | O |
| regionalCountry | 账户所在地 | String（2） | 账户所在地 GB：英国 HK：香港 US：美国 CA：加拿大 例：GB | O |
| requisitionNumber | 请求单号 | String（50） | 商户在创建账户时传输的请求编号 例：12312 | O |
| startTime | 账户申请开始时间 | String（30） | 账户申请开始时间 格式：yyyy-MM-dd HH-mm-ss 例：2023-01-01 00:00:00 | O |
| endTime | 账户申请结束时间 | String（30） | 账户申请开始时间 格式：yyyy-MM-dd HH-mm-ss 例：2023-01-01 23:59:59 | O |

#### 14.3.1 请求示例

```html
{
    "accountName":"CeShi",
    "vaStatus":"NORMAL",
    "regionalCountry":"GB",
    "requisitionNumber":"123",
    "startTime":"2023-01-01 00:00:00",
    "endTime":"2023-01-18 23:59:59"
}
```

### 14.4 返回参数

| 参数名称 | 参数中文名称 | 类型   | 参数说明         |
| -------- | ------------ | ------ | ---------------- |
| code     | 编码         | String | 接口返回编码     |
| msg      | 返回信息     | String | 接口返回信息     |
| data     | 详细信息     | Object | 接口返回详细信息 |

data：

| 参数名称 | 参数中文名称 | 类型 | 参数说明 |
| -------- | ------------ | ------------ | ------------------ |
| total | 创建条数 | String | 商户创建账户总数 |
| dataList | 详细信息 | arry<Object> | 查询返回的详细信息 |

dataList：

| 参数名称 | 参数中文名称 | 类型 | 参数说明 |
| ----------------- | -------------- | ------ | ------------------------------------------------------------ |
| accountName | 商户名称 | String | 商户名称 |
| preAccountName | 预申请账户名称 | String | 预申请账户名称 |
| regionalCountry | 国家地区 | String | 账户所在国家地区 |
| currency | 支持币种 | String | 支持币种 |
| applyTime | 申请时间 | String | 申请时间 |
| status | 账户状态 | String | 账户状态 NORMAL：正常 FROZEN：冻结 EXPIRATION：授权到期 DISABLE：禁用 UNDERREVIEW：审核中 REFUSE：拒绝 |
| vaType | 账户类型 | String | 账户类型 ENTERPRISE：企业 PERSONAL：个人 |
| requisitionNumber | 请求单号 | String | 申请VA账户时填写的账户请求单号 |
| accountOnlyNumber | 账户唯一单号 | String | 账户唯一单号 |

#### 14.4.1 返回示例

```html
{
  "code": 200,
  "msg": "成功",
  "data": {
    "total": 14,
    "dataList": [
      {
        "accountName": "CS",
        "preAccountName": "TEST",
        "regionalCountry": "HK",
        "currency": "AUD,CAD,CHF,CNH,EUR,GBP,HKD,JPY,NZD,SEK,SGD,USD",
        "applyTime": "2022-12-22 15:08:27",
        "status": "NORMAL",
        "vaType": "ENTERPRISE",
        "requisitionNumber": "123",
        "accountOnlyNumber": "849833884"
      }
    ]
  }
}
```

## 15.查询全球收款账户详情

### 15.1功能描述
查询创建全球收款账户详情

### 15.2 接口地址

请求地址：/va/vaDetails
请求方式：POST

### 15.3 请求参数

| 参数名称          | 参数中文名称 | 类型         | 参数说明                 | 是否必填 |
| -------- | ------------ | ------------ | ------------- | -------- |
| requisitionNumber | 请求单号     | String（50） | 创建账户时填写的请求单号 | M        |

#### 15.3.1 示例
```html
{
  "requisitionNumber": "123"
}
```
### 15.4 返回参数列表

| 参数名称 | 参数中文名称 | 类型 | 参数说明 |
| -------- | ------------ | ------ | -------------------------- |
| code | 编码 | String | 接口返回编码 例：200 |
| msg | 返回信息 | String | 接口返回信息 例：成功 |
| data | 详细信息 | Object | 接口返回详细信息 |

data:

| 参数名 | 描述 | 类型 |
| ------------------ | -------- | ------------ |
| accountAnotherName | 账户别名 | String |
| bankInfo | 银行信息 | arry<Object> |

bankInfo:银行信息

| 参数名 | 描述 | 类型 |
| ------------- | ------------ | ------------ |
| accountName | 账户名称 | String |
| accountNumber | 银行账户号 | String |
| bankName | 银行名称 | String |
| bankAddress | 银行地址 | String |
| bankCountry | 银行所处国家 | String |
| routingInfo | 详细信息 | List<Object> |
| currency | 币种 | String |
| status | 状态 | String |
| effectiveTime | 有效时间 | String |

routingInfo:

| 参数名          | 描述              | 类型   |
| --------------- | ----------------- | ------ |
| routingCode     | routing_code      | String |
| routingCodeType | routing_code_type | String |
| bankCode        | bank_code         | String |
| branchCode      | branch_code       | String |
| swiftCode       | swift_code        | String |

#### 15.4.1 示例
```html
{
  "code": 200,
  "msg": "成功",
  "data": {
    "accountAnotherName": "39283",
    "bankInfo": [
      {
        "accountName": "CS",
        "accountNumber": "0339114406",
        "bankName": "Community Federal Savings Bank",
        "bankAddress": "810 Seventh Avenue, New York, NY 10019, US",
        "bankCountry": "US",
        "routingInfo": [
          {
            "routingCode": "026073008",
            "routingCodeType": "wire_routing_number",
            "bankCode": "016",
            "branchCode": "478",
            "swiftCode": "DHBKHKHH"
          }
        ],
        "currency": "USD",
        "status": "NORMAL",
        "effectiveTime": "长期"
      }
    ]
  }
}
```

## 16.修改账户别名

### 16.1功能描述

修改申请账户别名

### 16.2 接口地址

请求地址：/va/upVaAlias
请求方式：POST

### 16.3请求参数

| 参数名称          | 参数中文名称 | 类型          | 参数说明                 | 是否必填 |
| ----------------- | ------------ | ------------- | ------------------------ | -------- |
| requisitionNumber | 请求单号     | String（50）  | 创建账户时填写的请求单号 | M        |
| alias             | 别名         | String（255） | 别名                     | M        |

#### 16.3.1 示例

```html
{
  "alias": "3839231",
  "requisitionNumber": "456",
}
```

### 16.4 返回参数

| 参数名称 | 参数中文名称 | 类型 | 参数说明 |
| -------- | ------------ | ------ | -------------------------- |
| code | 编码 | String | 接口返回编码 例：200 |
| msg | 返回信息 | String | 接口返回信息 例：成功 |
| data | 详细信息 | Object | 接口返回详细信息 |

#### 16.4.1 示例

```html
{
  "code": 200,
  "msg": "成功",
  "data": null
}
```

## 17.下载账户开户凭证

### 17.1 功能描述

下载账户开户凭证

### 17.2 接口地址
请求地址：/va/vaCredentials
请求方式：POST

### 17.3请求参数

| 参数名称 | 参数中文名称 | 类型 | 参数说明 | 是否必填 |
| ----------------- | ------------ | ------------ | ------------------------------------------------------------ | -------- |
| requisitionNumber | 请求单号 | String（50） | 创建账户时填写的请求单号 注：requisitionNumber与accountOnlyNumber二者必须至少填写一个 | O |
| accountOnlyNumber | 系统返回单号 | String（50） | 系统返回单号 注：requisitionNumber与accountOnlyNumber二者必须至少填写一个 | O |

#### 17.3.1 示例

```html
{
  "requisitionNumber": "456",
  "accountOnlyNumber": "2342"
}
```

### 17.4 返回参数

| 参数名称 | 参数中文名称 | 类型 | 参数说明 |
| -------- | ------------ | ------ | -------------------------- |
| code | 编码 | String | 接口返回编码 例：200 |
| msg | 返回信息 | String | 接口返回信息 例：成功 |
| data | 详细信息 | Object | 接口返回详细信息 |

Data:

| 参数名 | 描述     | 类型   |
| ------ | -------- | ------ |
| url    | 下载地址 | String |

#### 17.4.1 示例

```html
{
  "code": 200,
  "msg": "成功",
  "data": {
    "url": "https://t-sdnfisdfxxxxxx"
  }
}
```

## 18.创建站内转账
### 18.1功能描述
除了汇款⾄银⾏账户，我们还允许TransferEasy的账户间互相转账，账户间转账我们简称为IAT
### 18.2接口地址
请求地址：`/moves/create`
### 18.3请求参数列表

| 参数名称 | 参数中文名称 | 类型& 长度 | 参数说明 | 是否必填 |
| --- | --- | --- | --- | --- |
| outTradeNo | 商户自定义订单号 | String(64) | 订单号为商户自行拟定，提交的订单号必须在自身平台交易中唯一示例:“201901021232211023” | M |
| payerAccountNum | 付款账号 | String(64) | 付款账号，详见账号列表 | M |
| shroffMerchantNum | 收款商户号 | String(14) | 平台所属唯一商户号 | M |
| shroffAccountNum | 收款账户号 | String(64) | 收款人账号 | M |
| shroffAccountName | 收款账户名称 | String(128) | 收款账户名称 | M |
| transAmount | 转出金额 | long | 转出金额，只能为正整数，币种的最小货币单位 | M |
| placeOfAccount | 账户开户所在地 | String(14) | 账户开户所在地 | M |
| placeOfCurrency | 账户币种 | String(14) | 账户币种 | M |
| purpose | 转账用途 | String(256) | 转账用途,见附录 | M |
| processRemarks | 交易附言 | String(256) | 交易附言 | C |
| contractFiles | 交易合同凭证 | object | 交易合同凭证 | O |
| invoiceFiles | 交易发票凭证 | object | 交易发票凭证 | O |
| othersFiles | 其他资料 | object | 其他资料 | O |
#### 18.3.1上传凭证、资料参数列表
contractFiles、invoiceFiles、othersFiles：

| 参数名称 | 参数中文名称 | 类型& 长度 | 参数说明 | 是否必填 |
| --- | --- | --- | --- | --- |
| fileName | 文件名称 | String(64) | 上传文件名称 | M |
| filePath | 文件路径 | String(256) | 上传文件返回路径 | M |

### 18.4示例
```json
{
    "outTradeNo":"20230221389213",
    "payerAccountNum":"10102134480000174",
    "shroffMerchantNum":"80000138",
    "shroffAccountNum":"10102134480000138",
    "shroffAccountName":"测试账号",
    "transAmount":20000,
    "placeOfAccount":"HK",
    "placeOfCurrency":"HKD",
    "purpose":"Trade in goods - 货物贸易Trade in goods",
    "contractFiles":[
        {
            "fileName":"31231",
            "filePath":"111111"
        }
    ]
}
```
### 18.5请求同步返回参数列表

| 参数名称 | 参数中文名称 | 参数说明 |
| --- | --- | --- |
| code | 状态码 | 请求状态码，详见附录 |
| msg | 状态描述 | 状态描述 |
| data | 数据信息 | 返回数据对象信息，在请求状态为成功时返回 |

#### 18.5.1响应参数（data，响应信息）

| 参数名称 | 参数中文名称 | 参数说明 |
| --- | --- | --- |
| orderNo | 支付单号 | TransferEasy平台支付单号 |
| outTradeNo | 商户自定义单号 | 商户请求单号 |
| orderType | 交易类型 | 转账交易类型，P：转出 B：转入 |
| orderStatus | 交易状态 | 0：拒绝/失败 1：完成 2：审核中 3：驳回 4：待入账 5：已取消 |
| createTime | 创建时间 | 订单创建时间 |
| amount | 转账金额 | 转账金额 |
| currency | 转账币种 | 转账币种 |
| serviceCharge | 转账手续费 | 转账手续费 |
| purpose | 转账用途 | 转账用途 |
| completionTime | 转账完成时间 | 转账完成时间，格式'yyyy-MM-dd HH:ss:mm' 2023-02-21 16:06:16 |
| processRemarks | 交易附言 | 交易附言 |
| beneficiaryAccountNo | 收款商户号 | 收款商户号 |
| beneficiaryAccountNum | 收款账号 | 收款账号 |
| beneficiaryAccountName | 收款账户名称 | 收款账户名称 |
| payerAccountNo | 付款商户号 | 支付商户号 |
| payerAccountNum | 付款账户号 | 付款账户号 |
| payerAccountName | 付款商户名称 | 付款商户名称 |

### 18.6示例
```json
{
	"code": 200,
	"msg": "成功",
	"data": {
		"orderType": "P",
		"orderStatus": "SUCCESS",
		"orderNo": "2023022115599491",
		"outTradeNo": "20230221",
		"createTime": "2023-02-21 15:59:21",
		"amount": "20000",
		"currency": "HKD",
		"serviceCharge": "2000",
		"purpose": "Trade in goods - 货物贸易Trade in goods",
		"completionTime": "2023-02-21 16:06:16",
		"processRemarks": null,
		"beneficiaryAccountNo": "80000138",
		"beneficiaryAccountNum": "10102134480000138",
		"beneficiaryAccountName": "测试账号",
		"payerAccountNo": "80000174",
		"payerAccountNum": "10102134480000174",
		"payerAccountName": "wangqingyong"
	}
}
```

### 18.7 站内转账订单审核异步返回列表
注意：此表格的参数为NotifyUrl的服务器返回参数

| 参数名称 | 参数中文名称 | 参数说明 |
| --- | --- | --- |
| orderNo | 支付单号 | TransferEasy平台支付单号 |
| outTradeNo | 商户自定义单号 | 商户请求单号 |
| orderType | 交易类型 | 转账交易类型，P：转出 B：转入 |
| orderStatus | 交易状态 | 0：拒绝/失败 1：完成 2：审核中 3：驳回 4：待入账 5：已取消 |
| createTime | 创建时间 | 订单创建时间 |
| amount | 转账金额 | 转账金额 |
| currency | 转账币种 | 转账币种 |
| serviceCharge | 转账手续费 | 转账手续费 |
| purpose | 转账用途 | 转账用途 |
| completionTime | 转账完成时间 | 转账完成时间，格式'yyyy-MM-dd HH:ss:mm' 2023-02-21 16:06:16 |
| processRemarks | 交易附言 | 交易附言 |
| beneficiaryAccountNo | 收款商户号 | 收款商户号 |
| beneficiaryAccountNum | 收款账号 | 收款账号 |
| beneficiaryAccountName | 收款账户名称 | 收款账户名称 |
| payerAccountNo | 付款商户号 | 支付商户号 |
| payerAccountNum | 付款账户号 | 付款账户号 |
| payerAccountName | 付款商户名称 | 付款商户名称 |
| notifyUrl | 通知地址 | 通知地址 |
| msgType | 通知状态 | 通知状态 例：INNER_TRANS |

#### 18.7.1示例
```json
{
		"notifyUrl":"http://fsdifnsdifisf",
		"msgType":"INNER_TRANS",
		"orderType": "P",
		"orderStatus": "SUCCESS",
		"orderNo": "2023022115599491",
		"outTradeNo": "20230221",
		"createTime": "2023-02-21 15:59:21",
		"amount": "20000",
		"currency": "HKD",
		"serviceCharge": "2000",
		"purpose": "Trade in goods - 货物贸易Trade in goods",
		"completionTime": "2023-02-21 16:06:16",
		"processRemarks": null,
		"beneficiaryAccountNo": "80000138",
		"beneficiaryAccountNum": "10102134480000138",
		"beneficiaryAccountName": "测试账号",
		"payerAccountNo": "80000174",
		"payerAccountNum": "10102134480000174",
		"payerAccountName": "wangqingyong"
}
```

## 19.取消站内转账列表
### 19.1功能描述
取消站内转账订单详情
### 19.2接口地址
请求地址：`/moves/cancel`
### 19.3请求参数列表

| 参数名称 | 参数中文名称 | 类型& 长度 | 参数说明 | 是否必填 |
| --- | --- | --- | --- | --- |
| orderNo | TransferEasy订单号 | String(64) | TransferEasy转账订单号 | O |
| outTradeNo | 商户自定义订单号 | String(64) | 商户自定义订单号 | O |
### 19.4示例
```json
{
    "orderNo":"2023022211249991"
}
```
### 19.5请求同步返回参数列表

| 参数名称 | 参数中文名称 | 参数说明 |
| --- | --- | --- |
| code | 状态码 | 请求状态码，详见附录 |
| msg | 状态描述 | 状态描述 |
| data | 数据信息 | 返回数据对象信息，在请求状态为成功时返回 |

#### 19.5.1响应参数（data，响应信息）
无返回，异常情况根据code参考错误列表，见附录。
### 19.6示例
```json
{
	"code": 200,
	"msg": "成功",
	"data": null
}
```

## 20.查询站内转账列表
### 20.1功能描述
查询站内转账订单列表
### 20.2接口地址
请求地址：`/moves/list`
### 20.3请求参数列表

| 参数名称 | 参数中文名称 | 类型& 长度 | 参数说明 | 是否必填 |
| --- | --- | --- | --- | --- |
| orderNo | 订单号 | String(64) | TransferEasy订单号 | O |
| outTradeNo | 商户自定义单号 | String(64) | 订单号为商户自行拟定 | O |
| orderType | 交易类型 | char(3) | 交易类型，P:转出 B:转入 | O |
| orderStatus | 交易状态 | String(64) | 转账订单交易状态，见附录 | O |
| startTime | 订单开始时间 | String(32) | 转账订单开始时间，格式:'yyyy-MM-dd HH:mm:ss',示例 '2023-02-22 12:01:00' | O |
| endTime | 订单完成时间 | String(32) | 转账订单结束时间，格式:'yyyy-MM-dd HH:mm:ss',示例 '2023-02-22 12:01:00' | O |
| pageIndex | 页数 | int | 当前页数，默认值为1 | O |
| pageSize | 条数 | int | 当前页条数，默认值为10 | O |

### 20.4示例
```json
{
    "orderNo":"2023022211249991",
    "outTradeNo":"2023022112344",
    "orderType":"P",
    "orderStatus":"SUCCESS",
    "startTime":"2023-02-22 11:24:07",
    "endTime":"2023-02-22 11:26:46",
    "pageIndex":"1",
    "pageSize":"10"
}
```
### 20.5请求同步返回参数列表

| 参数名称 | 参数中文名称 | 参数说明 |
| --- | --- | --- |
| code | 状态码 | 请求状态码，详见附录 |
| msg | 状态描述 | 状态描述 |
| data | 数据信息 | 返回数据对象信息，在请求状态为成功时返回 |

#### 20.5.1响应参数（data，响应信息）

| 参数名称 | 参数中文名称 | 参数说明 |
| --- | --- | --- |
| total | 列表总条数 | 转账列表总条数 |
| dataList | 数据列表 | 转账数据列表，数据见下列表 |

dataList数据列表

| 参数名称 | 参数中文名称 | 参数说明 |
| --- | --- | --- |
| orderNo | TransferEasy订单号 | TransferEasy转账订单号 |
| outTradeNo | 商户自定义订单号 | 商户自定义订单号，需商户侧唯一 |
| createTime | 订单开始时间 | 订单创建时间，格式:'yyyy-MM-dd HH:mm:ss',示例 '2023-02-22 12:01:00' |
| conpletionTime | 订单完成时间 | 订单完成时间，格式:'yyyy-MM-dd HH:mm:ss',示例 '2023-02-22 12:01:00' |
| amount | 转账金额 | 转账金额，币种最小单位 |
| currency | 转账币种 | 转账币种 |
| orderType | 交易类型 | 转账订单交易类型，P:转入 B:转出 |
| orderStatus | 订单状态 | 订单状态，见附录 |

### 20.6示例
```json
{
	"code": 200,
	"msg": "成功",
	"data": {
		"total": 1,
		"dataList": [
			{
				"orderNo": "2023022211249991",
				"outTradeNo": "2023022112344",
				"createTime": "2023-02-22 11:24:07",
				"amount": "1000",
				"currency": "USD",
				"orderType": "P",
				"completionTime": "2023-02-22 11:26:46",
				"orderStatus": "SUCCESS"
			}
		]
	}
}
```

## 21.查询站内转账列表
### 21.1功能描述
查询站内转账订单详情
### 21.2接口地址
请求地址：`/moves/detail`
### 21.3请求参数列表

| 参数名称 | 参数中文名称 | 类型& 长度 | 参数说明 | 是否必填 |
| --- | --- | --- | --- | --- |
| orderNo | TransferEasy订单号 | String(64) | TransferEasy转账订单号 | O |
| outTradeNo | 商户自定义订单号 | String(64) | 商户自定义订单号 | O |
### 21.4示例
```json
{
    "orderNo":"2023022211249991"
}
```
### 21.5请求同步返回参数列表

| 参数名称 | 参数中文名称 | 参数说明 |
| --- | --- | --- |
| code | 状态码 | 请求状态码，详见附录 |
| msg | 状态描述 | 状态描述 |
| data | 数据信息 | 返回数据对象信息，在请求状态为成功时返回 |

#### 21.5.1响应参数（data，响应信息）

| 参数名称 | 参数中文名称 | 参数说明 |
| --- | --- | --- |
| orderNo | TransferEasy订单号 | TransferEasy转账订单号 |
| outTradeNo | 商户自定义单号 | 转账商户自定义单号，需商户侧唯一 |
| orderType | 交易类型 | 转账交易类型，P：转出 B：转入 |
| orderStatus | 交易状态 | 转账订单交易状态，见附录 |
| createTime | 创建时间 | 订单创建时间，格式’yyyy-MM-dd HH:ss:mm’ 2023-02-21 16:06:16 |
| completionTime | 转账完成时间 | 转账完成时间，格式’yyyy-MM-dd HH:ss:mm’ 2023-02-21 16:06:16 |
| amount | 转账金额 | 转账金额，币种最小单位 |
| currency | 转账币种 | 转账币种 |
| serviceCharge | 转账手续费 | 转账手续费，币种最小单位 |
| purpose | 转账用途 | 转账用途，见附录 |
| processRemarks | 交易附言 | 交易附言 |
| beneficiaryAccountNo | 收款商户号 | 收款商户号 |
| beneficiaryAccountNum | 收款账号 | 收款账号 |
| beneficiaryAccountName | 收款账户名称 | 收款账户名称 |
| payerAccountNo | 付款商户号 | 付款商户号 |
| payerAccountNum | 付款账户号 | 付款账户号 |
| payerAccountName | 付款商户名称 | 付款商户名称 |

### 21.6示例
```json
{
	"code": 200,
	"msg": "成功",
	"data": {
		"orderType": "P",
		"orderStatus": "SUCCESS",
		"orderNo": "2023022211249991",
		"outTradeNo": "2023022112344",
		"createTime": "2023-02-22 11:24:07",
		"amount": "1000",
		"currency": "USD",
		"serviceCharge": "100",
		"purpose": "Trade in goods - 货物贸易Trade in goods",
		"completionTime": "2023-02-22 11:26:46",
		"processRemarks": "测试",
		"beneficiaryAccountNo": "80000138",
		"beneficiaryAccountNum": "10102184080000138",
		"beneficiaryAccountName": "测试账号",
		"payerAccountNo": "80000174",
		"payerAccountNum": "10102184080000174",
		"payerAccountName": "wangqingyong"
	}
}
```

## 22.创建收付款对象

### 22.1 功能描述

创建收付款对象

### 22.2 接口地址

请求地址：/drawer/create
请求方式：POST

### 22.3请求参数

| 参数名称 | 参数中文名称 | 类型 | 参数说明 | 是否必填 |
| ----------------------- | ----------------------------------- | ------ | ------------------------------------------------------------ | -------- |
| outDrawerNo | 商户自定义no | String | 商户自定义no | M |
| cardType | 收付款对象类型 | String | 收付款对象类型 RECEIPT：汇款收款人账户 SETTLE：结汇账户 PAYEE:收款付款人 | M |
| drawerType | 主体类型 | String | 主体类型 C：企业 P：个人 | M |
| drawerName | 名称 | String | 名称 | M |
| drawerSurname | 主体姓氏 | String | 主体姓氏 drawerType为P是必填 | C |
| middleName | 中间名 | String | 中间名 | O |
| drawerFormerName | 曾用名 | String | 曾用名 | O |
| drawerDate | 个人的出生日期/企业的注册日期 | String | 个人的出生日期/企业的注册日期 格式：yy-MM-dd 如：1990-01-01 cardType为RECEIPT、PAYEE必填 | C |
| drawerSex | 性别 | String | 性别 M：男 F：女 cardType为RECEIPT、PAYEE，且drawerType为P时必填 | C |
| drawerCountry | 企业注册国家/地区，个人国籍 | String | 企业注册国家/地区、个人国籍，两位国家代码如中国：HK,cardType为RECEIPT、PAYEE时必填 | C |
| documentType | 证件类型 | String | 证件类型 ID:身份证 DRIVERING_LICENSE：驾驶证 PASSPORT：护照 CI:营业执照 CERTIFICATE_EXISTENCE : 企业存续证书 CERTIFICATE_INCORPORATION:公司注册书 REGISTRATION_CERTIFICATE:商业登记证 | M |
| documentNumber | 证件号 | String | 证件号,敏感字段需要加密 | M |
| documentStartDate | 证件开始日期 | String | 证件开始日期 格式：yy-MM-dd 如：1990-01-01 cardType为RECEIPT、PAYEE时必填 | C |
| documentEndDate | 证件结束日期 | String | 证件结束日期 格式：yy-MM-dd 如：1990-01-01 cardType为RECEIPT、PAYEE时必填 | C |
| documentCountry | 发证国家或地区 | String | 两位国家代码如中国：HK cardType为RECEIPT、PAYEE时必填 | C |
| drawerAddress | 详细地址，企业注册地址/个人通讯地址 | String | 详细地址，企业注册地址/个人通讯地址 | M |
| email | 收付款人邮箱 | String | 收付款人邮箱 | O |
| mobile | 收付款人联系电话 | String | 收付款人联系电话 | O |
| drawerBankAccountNumber | 银行账号 | String | 银行账号，敏感字段需要加密 cardType为RECEIPT、SETTLE时必填 | C |
| drawerBankAccountName | 银行账户名称 | String | 银行账户名称 cardType为RECEIPT、SETTLE时必填 | C |
| drawerBankCountry | 银行所在地 | String | 两位国家代码 如香港：HK cardType为RECEIPT时必填 | C |
| drawerBankName | 银行名称 | String | 银行名称 cardType为RECEIPT、SETTLE时必填 | C |
| drawerBankAddress | 银行所在地址详情 | String | 银行所在地址详情 | O |
| drawerBankBranchName | 分行名称 | String | 分行名称 cardType为SETTLE时必填 | C |
| swiftCode | swiftCode | String | swiftCode 格式：必须为8或11位英文字母或阿拉伯数字组成 | C |
| sortCode | sortCode | String | sortCode 格式：必须为6位阿拉伯数字组成 | C |
| aba | aba | String | aba 格式：必须为9位阿拉伯数字组成 | C |
| bsb | bsb | String | bsb 格式：必须为6位阿拉伯数字组成 | C |
| businessCountry | 展业地区 | String | 两位国家代码 如香港：HK | O |
| drawerProvince | 主体省份 | String | | O |
| drawerCity | 主体城市 | String | | O |
| drawerOperatingCountry | 企业运营国家/个人通讯国家 | String | 两位国家代码 如香港：HK cardType为RECEIPT 或 PAYEE时必填 | C |
| drawerOperatingProvince | 企业运营省份/个人通讯省份 | String | | O |
| drawerOperatingCity | 企业运营城市/个人通讯城市 | String | | O |
| drawerOperatingAddress | 运营详细地址 | String | cardType为RECEIPT 或 PAYEE时必填 | C |
| traderType | 汇款类型 | String | 汇款类型： SWIFT、FPS、ACT、CHATS/RTGS、UK Faster Payment、SEPA、EFT、ABA | C |
| currency | 币种 | String | 币种三位代码 如港币：HKD cardType为RECEIPT、PAYEE时必填 | C |
| drawerBankCode | 银行编码 | String | 银行编码 格式：必须为3位阿拉伯数字组成 | C |
| certificateFileList | 证件文件集 | Array | | O |
| otherFileList | 其他文件集 | Array | | O |
| postalCode | 注册邮编 | String | 注册邮编 | O |
| drawerBankBranchCode | 银行分行编码 | String | 银行分行编码 格式：必须为阿拉伯数字组成 | O |

注：以上信息收付款对象类型非：SETTLE时，不支持中文传值

#### 22.3.1 请求示例

```html
{
    "outDrawerNo": "3434623432",
    "cardType": "RECEIPT",
    "drawerName": "测试drawerName",
    "drawerSurname": "",
    "drawerFormerName": "",
    "drawerDate": "2019-01-01",
    "drawerType": "C",
    "drawerSex": "",
    "drawerCountry": "HK",
    "documentType": "IC",
    "documentNumber": "I4scSe4iPlJPZSRwozV7bm8zYPdPJ9gs4ej8ANIQcnVbKv2AbQBKTX/hqNFpJB21HKphd2MT9dUzPDDVapAs4gauO5xW+/A0te3mIXAK0XckFmQ+KjuARmnqzhNHSsWVex9anBvSp9N03ojwn2lyYHHbdmMYZz4heGeGmx077ax5ZU7CO8E8OxtsR6UKI4OWJcTGmrYI3QCkV2W/q9Sj4/bHWVAPnnIpsZZNs4fmE+vUFhtZWcYT1GcHoZLhszvh5elcA4g+fa2gfrmTkrDpTncynvAGAq5jgzvcTcPdlMqgzugbXJctE5HfN6XWJgOzNkaXixv3w1zQDuaM86Jy7Q==",
    "documentStartDate": "2019-01-01",
    "documentEndDate": "2025-01-01",
    "documentCountry": "HK",
    "drawerAddress": "测试drawerAddress",
    "email": "",
    "mobile": "",
    "drawerBankAccountNumber": "jZjFQpmGw5DEWeBIst+BljoYv02yea7p/3syVDyf/W0vZ6Kyie/OAYb9XwlADB72DjQEomgvNfabZNi+OlcW1U1pBOQMxqqFLS0OPDH2mWfdpx7Bu0JeKQQSHlrshmof1WcngFUC5W4LbKlM7ozMLL3nw6eRY7+/+qxsWd+FEizup9ADMCT2zl2JkyJlHxB0D37PaZ7E2Q12N5LEUSGHrd6dEQKNLKe4LV59Uvl8rcg1jMbuKZBvuvNP3LS7B51eCyZTksphBNtgvQvm+X0p68v4VccP06q+yOOW1YCHXGLqQF0DI8LtVigeK8r07HwHOw6bfULmr1mdkcm+sdXpGQ==",
    "drawerBankAccountName": "张三",
    "drawerBankCountry": "HK",
    "drawerBankName": "银行名称",
    "drawerBankAddress": "",
    "drawerBankBranchName": "",
    "swiftCode": "",
    "sortCode": "",
    "iban": "",
    "aba": "",
    "bsb": "",
    "businessCountry": "",
    "drawerProvince": "",
    "drawerCity": "",
    "drawerOperatingCountry": "HK",
    "drawerOperatingProvince": "",
    "drawerOperatingCity": "",
    "drawerOperatingAddress": "北京海淀区XXX",
    "traderType": "FPS",
    "currency": "HKD",
    "middleName": "",
    "drawerBankCode": "234324"
}
```

### 22.4 返回参数

| 参数名称 | 参数中文名称 | 类型 | 参数说明 |
| ----------------------- | ----------------------------------- | ------ | ------------------------------------------------------------ |
| subMerchantNo | 子商户号 | String | 子商户号 |
| outDrawerNo | 商户自定义no | String | 商户自定义no |
| cardType | 收付款对象类型 | String | 收付款对象类型 RECEIPT：汇款收款人账户 SETTLE：结汇账户 PAYEE:收款付款人 |
| drawerType | 主体类型 | String | 主体类型 C：企业 P：个人 |
| drawerName | 名称 | String | 名称 |
| drawerSurname | 主体姓氏 | String | 主体姓氏 |
| middleName | 中间名 | String | 中间名 |
| drawerFormerName | 曾用名 | String | 曾用名 |
| drawerDate | 个人的出生日期/企业的注册日期 | String | 个人的出生日期/企业的注册日期 |
| drawerSex | 性别 | String | 性别 M：男 F：女 |
| drawerCountry | 企业注册国家/地区，个人国籍 | String | 企业注册国家/地区、个人国籍，两位国家代码如香港：HK |
| documentType | 证件类型 | String | 证件类型 ID:身份证 DRIVERING_LICENSE：驾驶证 PASSPORT：护照 CI:营业执照 CERTIFICATE_EXISTENCE : 企业存续证书 CERTIFICATE_INCORPORATION:公司注册书 REGISTRATION_CERTIFICATE:商业登记证 |
| documentNumber | 证件号 | String | 证件号,加密数据 |
| documentStartDate | 证件开始日期 | String | 证件开始日期 格式：yy-MM-dd 如：1990-01-01 |
| documentEndDate | 证件结束日期 | String | 证件结束日期 格式：yy-MM-dd 如：1990-01-01 |
| documentCountry | 发证国家或地区 | String | 两位国家代码如香港：HK |
| drawerAddress | 详细地址，企业注册地址/个人通讯地址 | String | 详细地址，企业注册地址/个人通讯地址 |
| email | 收付款人邮箱 | String | 收付款人邮箱 |
| mobile | 收付款人联系电话 | String | 收付款人联系电话 |
| drawerBankAccountNumber | 银行账号 | String | 银行账号，加密数据 |
| drawerBankAccountName | 银行账户名称 | String | 银行账户名称 |
| drawerBankCountry | 银行所在地 | String | 两位国家代码 如香港：HK |
| drawerBankName | 银行名称 | String | 银行名称 |
| drawerBankAddress | 银行所在地址详情 | String | 银行所在地址详情 |
| drawerBankBranchName | 分行名称 | String | 分行名称 |
| swiftCode | swiftCode | String | swiftCode |
| sortCode | sortCode | String | sortCode |
| aba | aba | String | aba |
| bsb | bsb | String | bsb |
| businessCountry | 展业地区 | String | 两位国家代码 如香港：HK |
| drawerProvince | 主体省份 | String | |
| drawerCity | 主体城市 | String | |
| drawerOperatingCountry | 企业运营国家/个人通讯国家 | String | 两位国家代码 如香港：HK |
| drawerOperatingProvince | 企业运营省份/个人通讯省份 | String | |
| drawerOperatingCity | 企业运营城市/个人通讯城市 | String | |
| drawerOperatingAddress | 运营详细地址 | String | 运营详细地址 |
| traderType | 汇款类型 | String | 汇款类型： SWIFT、FPS、ACT、CHATS/RTGS、UK Faster Payment、SEPA、EFT、ABA |
| currency | 币种 | String | 币种三位代码 如港币：HKD |
| drawerBankCode | 银行编码 | String | 银行编码 |
| certificateFileList | 证件文件集 | Array | |
| otherFileList | 其他文件集 | Array | |
| postalCode | 注册邮编 | String | 注册邮编 |
| drawerBankBranchCode | 运营邮编 | String | 运营邮编 |

#### 22.4.1 返回示例（data，相应信息）

```html
{
	"code": 200,
	"msg": "成功",
	"data": {
		"outDrawerNo": "3434623432",
		"cardType": "RECEIPT",
		"subMerchantNo": "80000138",
		"drawerName": "测试drawerName",
		"drawerSurname": "",
		"drawerFormerName": "",
		"drawerDate": "2019-01-01",
		"drawerType": "C",
		"drawerSex": null,
		"drawerCountry": "HK",
		"documentType": "IC",
		"documentNumber": "u2V8QdTi92DiIIo7UD5oVrl7M2WpcsWjP+i+sNgriwTpIl/2el7Ql2yVGBmrhT11KMnG/qxSKrZQbPKTBTmSPjLJfpIjNcdt3zQEHSreO26YPx3Y1sy/vujSehqO4akz321J7L6ztNkJhEuGRX4etSYT56ym01Djd4475ygMEOoh6Y1fI1oAKqo2BKVZrW1/Ogrjoqs2DlMKcOKpmUKNlmVl0jicGX9rafyplL6zb4eCcfhotYReH42mdVWeL9otwd0dxzWpDloOlNZaC3wEU45trdPpJDF626jhgHf+3+2NrD6ZR2E2av/6hclqt/8PMqO+of/7G5RwRNlc9kUnDA==",
		"documentStartDate": "2019-01-01",
		"documentEndDate": "2025-01-01",
		"documentCountry": "HK",
		"drawerAddress": "测试drawerAddress",
		"email": "",
		"mobile": "",
		"drawerBankAccountNumber": "nwFaiYkAbUwfruEabGXTIKOPuLFriGgiI7ssQ6ij6woYH4pZHVEDw6Opvbm4/qIKFPqWS3qDZ1JP+ppbrr5Bw7k3Lc+OLRZ9Sr33AITJIl+GYynuomdRagyb2jlMuo30DiZCnWPPCIPHaWMFLgSZ3IJ25KTuCileuS8edZLusQEkEUudc2eODSKOEqNY7MVBji2TD/4HQl9kCdE4clQVvkNIucLAVKN6OqSSB8D2RKLS943iyB6ALE5nUm8oWz2yVExTfWrkREYBAF1uoIWwouJIXnpfeMrU5IUKmS7ir8e7ErH6hYpzUaYngv0wHhxbzaW1w8CFJd9/XHKfhTmU6A==",
		"drawerBankAccountName": "张三",
		"drawerBankCountry": null,
		"drawerBankName": null,
		"drawerBankAddress": null,
		"swiftCode": null,
		"sortCode": null,
		"iban": null,
		"aba": null,
		"bsb": null,
		"businessCountry": null,
		"drawerProvince": "",
		"drawerCity": "",
		"drawerOperatingCountry": "HK",
		"drawerOperatingProvince": "",
		"drawerOperatingCity": "",
		"drawerOperatingAddress": "北京海淀区XXX",
		"traderType": "FPS",
		"currency": null,
		"middleName": "",
		"createTime": "2023-02-17 10:49:09"
	}
}
```

## 23.查询收付款对象列表

### 23.1 功能描述

查询收付款对象列表

### 23.2 接口地址

请求地址：/drawer/list
请求方式：POST

### 23.3 请求参数

| 参数名称 | 参数中文名称 | 类型 | 参数说明 | 是否必填 |
| ------------ | -------------- | ------- | ------------------------------------------------------------ | -------- |
| cardType | 收付款对象类型 | String | 收付款对象类型 RECEIPT：汇款收款人账户 SETTLE：结汇账户 PAYEE:收款付款人 | M |
| outDrawerNo | 商户自定义no | String | 商户自定义no | O |
| drawerName | 名称 | String | 名称 | O |
| drawerType | 主体类型 | String | 主体类型 C：企业 P：个人 | O |
| documentType | 证件类型 | String | 证件类型 ID:身份证 DRIVERING_LICENSE：驾驶证 PASSPORT：护照 CI:营业执照 CERTIFICATE_EXISTENCE : 企业存续证书 CERTIFICATE_INCORPORATION:公司注册书 REGISTRATION_CERTIFICATE:商业登记证 | O |
| traderType | 汇款类型 | String | 汇款类型： SWIFT、FPS、ACT、CHATS/RTGS、UK Faster Payment、SEPA、EFT、ABA | O |
| pageIndex | 页数 | Integer | 默认1 | O |
| pageSize | 条数 | Integer | 默认10 | O |

#### 23.3.1 请求示例

```html
{
	"cardType": "RECEIPT",
	"outDrawerNo": "3434623432",
    "drawerName": "测试drawerName",
    "drawerType": "C",
    "documentType": "IC",
    "drawerBankCountry": "HK",
    "traderType": "FPS"
}
```

### 23.4 返回参数

| 参数名称 | 参数中文名称 | 类型 | 参数说明 |
| ----------------------- | ----------------------------------- | ------ | ------------------------------------------------------------ |
| subMerchantNo | 子商户号 | String | 子商户号 |
| outDrawerNo | 商户自定义no | String | 商户自定义no |
| cardType | 收付款对象类型 | String | 收付款对象类型 RECEIPT：汇款收款人账户 SETTLE：结汇账户 PAYEE:收款付款人 |
| drawerType | 主体类型 | String | 主体类型 C：企业 P：个人 |
| drawerName | 名称 | String | 名称 |
| drawerSurname | 主体姓氏 | String | 主体姓氏 |
| middleName | 中间名 | String | 中间名 |
| drawerFormerName | 曾用名 | String | 曾用名 |
| drawerDate | 个人的出生日期/企业的注册日期 | String | 个人的出生日期/企业的注册日期 |
| drawerSex | 性别 | String | 性别 M：男 F：女 |
| drawerCountry | 企业注册国家/地区，个人国籍 | String | 企业注册国家/地区、个人国籍，两位国家代码如香港：HK |
| documentType | 证件类型 | String | 证件类型 ID:身份证 DRIVERING_LICENSE：驾驶证 PASSPORT：护照 CI:营业执照 CERTIFICATE_EXISTENCE : 企业存续证书 CERTIFICATE_INCORPORATION:公司注册书 REGISTRATION_CERTIFICATE:商业登记证 |
| documentNumber | 证件号 | String | 证件号,加密数据 |
| documentStartDate | 证件开始日期 | String | 证件开始日期 格式：yy-MM-dd 如：1990-01-01 |
| documentEndDate | 证件结束日期 | String | 证件结束日期 格式：yy-MM-dd 如：1990-01-01 |
| documentCountry | 发证国家或地区 | String | 两位国家代码如香港：HK |
| drawerAddress | 详细地址，企业注册地址/个人通讯地址 | String | 详细地址，企业注册地址/个人通讯地址 |
| email | 收付款人邮箱 | String | 收付款人邮箱 |
| mobile | 收付款人联系电话 | String | 收付款人联系电话 |
| drawerBankAccountNumber | 银行账号 | String | 银行账号，加密数据 |
| drawerBankAccountName | 银行账户名称 | String | 银行账户名称 |
| drawerBankCountry | 银行所在地 | String | 两位国家代码 如香港：HK |
| drawerBankName | 银行名称 | String | 银行名称 |
| drawerBankAddress | 银行所在地址详情 | String | 银行所在地址详情 |
| drawerBankBranchName | 分行名称 | String | 分行名称 |
| swiftCode | swiftCode | String | swiftCode |
| sortCode | sortCode | String | sortCode |
| aba | aba | String | aba |
| bsb | bsb | String | bsb |
| businessCountry | 展业地区 | String | 两位国家代码 如香港：HK |
| drawerProvince | 主体省份 | String | |
| drawerCity | 主体城市 | String | |
| drawerOperatingCountry | 企业运营国家/个人通讯国家 | String | 两位国家代码 如香港：HK |
| drawerOperatingProvince | 企业运营省份/个人通讯省份 | String | |
| drawerOperatingCity | 企业运营城市/个人通讯城市 | String | |
| drawerOperatingAddress | 运营详细地址 | String | 运营详细地址 |
| traderType | 汇款类型 | String | 汇款类型： SWIFT、FPS、ACT、CHATS/RTGS、UK Faster Payment、SEPA、EFT、ABA |
| currency | 币种 | String | 币种三位代码 如港币：HKD |
| drawerBankCode | 银行编码 | String | 银行编码 |
| certificateFileList | 证件文件集 | Array | |
| otherFileList | 其他文件集 | Array | |
| postalCode | 注册邮编 | String | 注册邮编 |
| drawerBankBranchCode | 运营邮编 | String | 运营邮编 |

#### 23.4.1 返回示例（data，相应信息）

```html
{
	"code": 200,
	"msg": "成功",
	"data": {
		"total": 2,
		"dataList": [
			{
				"outDrawerNo": "3434623432",
				"cardType": "RECEIPT",
				"subMerchantNo": "80000138",
				"drawerName": "测试drawerName",
				"drawerSurname": "",
				"drawerFormerName": null,
				"drawerDate": "2019-01-01",
				"drawerType": "C",
				"drawerSex": null,
				"drawerCountry": "HK",
				"documentType": "IC",
				"documentNumber": "a4wnpqa2FCbTBdeDvzaEK4Try31gTexEq2DaziToFiBEF1dgfGQ9g2XwrSHu8iAKkEWNsSYLvOvfRKSxHdlg0y1b9dlWVPbmaY9jZpPHH753Gdp+NJCvGw0K/qHc7ulDCJ5vP+VEudT7VwJ5P9F3XktIAqv0lK2Qoan3+OgZzZH7GXJFtPB7abO2MAPp1f4av/cdao+s7jhYym+j+YbFX1zOZ3g91HVeQj1jFnXg140fz0EJlLOFYYJxl/QuF6vRH2H4kR1fcjph9Hy+hXF4LHpJsNB/p34ezT6aEsqLjtaJu6r3It9YTct1AA9t0J+TkO8NA4ndCja/dm4Kmg7ZyQ==",
				"documentStartDate": "2019-01-01",
				"documentEndDate": "2025-01-01",
				"documentCountry": "HK",
				"drawerAddress": "测试drawerAddress",
				"email": null,
				"mobile": null,
				"drawerBankAccountNumber": "ZLpIMI9bac0hOcJEUsqZce41g5j+k6oTC6wPGMpzNakpYYilx38Z0SxIVmvfM7N29dD4WhaWWuKynOhA2Wcv+YRGXgEstPEksmyz6JrKoDBDtB5yBMQu3XTQ/lkRUoKjQCiHAER/1gc75pQv9YZzVJNNsd7SGUh042fdZryritjp6UggG8nuhUfj08+4QcrUMtoN70zbbfmGwmDClYp3mvDgZuV0n/Itc2FHGyBqexxhpEFFRTb66L6vpfwXZ4EtjlkFlOBI6Jv8EHcQPCtrea+tFxHAMxekpEuvpcPS9XCvlXpZXqAD4d70Ax6zfC1GAA0pyG5jh69mPed1/00bKw==",
				"drawerBankAccountName": "张三",
				"drawerBankCountry": null,
				"drawerBankName": null,
				"drawerBankAddress": null,
				"swiftCode": null,
				"sortCode": null,
				"iban": null,
				"aba": null,
				"bsb": null,
				"businessCountry": null,
				"drawerProvince": "",
				"drawerCity": "",
				"drawerOperatingCountry": "HK",
				"drawerOperatingProvince": "",
				"drawerOperatingCity": "",
				"drawerOperatingAddress": "北京海淀区XXX",
				"traderType": "FPS",
				"currency": null,
				"middleName": null,
				"createTime": "2023-02-17 10:49:09"
			}
		]
	}
}
```

## 24.查询收付款对象详情

### 24.1 功能描述

查询收付款对象详情

### 24.2 接口地址

请求地址：/drawer/detail
请求方式：POST

### 24.3 请求参数

| 参数名称    | 参数中文名称 | 类型   | 参数说明     | 是否必填 |
| ----------- | ------------ | ------ | ------------ | -------- |
| outDrawerNo | 商户自定义no | String | 商户自定义no | M        |

#### 24.3.1 请求示例

```html
{
	"outDrawerNo": "3434623432"
}
```

### 24.4 返回参数

| 参数名称 | 参数中文名称 | 类型 | 参数说明 |
| ----------------------- | ----------------------------------- | ------ | ------------------------------------------------------------ |
| subMerchantNo | 子商户号 | String | 子商户号 |
| outDrawerNo | 商户自定义no | String | 商户自定义no |
| cardType | 收付款对象类型 | String | 收付款对象类型 RECEIPT：汇款收款人账户 SETTLE：结汇账户 PAYEE:收款付款人 |
| drawerType | 主体类型 | String | 主体类型 C：企业 P：个人 |
| drawerName | 名称 | String | 名称 |
| drawerSurname | 主体姓氏 | String | 主体姓氏 |
| middleName | 中间名 | String | 中间名 |
| drawerFormerName | 曾用名 | String | 曾用名 |
| drawerDate | 个人的出生日期/企业的注册日期 | String | 个人的出生日期/企业的注册日期 |
| drawerSex | 性别 | String | 性别 M：男 F：女 |
| drawerCountry | 企业注册国家/地区，个人国籍 | String | 企业注册国家/地区、个人国籍，两位国家代码如香港：HK |
| documentType | 证件类型 | String | 证件类型 ID:身份证 DRIVERING_LICENSE：驾驶证 PASSPORT：护照 CI:营业执照 CERTIFICATE_EXISTENCE : 企业存续证书 CERTIFICATE_INCORPORATION:公司注册书 REGISTRATION_CERTIFICATE:商业登记证 |
| documentNumber | 证件号 | String | 证件号,加密数据 |
| documentStartDate | 证件开始日期 | String | 证件开始日期 格式：yy-MM-dd 如：1990-01-01 |
| documentEndDate | 证件结束日期 | String | 证件结束日期 格式：yy-MM-dd 如：1990-01-01 |
| documentCountry | 发证国家或地区 | String | 两位国家代码如香港：HK |
| drawerAddress | 详细地址，企业注册地址/个人通讯地址 | String | 详细地址，企业注册地址/个人通讯地址 |
| email | 收付款人邮箱 | String | 收付款人邮箱 |
| mobile | 收付款人联系电话 | String | 收付款人联系电话 |
| drawerBankAccountNumber | 银行账号 | String | 银行账号，加密数据 |
| drawerBankAccountName | 银行账户名称 | String | 银行账户名称 |
| drawerBankCountry | 银行所在地 | String | 两位国家代码 如香港：HK |
| drawerBankName | 银行名称 | String | 银行名称 |
| drawerBankAddress | 银行所在地址详情 | String | 银行所在地址详情 |
| drawerBankBranchName | 分行名称 | String | 分行名称 |
| swiftCode | swiftCode | String | swiftCode |
| sortCode | sortCode | String | sortCode |
| aba | aba | String | aba |
| bsb | bsb | String | bsb |
| businessCountry | 展业地区 | String | 两位国家代码 如香港：HK |
| drawerProvince | 主体省份 | String | |
| drawerCity | 主体城市 | String | |
| drawerOperatingCountry | 企业运营国家/个人通讯国家 | String | 两位国家代码 如香港：HK |
| drawerOperatingProvince | 企业运营省份/个人通讯省份 | String | |
| drawerOperatingCity | 企业运营城市/个人通讯城市 | String | |
| drawerOperatingAddress | 运营详细地址 | String | 运营详细地址 |
| traderType | 汇款类型 | String | 汇款类型： SWIFT、FPS、ACT、CHATS/RTGS、UK Faster Payment、SEPA、EFT、ABA |
| currency | 币种 | String | 币种三位代码 如港币：HKD |
| drawerBankCode | 银行编码 | String | 银行编码 |
| certificateFileList | 证件文件集 | Array | |
| otherFileList | 其他文件集 | Array | |
| postalCode | 注册邮编 | String | 注册邮编 |
| drawerBankBranchCode | 运营邮编 | String | 运营邮编 |

#### 24.4.1 返回示例（data，相应信息）

```html
{
	"code": 200,
	"msg": "成功",
	"data": {
		"outDrawerNo": "3434623432",
		"cardType": "RECEIPT",
		"subMerchantNo": "80000138",
		"drawerName": "测试drawerName",
		"drawerSurname": "",
		"drawerFormerName": null,
		"drawerDate": "2019-01-01",
		"drawerType": "C",
		"drawerSex": null,
		"drawerCountry": "HK",
		"documentType": "IC",
		"documentNumber": "Qd2vqevPlrree0LxkHv6neczQ9+eSvIv8+sUB6GAzP108XjQeyWqX42rB6lmcS6mTdvODS3GxY14bf8RJeiYdkaG5xpEoPoenLDZErTX2FFey5fCmAon7O62lrv5sr3ncEFH4oPUDAy+gAgSnUgdGYAsj6+yaEIRCSfCMJeXvEdBh18BuwoWR2n7NSkTABwO/9Jf13mLPQiT9LAUBfdb2Kq2+UZznRWi5EeqFQTcijst7S+xoprFZwkCrNOm/7EBO++ObS7TwiXXMVeztpBrVurGoMk+i7Hm18qegt9IeXoGSq7cOUFsZw2+SQAaM6Za93NYaSDJLfznlHaZEexGyw==",
		"documentStartDate": "2019-01-01",
		"documentEndDate": "2025-01-01",
		"documentCountry": "HK",
		"drawerAddress": "测试drawerAddress",
		"email": null,
		"mobile": null,
		"drawerBankAccountNumber": "nuH5wZoupcVtyxhYaNS4Oljq2RoYmeRZWL09ip9AZWXriRF8vTbiIYf7cZ1J0tvBGhrBgr981G+0cA4Mba+0ZAOgYaYL5vw1WcDhgorBmKZ4fJbCCegUnNu3BMl8c0h/wCleNfhmauEOwiOv6m4JWhqBaB2gGHQpTzK7p7fSNU7Q2qwrpuOAJkMSBMloqECe/1C9JaDm4ZZ+mLPSYwzBbWrt9DGJoyTDRnqDNrA/qQjiD+JWFSe2hBt11/6ZyZ5YnAxgUW2RZgENeLo0o7YiggvzjJVGj7ErJVmA4AJMKXqU4ndX8PsJxAV91NS7KjFROnGpO+Famo9IUJ0EJvyVkA==",
		"drawerBankAccountName": "张三",
		"drawerBankCountry": null,
		"drawerBankName": null,
		"drawerBankAddress": null,
		"swiftCode": null,
		"sortCode": null,
		"iban": null,
		"aba": null,
		"bsb": null,
		"businessCountry": null,
		"drawerProvince": "",
		"drawerCity": "",
		"drawerOperatingCountry": "HK",
		"drawerOperatingProvince": "",
		"drawerOperatingCity": "",
		"drawerOperatingAddress": "北京海淀区XXX",
		"traderType": "FPS",
		"currency": null,
		"middleName": null,
		"createTime": "2023-02-17 10:49:09"
	}
}
```

## 25.删除收付款对象

### 25.1 功能描述

删除收付款对象

### 25.2 接口地址

请求地址：/drawer/delete
请求方式：POST

### 25.3 请求参数

| 参数名称    | 参数中文名称 | 类型   | 参数说明     | 是否必填 |
| ----------- | ------------ | ------ | ------------ | -------- |
| outDrawerNo | 商户自定义no | String | 商户自定义no | M        |

#### 25.3.1 请求示例

```html
{
	"outDrawerNo": "3434623432"
}
```

#### 25.4 返回示例（data，相应信息）

```html
{
	"code": 200,
	"msg": "成功"
}
```

## 26.询价

### 26.1 功能描述

汇款询价

### 26.2 接口地址

请求地址：/transfer/enquiry
请求方式：POST

### 26.3请求参数

| 参数名称 | 参数中文名称 | 类型 | 参数说明 | 是否必填 |
| -------------- | ---------------- | ---------- | ------------------------------------------------------------ | -------- |
| receivedAmount | 收到金额 | BigDecimal | 收到金额 | M |
| outDrawerNo | 收款人对象外部no | String | 收付款人外部no | M |
| commerceType | 贸易类型 | String | 贸易类型 CARGO：货物贸易 SERVICE:服务贸易 收款人对象的cardType为SETTLE时必填 | C |

#### 26.3.1 请求示例

```html
{
   "receivedAmount": "111",
   "outDrawerNo": "123123",
   "commerceType": "SERVICE"
}
```

### 26.4 返回参数

| 参数名称    | 参数中文名称 | 类型       | 参数说明                          |
| ----------- | ------------ | ---------- | --------------------------------- |
| feeAmount   | 手续费金额   | BigDecimal | 手续费金额                        |
| feeCurrency | 手续费币种   | String     | 3位币种代码如 人民币（在岸）：CNY |

#### 26.4.1 返回示例（data，相应信息）

```html
{
	"code": 200,
	"msg": "成功",
	"data": {
		"feeAmount": 109,
		"feeCurrency": "CNY"
	}
}
```

## 27.创建汇款单

### 27.1 功能描述

创建汇款单

### 27.2 接口地址

请求地址：/transfer/create
请求方式：POST

### 27.3 请求参数

| 参数名称 | 参数中文名称 | 类型 | 参数说明 | 是否必填 |
| ---------------- | ------------------ | ---------- | ------------------------------------------------------------ | -------- |
| outTradeNo | 商户自定义单号 | String | 商户自定义单号 | M |
| sendBalanceNo | 汇出账户号 | String | 汇出账户号 | M |
| receivedAmount | 收到金额 | BigDecimal | 收到金额 | M |
| outDrawerNo | 收款人对象外部no | String | 收付款人外部no | M |
| showRemitterInfo | 是否显示汇款人信息 | Integer | 是否显示汇款人信息 0:不显示 1：显示 | M |
| chargeType | 手续费承担方式 | String | 手续费承担方式 SHA：共同承担 OUR：汇款人承担 BEN：收款人承担（欧美支付账户不支持） 针对收款人对象的traderType为SWIFT时必填 | C |
| purposeCode | 汇款用途编码 | String | [[详见附录](https://mrdoc.transfereasy.com/project-6/doc-45/ "详见附录")]("purposeCode") | M |
| commerceType | 贸易类型 | String | 贸易类型 CARGO：货物贸易 SERVICE：服务贸易 收款人对象的cardType为SETTLE时必填 | C |
| remarks | 交易附言 | String | 交易附言 | O |
| contractFileList | 合同文件集 | Array | | O |
| invoiceFileList | 发票文件集 | Array | | O |
| otherFileList | 其他文件集 | Array | | O |

#### 27.3.1 请求示例

```html
{
    "outTradeNo": "325343342334334",
    "sendBalanceNo": "10102115780000138",
    "receivedAmount": "1000",
    "outDrawerNo": "123123",
    "commerceType": "SERVICE",
    "showRemitterInfo": 1,
    "purposeCode": "Trade in goods",
    "remarks": "",
    "contractFiles": [
		{
			"fileName": "a.png",
			"filePath": "https://t-bj-private-dev.oss-cn-qingdao.aliyuncs.com/admin/2023/FEBRUARY/17/a.png"
		}
	]
	]
}
```

### 27.4 返回参数

| 参数名称 | 参数中文名称 | 类型 | 参数说明 |
| ---------------- | ------------------ | ---------- | ------------------------------------------------------------ |
| batchNo | 批次号 | String | 批次号 |
| orderNo | 订单号 | String | 订单号 |
| outTradeNo | 商户自定义单号 | String | 商户自定义单号 |
| subMerchantNo | 子商户号 | String | 子商户号 |
| receivedCurrency | 收到币种 | String | 3位币种代码如港币：HKD |
| receivedAmount | 收到金额 | BigDecimal | 收到金额 |
| sendCurrency | 汇出币种 | String | 3位币种代码如港币：HKD |
| sendAmount | 汇出金额 | BigDecimal | 汇出金额 |
| chargeCurrency | 手续费币种 | String | 3位币种代码如港币：HKD |
| chargeAmount | 手续费金额 | BigDecimal | 手续费金额 |
| createTime | 创建时间 | String | 创建时间 |
| orderStatus | 订单状态 | String | 订单状态 1:审核中 2:交割中 3:已完成 4:已取消 5:全部退款 6:部分退款 |
| commerceType | 贸易类型 | String | 贸易类型 CARGO：货物贸易 SERVICE:服务贸易 |
| showRemitterInfo | 是否显示汇款人信息 | Integer | 是否显示汇款人信息 0:不显示 1：显示 |
| purpose | 用途 | String | 用途 |
| remarks | 交易附言 | String | 交易附言 |
| outDrawerNo | 收款人对象外部no | String | 收付款人外部no |
| processRemarks | 驳回原因 | String | 驳回原因 |
| sendBalanceNo | 汇出账户号 | String | 汇出账户号 |
| sendCountry | 汇出地区 | String | 2位国家代码如香港：HK |

drawerInfo：收款对象基本信息

| 参数名称                | 参数中文名称                        | 类型   | 参数说明                            |
| ----------------------- | ----------------------------------- | ------ | ----------------------------------- |
| outDrawerNo             | 收款人对象外部no                    | String | 收付款人外部no                      |
| drawerName              | 收款人名称                          | String | 收款人名称                          |
| drawerAddress           | 详细地址，企业注册地址/个人通讯地址 | String | 详细地址，企业注册地址/个人通讯地址 |
| drawerBankAccountName   | 银行账户名称                        | String | 银行账户名称                        |
| drawerBankName          | 银行名称                            | String | 银行名称                            |
| drawerBankCountry       | 银行所在地                          | String | 2位国家代码如香港：HK               |
| drawerBankAccountNumber | 银行账户号                          | String | 敏感信息加密返回                    |

#### 27.4.1 返回示例（data，相应信息）

订单不存在时返回如下，可根据传入的outTradeNo查询订单详情：

```html
{
	"code": 200,
	"msg": "成功",
	"data": null
}
```

订单存在时返回如下：

```html
{
	"code": 200,
	"msg": "成功",
	"data": {
		"batchNo": "2023022100004",
		"orderNo": "2023022116408111",
		"outTradeNo": "325343342334334",
		"subMerchantNo": "80000138",
		"orderType": null,
		"receivedCurrency": "CNY",
		"receivedAmount": 1000,
		"sendCurrency": "CNY",
		"sendAmount": 1000,
		"chargeAmount": 118,
		"chargeCurrency": "CNY",
		"createTime": "2023-02-21 16:40:07",
		"completedTime": null,
		"orderStatus": 1,
		"commerceType": "SERVICE",
		"showRemitterInfo": 1,
		"purpose": "货物贸易",
		"remarks": "",
		"outDrawerNo": "123123",
		"processRemarks": null,
		"businessType": null,
		"sendBalanceNo": "10102115780000138",
		"sendCountry": "HK",
		"drawerInfo": {
			"outDrawerNo": "123123",
			"drawerName": "席乙朔",
			"drawerAddress": "广州市南沙区进港大道1811室",
			"drawerBankAccountName": "席乙朔",
			"drawerBankName": "农业银行",
			"drawerBankCountry": "CN",
			"drawerBankAccountNumber": "i0lxnD5GnA8+1RYPto/r+YU1znnqBh15hu+kRhq/dY2HcjeYNDGSeqclNnF+bqPY1Nw3vIqavJ5QzRSXD979fQnBVm74ct8HZBkg6Mw10o1J+wMZ7kQlFRAakjg/stdpsZNVl3V4AwEyEDIcaffXS8Sg5sVtGwVFMBBN1432NObreTT2t9dqxXxN3HiJRXZL38momRQ2YfqBYD8KUHcqA01CZMeFQ2VyqXCm6DTXdc5CU1lKGYEPfp4XboiD3E9ecHPrfcPUN7w8UPPoTWCNl/w/8PDF2htIHZturPNB+Y3JpYXwyQzx6LjCOs8wPVFwZpMmi/Qseits3QUz8XkF+g=="
		}
	}
}
```

## 28.查询汇款列表

### 28.1 功能描述

查询汇款列表

### 28.2 接口地址

请求地址：/transfer/list
请求方式：POST

### 28.3 请求参数

| 参数名称 | 参数中文名称 | 类型 | 参数说明 | 是否必填 |
| --------------- | -------------- | ------- | ------------------------------------------------------------ | -------- |
| batchNo | 批次号 | String | 批次号 | O |
| orderNo | 订单号 | String | 订单号 | O |
| outTradeNo | 商户自定义单号 | String | 商户自定义单号 | O |
| sendCurrency | 汇出币种 | String | 3位币种代码如港币：HKD | O |
| receiveCurrency | 收到币种 | String | 3位币种代码如港币：HKD | O |
| orderStatus | 汇款单状态 | Integer | 订单状态 1:审核中 2:交割中 3:已完成 4:已取消 5:全部退款 6:部分退款 | O |
| startTime | 开始时间 | String | 如 2023-01-01 00:00:00 | O |
| endTime | 结束时间 | String | 如 2023-01-02 00:00:00 | O |
| startIndex | 页数 | Integer | 默认1 | O |
| pageSize | 每页条数 | Integer | 默认10 | O |

#### 28.3.1 请求示例

```html
{
	"batchNo":"2023021700002",
	"orderNo":"2023021715031851",
	"outTradeNo":"325343234",
	"sendCurrency":"HKD",
	"receiveCurrency":"HKD",
	"orderStatus":"1",
	"startTime":"2023-02-17 00:00:00",
	"endTime":"2023-02-18 00:00:00"
}
```

### 28.4 返回参数

| 参数名称 | 参数中文名称 | 类型 | 参数说明 |
| ---------------- | ------------------ | ---------- | ------------------------------------------------------------ |
| orderNo | 订单号 | String | 订单号 |
| outTradeNo | 商户自定义单号 | String | 商户自定义单号 |
| subMerchantNo | 子商户号 | String | 子商户号 |
| receivedCurrency | 收到币种 | String | 3位币种代码如港币：HKD |
| receivedAmount | 收到金额 | BigDecimal | 收到金额 |
| sendCurrency | 汇出币种 | String | 3位币种代码如港币：HKD |
| sendAmount | 汇出金额 | BigDecimal | 汇出金额 |
| chargeCurrency | 手续费币种 | String | 3位币种代码如港币：HKD |
| chargeAmount | 手续费金额 | BigDecimal | 手续费金额 |
| createTime | 创建时间 | String | 创建时间 |
| completedTime | 完成时间 | String | 完成时间 |
| orderStatus | 订单状态 | String | 订单状态 1:审核中 2:交割中 3:已完成 4:已取消 5:全部退款 6:部分退款 |
| commerceType | 贸易类型 | String | 贸易类型 CARGO：货物贸易 SERVICE:服务贸易 |
| showRemitterInfo | 是否显示汇款人信息 | Integer | 是否显示汇款人信息 0:不显示 1：显示 |
| purpose | 用途 | String | 用途 |
| remarks | 交易附言 | String | 交易附言 |
| outDrawerNo | 收款人对象外部no | String | 收付款人外部no |
| processRemarks | 驳回原因 | String | 驳回原因 |
| sendBalanceNo | 汇出账户号 | String | 汇出账户号 |
| sendCountry | 汇出地区 | String | 2位国家代码如香港：HK |

drawerInfo：收款对象基本信息

| 参数名称                | 参数中文名称                        | 类型   | 参数说明                            |
| ----------------------- | ----------------------------------- | ------ | ----------------------------------- |
| outDrawerNo             | 收款人对象外部no                    | String | 收付款人外部no                      |
| drawerName              | 收款人名称                          | String | 收款人名称                          |
| drawerAddress           | 详细地址，企业注册地址/个人通讯地址 | String | 详细地址，企业注册地址/个人通讯地址 |
| drawerBankAccountName   | 银行账户名称                        | String | 银行账户名称                        |
| drawerBankName          | 银行名称                            | String | 银行名称                            |
| drawerBankCountry       | 银行所在地                          | String | 2位国家代码如香港：HK               |
| drawerBankAccountNumber | 银行账户号                          | String | 敏感信息加密返回                    |

#### 28.4.1 返回示例（data，相应信息）

```html
{
	"code": 200,
	"msg": "成功",
	"data": {
		"total": 1,
		"dataList": [
			{
				"batchNo": "2023021700002",
				"orderNo": "2023021715031851",
				"outTradeNo": "325343234",
				"subMerchantNo": "80000138",
				"orderType": null,
				"receivedCurrency": "HKD",
				"receivedAmount": 111,
				"sendCurrency": "HKD",
				"sendAmount": 111,
				"chargeAmount": 20931,
				"chargeCurrency": "HKD",
				"createTime": "2023-02-17 15:03:24",
				"completedTime": null,
				"orderStatus": 1,
				"commerceType": null,
				"showRemitterInfo": 1,
				"purpose": "货物贸易",
				"remarks": "",
				"outDrawerNo": "3434",
				"processRemarks": null,
				"businessType": null,
				"sendBalanceNo": "10102134480000138",
				"sendCountry": "HK",
				"drawerInfo": {
					"outDrawerNo": "3434",
					"drawerName": "aaa",
					"drawerAddress": "daf",
					"drawerBankAccountName": "65767",
					"drawerBankName": "56",
					"drawerBankCountry": "HK",
					"drawerBankAccountNumber": "Usx5BLcfZbRS2HkgqI3Sf2WrcYdwQiLUomWiffIkAXye3i1x/fBTjcINJJ3fFHt4A6KtM0Ce/7KrideCr/6CQBwDu2XMcxhh6qjWh3V+wiKgIl0QRHDXqmhK/WqhRKHenM47ubYskAqvdiv6eOuSoRkx88DXARzVINNqHre3Mw1z/F6viDYLAL6wgkbzDCRxlOgIH/xFWutSPNpjLdjg1cY7i6L3nd5Vq04SE6bkfLhfgWUBMttBQYQkl9qHdtu89eLc0oAwUOhBoBscrLQgl0cumF6slObIPcr300t7Ru82oai7T9g5hbqUeC7ukudxhjeAbwXOhd49rrainFoRCw=="
				}
			}
		]
	}
}
```

### 28.5 汇款审核异步返回列表

注意：此表格的参数为NotifyUrl的服务器返回参数

| 参数名称 | 参数中文名称 | 类型 | 参数说明 |
| ---------------- | ------------------ | ---------- | -------------- |
| orderNo | 订单号 | String | 订单号 |
| outTradeNo | 商户自定义单号 | String | 商户自定义单号 |
| subMerchantNo | 子商户号 | String | 子商户号 |
| receivedCurrency | 收到币种 | String | 3位币种代码如港币：HKD |
| receivedAmount | 收到金额 | BigDecimal | 收到金额 |
| sendCurrency | 汇出币种 | String | 3位币种代码如港币：HKD |
| sendAmount | 汇出金额 | BigDecimal | 汇出金额 |
| chargeCurrency | 手续费币种 | String | 3位币种代码如港币：HKD |
| chargeAmount | 手续费金额 | BigDecimal | 手续费金额 |
| createTime | 创建时间 | String | 创建时间 |
| completedTime | 完成时间 | String | 完成时间 |
| orderStatus | 订单状态 | String | 订单状态 1:审核中 2:交割中 3:已完成 4:已取消 5:全部退款 6:部分退款 |
| commerceType | 贸易类型 | String | 贸易类型 CARGO：货物贸易 SERVICE:服务贸易 |
| showRemitterInfo | 是否显示汇款人信息 | Integer | 是否显示汇款人信息 0:不显示 1：显示 |
| purpose | 用途 | String | 用途 |
| remarks | 交易附言 | String | 交易附言 |
| outDrawerNo | 收款人对象外部no | String | 收付款人外部no |
| processRemarks | 驳回原因 | String | 驳回原因 |
| sendBalanceNo | 汇出账户号 | String | 汇出账户号 |
| sendCountry | 汇出地区 | String | 2位国家代码如香港：HK |
| notifyUrl | 通知地址 | String | 通知地址 |
| msgType | 通知状态 | String | 通知状态 例：TRANSFER |

drawerInfo：收款对象基本信息

| 参数名称                | 参数中文名称                        | 类型   | 参数说明                            |
| ----------------------- | ----------------------------------- | ------ | ----------------------------------- |
| outDrawerNo             | 收款人对象外部no                    | String | 收付款人外部no                      |
| drawerName              | 收款人名称                          | String | 收款人名称                          |
| drawerAddress           | 详细地址，企业注册地址/个人通讯地址 | String | 详细地址，企业注册地址/个人通讯地址 |
| drawerBankAccountName   | 银行账户名称                        | String | 银行账户名称                        |
| drawerBankName          | 银行名称                            | String | 银行名称                            |
| drawerBankCountry       | 银行所在地                          | String | 2位国家代码如香港：HK               |
| drawerBankAccountNumber | 银行账户号                          | String | 敏感信息加密返回                    |

#### 28.4.1 返回示例（data，相应信息）

```html
 {
		"total": 1,
		"dataList": [
			{
				"notifyUrl":"http://fsdifnsdifisf",
				"msgType":"TRANSFER",
				"batchNo": "2023021700002",
				"orderNo": "2023021715031851",
				"outTradeNo": "325343234",
				"subMerchantNo": "80000138",
				"orderType": null,
				"receivedCurrency": "HKD",
				"receivedAmount": 111,
				"sendCurrency": "HKD",
				"sendAmount": 111,
				"chargeAmount": 20931,
				"chargeCurrency": "HKD",
				"createTime": "2023-02-17 15:03:24",
				"completedTime": null,
				"orderStatus": 1,
				"commerceType": null,
				"showRemitterInfo": 1,
				"purpose": "货物贸易",
				"remarks": "",
				"outDrawerNo": "3434",
				"processRemarks": null,
				"businessType": null,
				"sendBalanceNo": "10102134480000138",
				"sendCountry": "HK",
				"drawerInfo": {
					"outDrawerNo": "3434",
					"drawerName": "aaa",
					"drawerAddress": "daf",
					"drawerBankAccountName": "65767",
					"drawerBankName": "56",
					"drawerBankCountry": "HK",
					"drawerBankAccountNumber": "Usx5BLcfZbRS2HkgqI3Sf2WrcYdwQiLUomWiffIkAXye3i1x/fBTjcINJJ3fFHt4A6KtM0Ce/7KrideCr/6CQBwDu2XMcxhh6qjWh3V+wiKgIl0QRHDXqmhK/WqhRKHenM47ubYskAqvdiv6eOuSoRkx88DXARzVINNqHre3Mw1z/F6viDYLAL6wgkbzDCRxlOgIH/xFWutSPNpjLdjg1cY7i6L3nd5Vq04SE6bkfLhfgWUBMttBQYQkl9qHdtu89eLc0oAwUOhBoBscrLQgl0cumF6slObIPcr300t7Ru82oai7T9g5hbqUeC7ukudxhjeAbwXOhd49rrainFoRCw=="
				}
			}
		]
}
```

## 29.查询汇款详情

### 29.1 功能描述

查询汇款详情

### 29.2 接口地址

请求地址：/transfer/detail
请求方式：POST

### 29.3 请求参数

| 参数名称   | 参数中文名称       | 类型   | 参数说明                                                     | 是否必填 |
| ---------- | ------------------ | ------ | ------------------------------------------------------------ | -------- |
| orderNo    | 订单号             | String | orderNo与outTradeNo两参数⼆选⼀即可, 若同时传⼊两参数, 以 orderNo 为准 | O        |
| outTradeNo | 商户自定义外部单号 | String | orderNo与outTradeNo两参数⼆选⼀即可, 若同时传⼊两参数, 以 orderNo 为准 | O        |

#### 29.3.1 请求示例

```html
{
	"orderNo": "",
	"outTradeNo": "32534324"
}
```

### 29.4 返回参数

| 参数名称 | 参数中文名称 | 类型 | 参数说明 |
| ---------------- | ------------------ | ---------- | ------------------------------------------------------------ |
| orderNo | 订单号 | String | 订单号 |
| outTradeNo | 商户自定义单号 | String | 商户自定义单号 |
| subMerchantNo | 子商户号 | String | 子商户号 |
| receivedCurrency | 收到币种 | String | 3位币种代码如港币：HKD |
| receivedAmount | 收到金额 | BigDecimal | 收到金额 |
| sendCurrency | 汇出币种 | String | 3位币种代码如港币：HKD |
| sendAmount | 汇出金额 | BigDecimal | 汇出金额 |
| chargeCurrency | 手续费币种 | String | 3位币种代码如港币：HKD |
| chargeAmount | 手续费金额 | BigDecimal | 手续费金额 |
| createTime | 创建时间 | String | 创建时间 |
| completedTime | 完成时间 | String | 完成时间 |
| orderStatus | 订单状态 | String | 订单状态 1:审核中 2:交割中 3:已完成 4:已取消 5:全部退款 6:部分退款 |
| commerceType | 贸易类型 | String | 贸易类型 CARGO：货物贸易 SERVICE:服务贸易 |
| showRemitterInfo | 是否显示汇款人信息 | Integer | 是否显示汇款人信息 0:不显示 1：显示 |
| purpose | 用途 | String | 用途 |
| remarks | 交易附言 | String | 交易附言 |
| outDrawerNo | 收款人对象外部no | String | 收付款人外部no |
| processRemarks | 驳回原因 | String | 驳回原因 |
| sendBalanceNo | 汇出账户号 | String | 汇出账户号 |
| sendCountry | 汇出地区 | String | 2位国家代码如香港：HK |

drawerInfo：收款对象基本信息

| 参数名称                | 参数中文名称                        | 类型   | 参数说明                            |
| ----------------------- | ----------------------------------- | ------ | ----------------------------------- |
| outDrawerNo             | 收款人对象外部no                    | String | 收付款人外部no                      |
| drawerName              | 收款人名称                          | String | 收款人名称                          |
| drawerAddress           | 详细地址，企业注册地址/个人通讯地址 | String | 详细地址，企业注册地址/个人通讯地址 |
| drawerBankAccountName   | 银行账户名称                        | String | 银行账户名称                        |
| drawerBankName          | 银行名称                            | String | 银行名称                            |
| drawerBankCountry       | 银行所在地                          | String | 2位国家代码如香港：HK               |
| drawerBankAccountNumber | 银行账户号                          | String | 敏感信息加密返回                    |

#### 29.4.1 返回示例（data，相应信息）

```html
{
	"code": 200,
	"msg": "成功",
	"data": {
		"batchNo": "2023021000002",
		"orderNo": "2023021010513841",
		"outTradeNo": "32534324",
		"subMerchantNo": "80000138",
		"orderType": null,
		"receivedCurrency": "HKD",
		"receivedAmount": 111,
		"sendCurrency": "HKD",
		"sendAmount": 111,
		"chargeAmount": 20931,
		"chargeCurrency": "HKD",
		"createTime": "2023-02-10 10:51:59",
		"completedTime": null,
		"orderStatus": 1,
		"commerceType": null,
		"showRemitterInfo": 1,
		"purpose": "货物贸易",
		"remarks": "",
		"outDrawerNo": "3434",
		"processRemarks": null,
		"businessType": null,
		"sendBalanceNo": "10102134480000138",
		"sendCountry": "HK",
		"drawerInfo": {
			"outDrawerNo": "3434",
			"drawerName": "aaa",
			"drawerAddress": "daf",
			"drawerBankAccountName": "65767",
			"drawerBankName": "56",
			"drawerBankCountry": "HK",
			"drawerBankAccountNumber": "OrvbJvDx7wl8bZYQEEeHFUHq5LkI1AGJ1He6RyPbrBL40jaVOFSFeog0IDxtVas76w5nRyV2783etMi/2r3JOBJ+QVT6KDowYyOP8kCp20cwHLh1v75SAUbPEIHOkOM2EnfF/GGsgXqUKoPe1bJwE2hwLLr9O1j2S1hKprC8KJk690Naa5Sw7jDKxawogpAuG6RAJAkPJ3t3MusqhRZe+IUAn5KiOOxGSRdLL6BvP9E5DdURNxqQv2w1I4vXhBcrVxCLBp3z0omAbgvyLXa99l+Odo3K1t9ivtTsHvNkFqiEqrffyMLx+IQP+WBdV56KlgX9ZdzdTWimaBx9NEIwiw=="
		}
	}
}
```

## 30.申请取消订单

### 30.1 功能描述

申请取消汇款订单(订单状态为审核中)

### 30.2 接口地址

请求地址：/transfer/cancel
请求方式：POST

### 30.3 请求参数

| 参数名称 | 参数中文名称 | 类型   | 参数说明 | 是否必填 |
| -------- | ------------ | ------ | -------- | -------- |
| orderNo  | 订单号       | String | 订单号   | M        |

#### 30.3.1 请求示例

```html
{
	"orderNo": "2023021010513841"
}
```

### 30.4 返回参数

| 参数名称 | 参数中文名称 | 参数说明 |
| --- | --- | --- |
| code | 状态码 | 请求状态码，详见附录 |
| msg | 状态描述 | 状态描述 |
| data | 数据信息 | 返回数据对象信息，在请求状态为成功时返回 |

#### 30.4.1 返回示例

```html
{
	"code": 200,
	"msg": "成功",
	"data": null
}
```

## 31.汇率

### 31.1 功能描述

查询换汇汇率

### 31.2 接口地址

请求地址：/conversion/rate
请求方式：POST

### 31.3请求参数

| 参数名称      | 参数中文名称 | 类型       | 参数说明   | 是否必填 |
| ------------- | ------------ | ---------- | ---------- | -------- |
| amount        | 交易金额     | BigDecimal | 交易金额   | M        |
| sellAccountNo | 卖出账户号   | String     | 卖出账户号 | M        |
| buyAccountNo  | 买入账户号   | String     | 买入账户号 | M        |

#### 31.3.1 请求示例

```html
{
    "amount":"100",
    "sellAccountNo":"10102134480000138",
    "buyAccountNo":"10102184080000138"
}
```

### 31.4 返回参数

| 参数名称 | 参数中文名称 | 类型   | 参数说明 |
| -------- | ------------ | ------ | -------- |
| rate     | 汇率         | String | 汇率     |
| time     | 时间         | String | 时间     |

#### 31.4.1 返回示例（data，相应信息）

```html
{
	"code": 200,
	"msg": "成功",
	"data": {
		"rate": 0.127117,
		"time": "2023-01-10 21:30:02"
	}
}
```

## 32.询价锁汇

### 32.1 功能描述

询价锁汇

### 32.2 接口地址

请求地址：/conversion/enquiry
请求方式：POST

### 32.3 请求参数

| 参数名称 | 参数中文名称 | 类型 | 参数说明 | 是否必填 |
| -------------- | ------------ | ---------- | ------------------------------------ | -------- |
| amount | 交易金额 | BigDecimal | 交易金额 | M |
| sellAccountNo | 卖出账户号 | String | 卖出账户号 | M |
| buyAccountNo | 买入账户号 | String | 买入账户号 | M |
| fixedAmountKey | 固定金额字段 | Integer | 1:固定买入 2：固定卖出 默认1 | O |

#### 32.3.1 请求示例

```html
{
    "amount":"100",
    "sellAccountNo":"10102134480000138",
    "buyAccountNo":"10102184080000138",
    "fixedAmountKey":1
}
```

### 32.4 返回参数

| 参数名称 | 参数中文名称 | 类型 | 参数说明 |
| ---------------- | ---------------------- | ---------- | ------------------------------------------------------------ |
| orderNo | 订单号 | String | 订单号 |
| outTradeNo | 商户自定义单号 | String | 商户自定义单号 |
| subMerchantNo | 子商户号 | String | 子商户号 |
| buyCurrency | 买入币种 | String | 3位币种代码如港币：HKD |
| buyAmount | 买入金额 | BigDecimal | 买入金额 |
| sellCurrency | 汇出币种 | String | 3位币种代码如港币：HKD |
| selldAmount | 汇出金额 | BigDecimal | 汇出金额 |
| rate | 汇率 | BigDecimal | 汇率 |
| rateDirect | 汇率方向 | String | 汇率方向 |
| poundage | 手续费 | BigDecimal | 手续费 |
| poundageCurrency | 手续费币种 | String | 手续费币种 |
| createTime | 创建时间 | Date | 创建时间 |
| modifyTime | 更新时间 | Date | 更新时间 |
| orderStatus | 订单状态 | Integer | 订单状态 [详见附录 订单状态（询价锁汇接口中，orderStatus 订单状态）](https://mrdoc.transfereasy.com/modify_doc/45/ "详见附录 订单状态（询价锁汇接口中，orderStatus 订单状态）") |
| sellAccountNo | 支付账户号 | String | 支付账户号 |
| buyAccountNo | 结算账户号 | String | 结算账户号 |
| preOrderId | 预下单ID，用于下换汇单 | String | 预下单ID，用于下换汇单 |

#### 32.4.1 返回示例（data，相应信息）

```html
{
	"code": 200,
	"msg": "成功",
	"data": {
		"orderNo": null,
		"outTradeNo": null,
		"subMerchantNo": "80000138",
		"buyCurrency": "USD",
		"buyAmount": 100,
		"sellCurrency": "HKD",
		"sellAmount": 787,
		"rate": 0.127117,
		"rateDirect": "1 HKD = 0.127117 USD",
		"poundage": 0,
		"poundageCurrency": "HKD",
		"createTime": null,
		"modifyTime": null,
		"orderStatus": null,
		"sellAccountNo": "10102134480000138",
		"buyAccountNo": "10102184080000138",
		"preOrderId": "9810134c1ac049d098c317ed136caf72"
	}
}
```

## 33.换汇下单

### 33.1 功能描述

下换汇单

### 33.2 接口地址

请求地址：/conversion/create
请求方式：POST

### 33.3 请求参数

| 参数名称   | 参数中文名称           | 类型   | 参数说明               | 是否必填 |
| ---------- | ---------------------- | ------ | ---------------------- | -------- |
| preOrderId | 预下单ID，用于下换汇单 | String | 预下单ID，用于下换汇单 | M        |
| outTradeNo | 商户自定义单号         | String | 商户自定义单号         | M        |

#### 33.3.1 请求示例

```html
{
    "preOrderId":"be45d279d4454f3299abe0c5d82e5723",
    "outTradeNo":"1234512345"
}
```

### 33.4 返回参数

| 参数名称 | 参数中文名称 | 类型   | 参数说明         |
| -------- | ------------ | ------ | ---------------- |
| code     | 编码         | String | 接口返回编码     |
| msg      | 返回信息     | String | 接口返回信息     |
| data     | 详细信息     | Object | 接口返回详细信息 |

data：

| 参数名称 | 参数中文名称 | 类型   | 参数说明 |
| -------- | ------------ | ------ | -------- |
| orderNo  | 订单号       | String | 订单号   |

#### 33.4.1 返回示例（data，相应信息）

```html
{
	"code": 200,
	"msg": "成功",
	"data": {
		"orderNo": "2023022014150351"
	}
}
```

## 34.换汇列表

### 34.1 功能描述

换汇列表

### 34.2 接口地址

请求地址：/conversion/list
请求方式：POST

### 34.3 请求参数

| 参数名称 | 参数中文名称 | 类型 | 参数说明 | 是否必填 |
| ------------ | ------------------ | ------- | ------------------------------------------------------------ | -------- |
| orderNo | 订单号 | String | 订单号 | O |
| outTradeNo | 商户自定义外部单号 | String | 商户自定义外部单号 | O |
| sellCurrency | 卖出币种 | String | 3位币种代码如港币：HKD | O |
| buyCurrency | 买入币种 | String | 3位币种代码如港币：HKD | O |
| orderStatus | 订单状态 | Integer | 订单状态 0:兑换中 2:交割中 3:已完成 4:已拒绝 | O |
| startTime | 开始时间 | String | 如 2023-01-01 00:00:00 | O |
| endTime | 结束时间 | String | 如 2023-01-01 00:00:00 | O |
| pageIndex | 页码 | Integer | 页码 | O |

#### 34.3.1 请求示例

```html
{
    "orderNo": "",
    "outTradeNo": "",
    "sellCurrency": "USD",
	"buyCurrency":"HKD"
}
```

### 34.4 返回参数

| 参数名称 | 参数中文名称 | 类型   | 参数说明         |
| -------- | ------------ | ------ | ---------------- |
| code     | 编码         | String | 接口返回编码     |
| msg      | 返回信息     | String | 接口返回信息     |
| data     | 详细信息     | Object | 接口返回详细信息 |

data：

| 参数名称 | 参数中文名称 | 类型 | 参数说明 |
| ---------------- | -------------- | ---------- | ------------------------------------------------------------ |
| orderNo | 订单号 | String | 订单号 |
| outTradeNo | 商户自定义单号 | String | 商户自定义单号 |
| subMerchantNo | 子商户号 | String | 子商户号 |
| buyCurrency | 买入币种 | String | 3位币种代码如港币：HKD |
| buyAmount | 买入金额 | BigDecimal | 买入金额 |
| sellCurrency | 汇出币种 | String | 3位币种代码如港币：HKD |
| selldAmount | 汇出金额 | BigDecimal | 汇出金额 |
| rate | 汇率 | BigDecimal | 汇率 |
| rateDirect | 汇率方向 | String | 汇率方向 |
| poundage | 手续费 | BigDecimal | 手续费 |
| poundageCurrency | 手续费币种 | String | 手续费币种 |
| createTime | 创建时间 | Date | 创建时间 |
| modifyTime | 更新时间 | Date | 更新时间 |
| orderStatus | 订单状态 | Integer | 订单状态 0:兑换中 2:交割中 3:已完成 4:已拒绝 |
| sellAccountNo | 支付账户号 | String | 支付账户号 |
| buyAccountNo | 结算账户号 | String | 结算账户号 |

### 34.4.1 返回示例（data，相应信息）

```html
{
	"code": 200,
	"msg": "成功",
	"data": {
		"rows": [
			{
				"orderNo": "2023022014150351",
				"outTradeNo": "1234512345",
				"subMerchantNo": "8xxxx8",
				"buyCurrency": "USD",
				"buyAmount": 100,
				"sellCurrency": "HKD",
				"sellAmount": 787,
				"rate": 0.127117,
				"rateDirect": "1 HKD = 0.127117 USD",
				"poundage": 0,
				"poundageCurrency": "HKD",
				"createTime": "2023-02-20 14:15:43",
				"modifyTime": "2023-02-20 14:15:43",
				"orderStatus": 0,
				"sellAccountNo": "10102134480000138",
				"buyAccountNo": "10102184080000138"
			},
			{
				"orderNo": "2023022014130601",
				"outTradeNo": "1234512345",
				"subMerchantNo": "8xxxxxx8",
				"buyCurrency": "USD",
				"buyAmount": 100,
				"sellCurrency": "HKD",
				"sellAmount": 787,
				"rate": 0.127117,
				"rateDirect": "1 HKD = 0.127117 USD",
				"poundage": 0,
				"poundageCurrency": "HKD",
				"createTime": "2023-02-20 14:13:36",
				"modifyTime": "2023-02-20 14:13:36",
				"orderStatus": 0,
				"sellAccountNo": "10102134480000138",
				"buyAccountNo": "10102184080000138"
			}
		],
		"total": 2
	}
}
```

## 35.查询订单详情

### 35.1 功能描述

查询订单详情

### 35.2 接口地址

请求地址：/conversion/detail
请求方式：POST

### 35.3 请求参数

| 参数名称 | 参数中文名称 | 类型   | 参数说明 | 是否必填 |
| -------- | ------------ | ------ | -------- | -------- |
| orderNo  | 订单号       | String | 订单号   | M        |

#### 35.3.1 请求示例

```html
{
	"orderNo": "2023022014150351"
}
```

### 35.4 返回参数

| 参数名称 | 参数中文名称 | 类型 | 参数说明 |
| ---------------- | -------------- | ---------- | ------------------------------------------------------------ |
| orderNo | 订单号 | String | 订单号 |
| outTradeNo | 商户自定义单号 | String | 商户自定义单号 |
| subMerchantNo | 子商户号 | String | 子商户号 |
| buyCurrency | 买入币种 | String | 3位币种代码如港币：HKD |
| buyAmount | 买入金额 | BigDecimal | 买入金额 |
| sellCurrency | 汇出币种 | String | 3位币种代码如港币：HKD |
| selldAmount | 汇出金额 | BigDecimal | 汇出金额 |
| rate | 汇率 | BigDecimal | 汇率 |
| rateDirect | 汇率方向 | String | 汇率方向 |
| poundage | 手续费 | BigDecimal | 手续费 |
| poundageCurrency | 手续费币种 | String | 手续费币种 |
| createTime | 创建时间 | Date | 创建时间 |
| modifyTime | 更新时间 | Date | 更新时间 |
| orderStatus | 订单状态 | Integer | 订单状态 0:兑换中 2:交割中 3:已完成 4:已拒绝 |
| sellAccountNo | 支付账户号 | String | 支付账户号 |
| buyAccountNo | 结算账户号 | String | 结算账户号 |

#### 35.4.1 返回示例（data，相应信息）

```html
{
	"code": 200,
	"msg": "成功",
	"data": {
		"orderNo": "2023022014150351",
		"outTradeNo": "1234512345",
		"subMerchantNo": "80000138",
		"buyCurrency": "USD",
		"buyAmount": 100,
		"sellCurrency": "HKD",
		"sellAmount": 787,
		"rate": 0.127117,
		"rateDirect": "1 HKD = 0.127117 USD",
		"poundage": 0,
		"poundageCurrency": "HKD",
		"createTime": "2023-02-20 14:15:43",
		"modifyTime": "2023-02-20 14:15:43",
		"orderStatus": 0,
		"sellAccountNo": "10102134480000138",
		"buyAccountNo": "10102184080000138"
	}
}
```

### 35.5订单的审核成功、失败异步返回列表

注意：此表格的参数为NotifyUrl的服务器返回参数

| 参数名称 | 参数中文名称 | 类型 | 参数说明 |
| ---------------- | -------------- | ---------- | ------------------------------------------------------------ |
| orderNo | 订单号 | String | 订单号 |
| outTradeNo | 商户自定义单号 | String | 商户自定义单号 |
| subMerchantNo | 子商户号 | String | 子商户号 |
| buyCurrency | 买入币种 | String | 3位币种代码如港币：HKD |
| buyAmount | 买入金额 | BigDecimal | 买入金额 |
| sellCurrency | 汇出币种 | String | 3位币种代码如港币：HKD |
| selldAmount | 汇出金额 | BigDecimal | 汇出金额 |
| rate | 汇率 | BigDecimal | 汇率 |
| rateDirect | 汇率方向 | String | 汇率方向 |
| poundage | 手续费 | BigDecimal | 手续费 |
| poundageCurrency | 手续费币种 | String | 手续费币种 |
| createTime | 创建时间 | Date | 创建时间 |
| modifyTime | 更新时间 | Date | 更新时间 |
| orderStatus | 订单状态 | Integer | 订单状态 0:兑换中 2:交割中 3:已完成 4:已拒绝 |
| sellAccountNo | 支付账户号 | String | 支付账户号 |
| buyAccountNo | 结算账户号 | String | 结算账户号 |
| notifyUrl | 通知地址 | String | 通知地址 |
| msgType | 通知状态 | String | 通知状态 例：CONVERSION |

#### 35.5.1 返回示例（data，相应信息）

```html
 {
 		"notifyUrl":"http://fsdifnsdifisf",
		"msgType":"CONVERSION",
		"orderNo": "2023022014150351",
		"outTradeNo": "1234512345",
		"subMerchantNo": "80000138",
		"buyCurrency": "USD",
		"buyAmount": 100,
		"sellCurrency": "HKD",
		"sellAmount": 787,
		"rate": 0.127117,
		"rateDirect": "1 HKD = 0.127117 USD",
		"poundage": 0,
		"poundageCurrency": "HKD",
		"createTime": "2023-02-20 14:15:43",
		"modifyTime": "2023-02-20 14:15:43",
		"orderStatus": 0,
		"sellAccountNo": "10102134480000138",
		"buyAccountNo": "10102184080000138"
}
```

## 36.补充材料重启工单

### 36.1功能描述

补充材料重启工单

### 36.2接口地址

请求地址：`/common/resubmit`

### 36.3请求参数列表

| 参数名称 | 参数中文名称 | 类型& 长度 | 参数说明 | 是否必填 |
| ------------- | ------------------- | ---------- | --------------------------- | -------- |
| orderType | 订单类型 | String | 订单类型 汇款：TRANSFER | M |
| orderNo | 订单号 | String | 订单号 | M |
| contractFiles | 交易凭证 - 交易合同 | Array | 文件不能全部为空 | O |
| invoiceFiles | 交易凭证 - 交易发票 | Array | 文件不能全部为空 | O |
| othersFiles | 交易凭证 - 其他资料 | Array | 文件不能全部为空 | O |

### 36.4示例

```json
{
	"orderType": "TRANSFER",
	"orderNo": "2023022116408111",
	"contractFiles": [
		{
			"fileName": "交易合同文件名称",
			"filePath": "https://t-bj-private-dev.oss-cn-qingdao.aliyuncs.com/admin/2023/FEBRUARY/21/16769623245521597.docx"
		}
	],
	"invoiceFiles": [
		{
			"fileName": "交易发票文件名称",
			"filePath": "https://t-bj-private-dev.oss-cn-qingdao.aliyuncs.com/admin/2023/FEBRUARY/21/16769623245521597.docx"
		}
	]
}
```

### 36.5请求同步返回

| 参数名称 | 参数中文名称 | 参数说明             |
| -------- | ------------ | -------------------- |
| code     | 状态码       | 请求状态码，详见附录 |
| msg      | 状态描述     | 状态描述             |

#### 36.5.1响应参数

```json
{
	"code": 200,
	"msg": "成功",
	"data": null
}
```

## 37.查询国家、省、市、区

### 37.1 功能描述

查询国家、省、市、区

### 37.2 接口地址

请求地址：/common/queryCountriesOrStatesOrCities
请求方式：POST

### 37.3请求参数

| 参数名称      | 参数中文名称 | 类型/长度    | 参数说明 | 是否必填 |
| ------------- | ------------ | ------------ | -------- | -------- |
| countriesCode | 国家         | String（10） | 国家     | O        |
| stateCode     | 省        | String（10） | 省/州    | O        |

注：
	当两字段都唯空时，查询得出的国家相关信息
	当查询城市时，两字段都为必填
	字段填写为返回信息中的alpha2字段

### 37.4 返回参数

| 参数名称 | 参数中文名称 | 类型   | 参数说明         |
| -------- | ------------ | ------ | ---------------- |
| code     | 编码         | String | 接口返回编码     |
| msg      | 返回信息     | String | 接口返回信息     |
| data     | 详细信息     | Object | 接口返回详细信息 |

data：

| 参数名称 | 参数中文名称      | 类型   | 参数说明          |
| -------- | ----------------- | ------ | ----------------- |
| alpha2   | 国家              | String | 国家二位编码      |
| alpha3   | 国家              | String | 国家三位编码      |
| label    | 国家（中文+英文） | String | 国家（中文+英文） |
| region   | 所属洲            | String | 所属洲            |

#### 37.4.1 示例

```html
{
    "code": 200,
    "msg": "成功",
    "data": [
       {
            "alpha2": "CN",
            "alpha3": "CHN",
            "label": "中国 China",
            "region": "Asia",
            "num": "156"
        }
    ]
}
```

## 38.上传文件

### 38.1 功能描述

上传文件到TransferEasy后台

### 38.2 接口地址

请求地址：/common/upload
请求方式：POST
请求主体类型:multipart/form-data

### 38.3请求参数

| 参数名称      | 参数中文名称 | 类型/长度    | 参数说明 | 是否必填 |
| ------------- | ------------ | ------------ | -------- | -------- |
| file | 图片文件         | message | 文件格式限制为jpg、jpeg、pdf、xlsx、xls、png,文件大小不能超过10M     | M        |

### 38.4 返回参数

| 参数名称 | 参数中文名称 | 类型   | 参数说明         |
| -------- | ------------ | ------ | ---------------- |
| code     | 编码         | String | 接口返回编码     |
| msg      | 返回信息     | String | 接口返回信息     |
| data     | 详细信息     | Object | 接口返回详细信息 |

data：

| 参数名称 | 参数中文名称      | 类型   | 参数说明          |
| -------- | ----------------- | ------ | ----------------- |
| fileName   | 文件名称              | String | 文件名称      |
| url   | 地址              | String | 上传文件地址      |

#### 38.4.1 示例

```html
{
    "code": 200,
    "msg": "成功",
    "data": {
        "fileName": "xxx.jpg",
        "url": "https://xxxx"
    }
}
```
### 错误码

| 状态码 | 错误信息 | 描述 |
| --- | --- | --- |
| 10000 | System error | 系统错误 |
| 10001 | Parameter error | 参数错误 |
| 10006 | Missing parameter | 参数缺失 |
| 10007 | Signature verification failure | 签名验证失败 |
| 10008 | The system is busy please try again later | 系统繁忙 |
| 10008 | SubMerchantNo no operation permission | 无此子商户操作权限 |
| 10009 | SubMerchantNo no operation permission | 无此子商户操作权限 |
| 10010 | SubMerchantNo no permission for this product | 子商户无此产品权限 |
| 10011 | Not yet upload secret | 未上传公钥 |
| 10012 | Not yet upload notify_url | 未设置通知地址 |
| 10013 | Call the api without permission | 不允许调用api |
| 20110 | This account is in the process of application, and cannot be operated |  VA账户-该账户处于申请中，无法进行修改，无法进行查看详情 |
| 20111 | The account has been rejected. This operation cannot be performed | VA账户-该账户已被拒绝，无法进行修改，无法进行查看详情 |
| 20112 | The account is in an abnormal state and cannot be downloaded | VA账户-下载-该账户处于非正常状态，无法进行下载 |
| 20113 | The request number already exists | VA账户-请求单号已存在 |
| 20114 | Application account name must be in English | VA账户-预申请账户必须为英文 |
| 20120 | Account name error | 申请VA时账户名称错误 |
| 20121 | mainMerchantNo error | 查无此账户,主账户号填写错误，agents中查不到相关代理商 |
| 20115 | The bank's country/region is not China, and the account currency does not support CNY | 银行所在国家/地区非中国地区，账户币种不支持CNY |
| 20116 | Mailbox error | 邮箱错误 |
| 20117 | Password format error | 密码格式错误 |
| 20118 | Verification code error | 验证码错误 |
| 20119 | The mailbox has been registered. Please fill in the new mailbox again | 邮箱重复，重新填写新邮箱 |
| 20122 | In approval, modification is not allowed | 进件审核中，不允许被修改 |
| 20123 | Approved successfully, cannot be modified | 商户进件成功，不允许被修改 |
| 20124 | The mailbox is duplicate, please contact the administrator | 库中有多条相同邮箱数据，需管理员查看详细细节 |
| 20125 | Duplicate mailbox or request number | 邮箱或请求单号重复 |
| 20126 | The mailbox or requisition number cannot both be empty | 邮箱和请求单号都为空 |
| 20040 | The remittance business in different currencies is not supported at the moment | 暂不支持异币种汇款业务 |
| 20041 | Account unavailable | 账户不可用 |
| 20042 | Abnormal handling fee configuration | 手续费配置异常 |
| 20043 | Insufficient account balance | 账户余额不足 |
| 20044 | Not working hours | 不在作业时间 |
| 20045 | The amount is less than the minimum transaction amount | 金额不足最小交易金额 |
| 20046 | Transaction timeout | 交易超时 |
| 20047 | No such merchant information | 商户信息不存在 |
| 20048 | Such merchant has no secret | 商户秘钥不存在 |
| 20050 | Order does not exist | 订单不存在 |
| 20051 | Orders was canceled | 订单已取消 |
| 20052 | Order cannot be cancelled | 订单不可取消 |
| 20053 | Order cancel failed | 取消失败 |
| 20220 | Receipt order does not exist | 收款单不存在 |
| 20221 | Current status cannot add data | 当前状态不能补充资料 |
| 20222 | OutdrawerNo cannot be null | 收款付款人不能为空 |