若您需要为子商户开立收款账户，需要先为子商户入网，可调用此接口进行子商户入网及信息修改。
| 文件上传注意事项 | sftp固定目录 | /va |
| sftp文件上传地址 | /va/子目录/1.jpg(可以不使用子目录) | |
| 实际接口上传地址 | 子目录/1.jpg |
https://api.geoswift.com/va/declaration/createOrUpdate
| 参数名称 | 参数中文名称 | 类型& 长度 | 参数说明 | 是否必填 |
|---|---|---|---|---|
| merchantId | 商户编号 | varchar(9) | 商户在汇元通系统的唯一身份标识 | M |
| requestId | 订单号 | varchar(50) | 商户自行拟定，提交的订单号必须在自身账户交易中唯一 若操作类型type为MODIFY时，此参数值与创建时的商户订单号一致 |
M |
| notifyUrl | 通知地址 | varchar(100) | 当入网状态为终态后汇元通服务器会向该地址发送通知，POST方式 | M |
| type | 操作类型 | Json | CREATE 创建 MODIFY 更新 |
M |
| company | 企业信息 | Json | 见下表：企业信息 | M |
| business | 经营信息 | Json | 见下表：经营信息 | M |
| beneficialList | 受益人信息 | Json | 所有大于或等于25%股权或股份的个人 见下表：受益人信息 |
M |
| legalList | 法人信息 | Json | 董事或和法人 见下表：法人信息 |
M |
| authorizedList | 授权人信息 | Json | 授权人信息 见下表：授权人信息 |
M |
| certificate | 资质文件 | Json | 见下表：经营业务信息 | M |
| agreeCooperationAgreement | 合作协议 | 固定值 | 创建子商户则默认同意以上声明，同意则传"Y" | O |
| hmac | 参数签名 | varchar(512) | 商户生成的参数签名结果，获取hmac的方法请参考《Geoswift加解密流程规范》 | M |
| 参数名称 | 参数中文名称 | 类型& 长度 | 参数说明 | 是否必填 |
|---|---|---|---|---|
| country | 成立所在州或所在国 | 枚举值 | 三位ISO国家代码，不可更改 若操作类型type为CREATE时必传 若操作类型type为MODIFY时无需上传 参见国家代码表 |
C |
| signedName | 公司注册名称 | varchar(80) | 英文格式公司名称，不可更改 若操作类型type为CREATE时必传 若操作类型type为MODIFY时无需上传 允许输入字符： A-Z、a-z、0-9、“()”、“.”、“,”、“-”及空格 ，其中必须含有至少一个空格 |
C |
| usedName | 公司曾用名 | varchar(80) | 允许输入字符： A-Z、a-z、0-9、“()”、“.”、“,”、“-”及空格 |
O |
| shortName | 公司简称 | varchar(64) | 若操作类型type为CREATE时必传 若操作类型type为MODIFY时无需上传 允许输入字符： A-Z、a-z、0-9、“()”、“.”、“,”、“-”及空格 |
C |
| brandName | 品牌名称 | varchar(80) | 允许输入字符： A-Z、a-z、0-9、“()”、“.”、“,”、“-”及空格 |
O |
| registerAddress | 公司注册地址 | varchar(200) | 允许输入字符： A-Z、a-z、0-9、“()”、“.”、“,”、“-”及空格 |
M |
| businessAddress | 公司经营地址 | varchar(180) | 允许输入字符： A-Z、a-z、0-9、“()”、“.”、“,”、“-”及空格 |
M |
| addressType | 通讯地址类型 | 枚举值 | 公司通讯地址 0：表示公司注册地址 1：表示公司经营地址 |
M |
| phone | 公司联系电话 | varchar(20) | 公司联系电话 | M |
| br | 商业执照号(BR) | varchar(8) | 数字和英文字母 成立所在国为HKG时必传 |
C |
| brStartDate | 商业执照起始日期 | varchar(8) | 格式：YYYYMMDD 成立所在国为HKG时必传 |
C |
| brEndDate | 商业执照终止日期 | varchar(8) | 格式：YYYYMMDD 成立所在国为HKG时必传 |
C |
| ci | 公司注册号(CI) | varchar(10) | 数字和英文字母 成立所在国为HKG时必传 |
C |
| licenseNumber | 营业执照号 | varchar(18) | 数字和英文字 成立所在国为CHN时必传 |
C |
| licenseNumberStartDate | 营业执照起始日期 | varchar(8) | 格式：YYYYMMDD 成立所在国为CHN,时必传 |
C |
| licenseNumberEndDate | 营业执照终止日期 | varchar(8) | 格式：YYYYMMDD 成立所在国为CHN时必传 |
C |
| registerNumber | 公司注册证书编号 | varchar(15) | 数字和英文字母 成立所在国非CHN\HKG时必传 |
C |
| establishDate | 成立日期 | varchar(8) | 格式：YYYYMMDD 企业成立日期 |
M |
| legalPersonName | 法定代表人姓名 | varchar(100) | 英文格式的姓名 例如中文名为李凯，此处上传Li Kai |
M |
| companyType | 公司类型 | 枚举值 | 公司类型 1：私人有限责任公司 2：上市公司 3：上市公司的子公司 4：国有企业 5：一人无限责任公司 6：合伙企业(无限责任) 7：Corperation(US only) 8：其他 |
M | companyTypeDesc | 公司类型描述 | varchar(100) | 公司类型为其他时，此项需上传 | C | webSite | 公司网址 | varchar(100) | 公司网址 | M | 公司联系邮箱 | varchar(50) | 公司联系邮箱 | M |
| 参数名称 | 参数中文名称 | 类型& 长度 | 参数说明 | 是否必填 |
|---|---|---|---|---|
| businessNature | 公司业务性质 | varchar(500) | 详细描述提供产品和服务 例如: 卖衣服， 电商買卖平台，电脑编程， 旅游中介.... |
M |
| productType | 提供产品和服务 | 枚举值 | 支持的类型如下： E-commerce：电商； Tuition：学费； Accommodation：住宿； Travel：旅游； Communication service：通讯服务； Software service：软件服务； Trade in goods：货物贸易 Other：其他 可多选，以英文逗号分隔 例如：E-commerce，Communication service |
M |
| tradeMode | 交易模式 | 枚举值 | P2P、B2B、B2C、C2B，可多选，以英文逗号分隔,如P2P,B2B | M |
| businessModeDesc | 业务模式描述 | varchar(1000) | 详细描述业务模式，汇入及汇出币种，附上资金流动图说明资金来源及去向 | M |
| cashFlowPathList | 资金流动流程图（业务描述附件） | varchar(200) | 详细描述业务模式，或附上资金流动图说明资金来源及去向 最多3个文件，文件大小不超过10M 文件格式：PNG\JPG\JPEG\PDF\ZIP |
M |
| cashSourceCountry | 资金来源辖区 | varchar(100) | 传国家代码，上传多个请以英文逗号分隔，如GBR,SGP,HKG,CHN | M |
| cashSource | 资金来源 | varchar(100) | 货款:Goods Payment; 提供服务:Service Rendered; 佣金:Commission;其他:Others 多种业务的话可多选，以英文逗号分隔 如：Goods Payment,Others |
M |
| cashSourceDesc | 资金来源描述 | varchar(500) | 当业务模式含Others时，此项必填 | M |
| enterCurrency | 汇入资金币种 | varchar(100) | 币种编码，多个请以英文逗号分隔，如USD,SGD,HKD,CNH 支持币种参见附录：币种编码表 |
M |
| enterForUse | 汇款资金用途 | varchar(100) | Settlement：结算款； Daily Operation：日常运营； Others：其他 可多选，若多个请以英文逗号分隔 如:Settlement,Daily Operation,Others |
M |
| enterForUseDesc | 汇款资金用途描述 | varchar(100) | 汇款资金用途包含其他时此项必传 | M |
| outCurrency | 汇出资金币种 | varchar(100) | 币种编码，若多个请以英文逗号分隔，如USD,SGD,HKD,CNH 支持币种参见附录：币种编码表 |
M |
| lastYearSaleAmount | 过去一年的销售额 | 数值 | 以分为单位，整数金额，最后两位必须为00 | M |
| expectNumberPerMonth | 预估每月交易笔数 | 数值 | M | |
| expectAmountPerMonth | 预估每月交易金额(美金) | 数值 | 以分为单位，整数金额，最后两位必须为00 | M |
| companyAssets | 公司资产 | 数值 | 以分为单位，整数金额，最后两位必须为00 商户上传企业资产数额（total liability + total equities ） |
M |
| branchCountry | 客户分支机构所在国 | varchar(100) | 三位ISO国家代码，多个请以英文逗号分隔，如GBR,SGP,HKG,CHN 参见国家代码表 |
M |
| beneficialCountry | 受益方辖区 | varchar(100) | 三位ISO国家代码，多个请以英文逗号分隔，如GBR,SGP,HKG,CHN 参见国家代码表 |
M |
| supplyCountry | 主要供应商所在国 | varchar(100) | 三位ISO国家代码，多个请以英文逗号分隔，如GBR,SGP,HKG,CHN 参见国家代码表 |
M |
| buyCountry | 主要购买商所在国 | varchar(100) | 三位ISO国家代码，多个请以英文逗号分隔，如GBR,SGP,HKG,CHN 参见国家代码表 |
M |
| 参数名称 | 参数中文名称 | 类型& 长度 | 参数说明 | 是否必填 |
|---|---|---|---|---|
| name | 姓名 | varchar(100) | 英文姓名 | M |
| idType | 证件类型 | 枚举值 | HK IDENTITY CARD :香港居民身份证 PASSPORT NO :护照号 FOREIGN NATIONAL ID :外国居民身份证 IDENTITY CARD:大陆居民身份证 OTHER:其他 |
M |
| idNo | 证件号 | varchar(30) | 不同证件类型数据长度要求不同 HK IDENTITY CARD:7位 PASSPORT NO ：9位 IDENTITY CARD：18位 FOREIGN NATIONAL ID /OTHER: <=30位 |
M |
| address | 居住地址 | varchar(180) | 居住地址 | M |
| stockPercent | 股权占比（%） | varchar(3) | 占股比例，支持100以内的数值且支持2位小数输入，如占股30.87%，则上传30.87即可 | M |
| addressProofList | 居住地址证明材料 | varchar(200) | 上传SFTP文件地址 可提供资料：租赁合同、3个月内的水电费帐单、三个月的公司银行流水、12个月以内的税单 最多3个文件，文件大小不超过10M 文件格式：PNG\JPG\JPEG\PDF\ZIP |
M |
| picList | 证件照 | varchar(200) | 上传SFTP文件地址 包括正反面的证件照片及已经经律师认证过的证件信息 最多3个文件，文件大小不超过10M 文件格式：PNG\JPG\JPEG\PDF\ZIP |
M |
| 参数名称 | 参数中文名称 | 类型& 长度 | 参数说明 | 是否必填 |
|---|---|---|---|---|
| name | 姓名 | varchar(100) | 英文姓名 | M |
| idType | 证件类型 | 枚举值 | HK IDENTITY CARD :香港居民身份证 PASSPORT NO :护照号 FOREIGN NATIONAL ID :外国居民身份证 IDENTITY CARD:大陆居民身份证 OTHER:其他 |
M |
| idNo | 证件号 | varchar(30) | 不同证件类型数据长度要求不同 HK IDENTITY CARD:7位 PASSPORT NO ：9位 IDENTITY CARD：18位 FOREIGN NATIONAL ID /OTHER: <=30位 |
M |
| address | 居住地址 | varchar(180) | 居住地址 | M |
| addressProofList | 居住地址证明材料 | varchar(200) | 上传SFTP文件地址 可提供资料：租赁合同、3个月内的水电费帐单、三个月的公司银行流水、12个月以内的税单 |
M |
| picList | 证件照 | varchar(200) | 上传SFTP文件地址 包括正反面的证件照片及已经经律师认证过的证件信息 最多3个文件，文件大小不超过10M 文件格式：PNG\JPG\JPEG\PDF\ZIP |
M |
| 参数名称 | 参数中文名称 | 类型& 长度 | 参数说明 | 是否必填 |
|---|---|---|---|---|
| name | 姓名 | varchar(100) | 英文姓名 | M |
| idType | 证件类型 | 枚举值 | HK IDENTITY CARD :香港居民身份证 PASSPORT NO :护照号 FOREIGN NATIONAL ID :外国居民身份证 IDENTITY CARD:大陆居民身份证 OTHER:其他 |
M |
| idNo | 证件号 | varchar(30) | 不同证件类型数据长度要求不同 HK IDENTITY CARD:7位 PASSPORT NO ：9位 IDENTITY CARD：18位 FOREIGN NATIONAL ID /OTHER: <=30位 |
M |
| address | 居住地址 | varchar(180) | 居住地址 | M |
| addressProofList | 居住地址证明材料 | varchar(200) | 上传SFTP文件地址 可提供资料：租赁合同、3个月内的水电费帐单、三个月的公司银行流水、12个月以内的税单 |
M |
| picList | 证件照 | varchar(200) | 上传SFTP文件地址 包括正反面的证件照片及已经经律师认证过的证件信息 最多3个文件，文件大小不超过10M 文件格式：PNG\JPG\JPEG\PDF\ZIP |
M |
| 参数名称 | 参数中文名称 | 类型& 长度 | 参数说明 | 是否必填 |
|---|---|---|---|---|
| registrationCertificatePath | 公司注册证书 | varchar(200) | 非中国企业，此项需上传公司注册证书复印件 中国企业，此项上传营业执照或副本复印件 最多1个文件，文件大小不超过10M 文件格式：PNG\JPG\JPEG\PDF\ZIP |
M |
| businessRegistrationPath | 商业登记证 | varchar(200) | 香港企业此项必传 最多1个文件，文件大小不超过10M 文件格式：PNG\JPG\JPEG\PDF\ZIP |
C |
| annualDeclarationList | 周年申报表 | varchar(200) | 香港企业此项必传 最多5个文件，文件大小不超过10M 文件格式：PNG\JPG\JPEG\PDF\ZIP |
C |
| addressProofList | 办公场地证明文件 | varchar(200) | 办公场地照片（室内1张，室外门头照1张）及租赁合同、3个月内的水电费帐单、三个月的公司银行流水、12个月以内的税单 最多5个文件，文件大小不超过10M 文件格式：PNG\JPG\JPEG\PDF\ZIP |
M |
| stockProofList | 公司股权证明文件 | varchar(200) | 最多5个文件，文件大小不超过10M 文件格式：PNG\JPG\JPEG\PDF\ZIP |
O |
| otherList | 其他资料 | varchar(200) | 最多5个文件，文件大小不超过10M 文件格式：PNG\JPG\JPEG\PDF\ZIP |
O |
| 参数名称 | 参数中文名称 | 参数说明 |
|---|---|---|
| merchantId | 商户编号 | 同请求参数 |
| requestId | 订单号 | 同请求参数 |
| subMerchantId | 子商户编号 | 子商户编号 |
| status | 请求状态 | SUCCESS：成功 ERROR：错误 |
| errorCode | 错误码 | 错误码，订单取消、失败时返回 |
| errorMessage | 错误描述 | 错误描述，订单取消、失败时返回 |
| hmac | 参数签名 | 汇元通生成的参数签名结果，验签过程请参考《Geoswift加解密流程规范》 |
入网请求发生任何审核动作，都会通过此接口通知给商户，只有子商户状态审核通过，子商户入网信息才会生效。
| 参数名称 | 参数中文名称 | 参数说明 |
|---|---|---|
| merchantId | 商户编号 | 同请求参数 |
| requestId | 订单号 | 同请求参数 |
| subMerchantId | 子商户编号 | 子商户编号 |
| type | 操作类型 | CREATE 创建 MODIFY 修改 |
| reviewStatus | 子商户审核状态 | INIT：待审核 SUCCESS：审核通过 REFUSE：拒绝 RETURN：退回 |
| reviewRemarks | 子商户审核意见 | 审核意见 |
| hmac | 参数签名 | 汇元通生成的参数签名结果，验签过程请参考《Geoswift加解密流程规范》 |