商户入网查询接口（商户→汇元通）

功能描述

若已接通商户入网接口，商户可调用此接口查询子商户入网信息。

接口地址

https://api.geoswift.com/va/declaration/query

参数名称 参数中文名称 类型& 长度 参数说明 是否必填
merchantId 商户编号 varchar(9) 商户在汇元通系统的唯一身份标识 M
subMerchantId 子商户编号 varchar(9) 若操作类型type为MODIFY时，此值必传 O
requestId 商户订单号 varchar(50) 商户自行拟定，提交的订单号必须在自身账户交易中唯一
若操作类型type为MODIFY时，此参数值与创建时的商户订单号一致		 M
hmac 参数签名 varchar(512) 商户生成的参数签名结果，获取hmac的方法请参考《Geoswift加解密流程规范》 M

示例

{ "merchantId": "G70000414", "requestId": "1725270382149" }

请求返回参数列表

参数名称 参数中文名称 参数说明
merchantId 商户编号 同请求参数
requestId 订单号 同请求参数
subMerchantId 子商户编号 子商户编号
declareStatus 商户状态 ACTIVATE：活动中
CLOSE：关闭
INIT：待激活
NOTACTIVATE：已冻结
REPAYING：清退
company 企业信息 见下表：企业信息
business 经营信息 见下表：经营信息
beneficialList 受益人信息 见下表：受益人信息
legalList 法人信息 见下表：法人信息
authorizedList 授权人信息 见下表：授权人信息
hmac 参数签名 汇元通生成的参数签名结果，验签过程请参考《Geoswift加解密流程规范》

返回参数（company，企业信息）

参数名称 参数中文名称 参数说明
country 成立所在州或所在国 成立所在州或所在国
signedName 公司注册名称 公司注册名称
shortName 公司简称 公司简称
usedName 公司曾用名 公司曾用名
brandName 品牌名称 品牌名称
registerAddress 公司注册地址 公司注册地址
businessAddress 公司经营地址 公司经营地址
addressType 通讯地址 通讯地址
phone 公司联系电话 公司联系电话
br 商业执照号(BR) 商业执照号(BR)
brStartDate 商业执照起始日 商业执照起始日
brEndDate 商业执照终止日期 商业执照终止日期
ci 公司注册号(CI) 公司注册号(CI)
licenseNumber 营业执照号 营业执照号
licenseNumberStartDate 营业执照起始日期 营业执照起始日期
licenseNumberEndDate 营业执照终止日期 营业执照终止日期
registerNumber 公司注册证书编号 公司注册证书编号
establishDate 成立日期 成立日期
legalPersonName 法定代表人姓名 法定代表人姓名
companyType 公司类型 公司类型
companyTypeDesc 公司类型描述 公司类型描述
webSite 公司网址 公司网址
email 公司联系邮箱 公司联系邮箱

返回参数（company，企业信息）

参数名称 参数中文名称 参数说明
businessNature 公司业务性质 公司业务性质
productType 提供产品和服务 提供产品和服务
提供产品和服务 交易模式 交易模式
businessModeDesc 业务模式描述 业务模式描述
cashSourceCountry 资金来源辖区 资金来源辖区
cashSource 资金来源 资金来源
cashSourceDesc 资金来源描述 资金来源描述
enterCurrency 汇入资金币种 汇入资金币种
outCurrency 汇出资金币种 汇出资金币种
enterForUse 汇款资金用途 汇款资金用途
enterForUseDesc 汇款资金用途描述 汇款资金用途描述
lastYearSaleAmount 过去一年的销售额 过去一年的销售额
expectNumberPerMonth 预估每月交易笔数 预估每月交易笔数
expectAmountPerMonth 预估每月交易金额(美金) 预估每月交易金额(美金)
companyAssets 公司资产 公司资产
branchCountry 客户分支机构所在国 客户分支机构所在国
beneficialCountry 受益方辖区 受益方辖区
supplyCountry 主要供应商所在国 主要供应商所在国
buyCountry 主要购买商所在国 主要购买商所在国

返回参数（beneficialList，受益人信息）

参数名称 参数中文名称 参数说明
name 姓名 姓名
idType 证件类型 证件类型
idNo 证件号 证件号
address 居住地址 居住地址
stockPercent 股权占比 占股比例，如占股30.87%，则返回30.87

返回参数（legalList，法人信息）

参数名称 参数中文名称 参数说明
name 姓名 姓名
idType 证件类型 证件类型
idNo 证件号 证件号
address 居住地址 居住地址

返回参数（authorizedList，授权人信息）

参数名称 参数中文名称 参数说明
name 姓名 姓名
idType 证件类型 证件类型
idNo 证件号 证件号
address 居住地址 居住地址

示例

{ "authorizedList": [ { "address": "授权人-居住地址test 001*01", "idNo": "TES***890a", "idType": "FOREIGN_NATIONAL_ID", "name": "Shouquan renName" } ], "beneficialList": [ { "address": "持股人-居住地址test 001*01", "idNo": "132***287X", "idType": "IDENTITY_CARD", "name": "Chigu ren name", "stockPercent": "66.66" } ], "business": { "beneficialCountry": "HKG", "branchCountry": "HKG", "businessModeDesc": "业务模式描述TEST 123**_详细描述业务模式,汇入及汇出币种，附上资金流动图说明资金来源及去向", "businessNature": "公司业务性质TEST 123**卖衣服,电商買卖平台，电脑编程/旅游中介", "buyCountry": "HKG", "cashSource": "GOODS_PAYMENT,SERVICE_RENDERED,COMMISSION,OTHER", "cashSourceCountry": "HKG", "cashSourceDesc": "cashSource abcdef", "companyAssets": 12345678, "enterCurrency": "HKD", "enterForUse": "SETTLEMENT,DAILY_OPERATION,OTHERS", "enterForUseDesc": "汇款资金用途描述", "expectAmountPerMonth": 12345678, "expectNumberPerMonth": 12345678, "lastYearSaleAmount": 12345678, "outCurrency": "HKD", "productType": "COMMUNICATION_SERVICE", "supplyCountry": "HKG", "tradeMode": "P2P,B2B,B2C,C2B" }, "company": { "addressType": "BUSINESS", "br": "SYZZH123", "brEndDate": 1923235200000, "brStartDate": 1289404800000, "brandName": "Maisons 品牌名称", "businessAddress": "jy******Chavannes", "ci": "GSZCH12", "companyType": "STATE_OWNED", "companyTypeDesc": "", "country": "HKG", "email": "1725270382149@163.com", "establishDate": -1587801600000, "legalPersonName": "Fa Ren daibiao name", "licenseNumber": "", "phone": "152****4190", "registerAddress": "jy******Chavannes", "registerNumber": "", "shortName": "VA test jiancheng-001", "signedName": "VA test-0001", "usedName": "", "webSite": "https://www.geoswift.com/" }, "country": "HKG", "declareStatus": "CANCEL", "id": "2c9696b691b14d640191b222651b0001", "legalList": [ { "address": "董事-居住地址test 001*01", "idNo": "HKG***1234", "idType": "HK_IDENTITY_CARD", "name": "Dongshi name" } ], "merchantId": "G70000420", "notifyUrl": "https://qa-sdk-v2.geoswift.com/va/declaration/notify", "partnerId": "G70000414", "registrationType": "API", "requestId": "1725270382149", "signedName": "VA test-0001" }