申报主体

创建申报主体

端点目标 URL

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

生产环境请求地址：POST https://api.futurepay.global/api/v1/settleReport/create

字段说明

调用的特定输入参数

字段名称	必填	类型	描述
`merchantReference`	M	string	商户请求流水号，不能重复
`repType`	M	string	申报类型 1-企业 2-个人
`certType`	M	string	申报主体证件类型 1-身份证 2-营业执照
`repName`	M	string	申报主体名称
`certNumber`	M	string	申报主体证件号
`repCountry`	M	string	申报主体所在国家的国际标准化组织（ISO）国家代码（如US代表美国，CN代表中国 ISO 3166-1 标准）
`repState`	M	string	申报主体所在省
`repCity`	M	string	申报主体所在市
`repAddressDetail`	M	string	申报主体详细地址
`administrativeRegionCode`	M	string	单位所在行政编码
`postCode`	M	string	单位邮编
`certImageFontUrl`	O	string	身份证正面图片上传url，repType = 1时必填
`certImageBackUrl`	O	string	身份证背面图片上传url，repType = 1时必填
`businessLicenseImgUrl`	O	string	营业执照图片上传url, repType = 2时必填
`accType`	M	string	账户类型 1-企业 2-个人
`cardNo`	M	string	银行账号
`bankName`	M	string	银行名称
`interbankNumber`	M	string	联行号
`phoneNumber`	M	string	手机号码
`bankState`	M	string	银行所在省
`bankCity`	M	string	银行所在市
`branchBank`	M	string	支行名称
`legalPerson`	M	string	法人代表名称
`legalCertNumber`	M	string	法人代表证件号

响应data参数

字段名	类型	说明
`merchantReference`	String	商户请求流水号
`status`	String	状态 0-待审核 1-审核通过 2-审核拒绝

集成

创建申报主体调用输入


{
	"merchantReference": "1234567",
  "repType": "2",
  "certType": "1",
  "businessLicenseImgUrl": "",
  "certImageFontUrl": "report/1867120593623756800/ee082b91727a4ddebfb99ab56f091c47.png",
  "certImageBackUrl": "report/1867120593623756800/ee082b91727a4ddebfb99ab56f091c47.png",
  "certNumber": "223131254131",
  "repName": "apiTest",
  "repCountry": "CN",
  "repState": "10",
  "repCity": "100",
  "repAddressDetail": "xx/xx/xx",
  "administrativeRegionCode": "111",
  "postCode": "111",
  "legalPerson": "张三",
  "legalCertNumber": "2313131",
  "accType": "2",
  "accName": "张三",
  "cardNo": "2313213132",
  "bankName": "中国银行股份有限公司北京通州运河商务区绿色支行",
  "interbankNumber": "104100001427",
  "phoneNumber": "1231453131",
  "bankState": "10",
  "bankCity": "100",
  "branchBank": "中国银行股份有限公司北京通州运河商务区绿色支行",
}

创建申报主体调用输出

{
    "code": "0",
    "msg": "succeeded",
    "serverTime": 1763113556851,
    "data": {
        "merchantReference": "1234567",
        "status":"0"
    },
    "success": true
}

修改申报主体

端点目标 URL

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

生产环境请求地址：POST https://api.futurepay.global/api/v1/settleReport/modify

字段说明

调用的特定输入参数

字段名称	必填	类型	描述
`merchantReference`	M	string	商户请求流水号，不能重复
`accType`	M	string	1-企业 2-个人
`accName`	M	string	账户名称
`cardNo`	M	string	银行账号
`bankName`	M	string	银行名称
`interbankNumber`	M	string	联行号
`phoneNumber`	M	string	手机号码

响应data参数

字段名	类型	说明
`merchantReference`	String	商户请求流水号
`status`	String	状态 0-待审核 1-审核通过 2-审核拒绝

集成

修改申报主体调用输入


{
	"merchantReference": "1234567",
  "accType": "2",
  "accName": "张三",
  "cardNo": "2313213132",
  "bankName": "中国银行股份有限公司北京通州运河商务区绿色支行",
  "interbankNumber": "104100001427",
  "phoneNumber": "1231453131",
  "bankState": "10",
  "bankCity": "100",
  "branchBank": "中国银行股份有限公司北京通州运河商务区绿色支行"
}

修改申报主体调用输出

{
    "code": "0",
    "msg": "succeeded",
    "serverTime": 1763113556851,
    "data": {
        "merchantReference": "1234567",
        "status":"0"
    },
    "success": true
}

申报主体详情查询

端点目标 URL

沙盒环境请求地址：POST https://preapi.futurepay-develop.com/api/v1/settleReport/query-detail

生产环境请求地址：POST https://api.futurepay.global/api/v1/settleReport/query-detail

字段说明

调用的特定输入参数

字段名称	必填	类型	描述
`merchantReference`	M	string	商户请求流水号，不能重复

响应data参数

字段名	类型	说明
`merchantReference`	string	商户请求流水号
`status`	string	状态 0-待审核 1-审核通过 2-审核拒绝
`repType`	string	注册类型 1-企业 2-个人
`certType`	string	证件类型 1-身份证 2-护照
`businessLicenseImgUrl`	string	营业执照上传url
`certImageFontUrl`	string	身份证正面上传url
`certImageBackUrl`	string	身份证背面上传url
`certNumber`	string	证件号
`repName`	string	申报主体名称
`repCountry`	string	申报主体所在国家
`repState`	string	申报主体所在省
`repCity`	string	申报主体所在市
`repAddressDetail`	string	申报主体详细地址
`postCode`	string	申报主体邮编
`administrativeRegionCode`	string	申报主体所在区域行政编码
`legalPerson`	string	法人名称
`legalCertNumber`	string	法人证件号
`accType`	string	账户类型 1-企业 2-个人
`accName`	string	账户名称
`cardNo`	string	银行卡号
`bankName`	string	银行名称
`interbankNumber`	string	联行号
`phoneNumber`	string	手机号
`bankState`	string	银行所在省
`bankCity`	string	银行所在市
`branchBank`	string	支行名称
`createTime`	string	创建时间
`updateTime`	string	修改时间
`balanceList`	Array	账户余额，详情见ReportBalance

ReportBalance

字段名称	类型	描述
`businessType`	string	业务类型
`balance`	BigDecimal	可结汇余额
`freezeBalance`	BigDecimal	可结汇冻结额度

集成

查询申报主体调用输入


{
	"merchantReference": "1234567"
}

查询申报主体调用输出

{
    "code": "0",
    "msg": "succeeded",
    "serverTime": 1763113556851,
    "data": {
        "merchantReference": "1234567",
        "status":"0"
    },
    "success": true
}

Updated about 4 hours ago