文档
Start typing to search…

子商户


添加子商户

添加子商户

端点目标 URL

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

生产环境请求地址：POST https://api.futurepay.global/api/v1/v1/Onboarding/linkMerchantApi/addSubMerchant

字段说明

调用的特定输入参数

字段名称必填类型描述
merchantNameMstring(1,255)子商户昵称
merchantEmailMstring(1,64)子商户邮箱
personalInformation.longTermEffectivenessMboolean证件长期有效
personalInformation.nationalityMstring(2)国籍(可选项：CN，HK，TW，MO)
personalInformation.identityTypeMinteger证件类型(1:身份证，2:护照)
personalInformation.identityNumberMstring(1,50)证件号码
personalInformation.firstNameMstring(1,50)英文名
personalInformation.lastNameMstring(1,50)英文姓
personalInformation.firstNameCnMstring(1,50)中文名
personalInformation.lastNameCnMstring(1,50)中文姓
personalInformation.dateOfBirthMstring(10)出生日期(yyyy-MM-dd)
personalInformation.expirationDateBeganMstring(10)证件有效期开始(yyyy-MM-dd)
personalInformation.expirationDateEndedQstring(10)证件有效期结束(yyyy-MM-dd)(longTermEffectiveness = false时必填，其他情况为空)
personalInformation.residenceCountryMstring居住国家iso2位编码(通过获取国家接口获取)
personalInformation.residenceProvinceQstring居住省份id(居住国家下存在省份时必填)(通过获取省份接口获取)
personalInformation.residenceCityQstring居住城市id(居住省份下存在城市时必填)(通过获取城市接口获取)
personalInformation.residenceAddressMstring(1,200)居住地址
personalInformation.residenceZipMstring(1,20)居住邮编
personalInformation.portraitFaceMstring证件人像面(文件id通过文件上传获取)
personalInformation.nationalEmblemSurfaceQstring证件国徽面(identityType=1时必填)(文件id通过文件上传 获取)
personalInformation.proofOfAddressM[string]地址证明文件(文件id通过文件上传 获取)
businessInformation.applyProductsM[string]申请产品(可选值见申请的产品)
businessInformation.tradingVolumeMstring交易量
businessInformation.transactionsNumberMinteger交易笔数
businessInformation.averageCollectionAmountMstring平均入账金额
businessInformation.averagePaymentAmountMstring平均出账金额
businessInformation.businessWebsiteO[string]业务网站
businessInformation.industryCategoryMstring行业类别(可选值见行业类别)
businessInformation.businessCountryM[string]业务国家地区(通过获取国家 接口获取)
businessInformation.servicesTypeMstring服务类型(可选类型见服务类别字典对照表)
businessInformation.openingPurposeMstring(1,200)开户目的
businessInformation.payingParty[].nameMstring(1,50)付款方名称(payingParty至少需要添加3位、最多10位付款方)
businessInformation.payingParty[].countryMstring付款方国家(通过获取国家 接口获取)
businessInformation.payingParty[].tradingVolumeMinteger付款方交易量
businessInformation.payingParty[].currencyMstring付款方币种
businessInformation.beneficiary[].nameMstring(1,50)受益人名称(beneficiary至少需要添加3位、最多10位受益人)
businessInformation.beneficiary[].countryMstring受益人国家(通过获取国家 接口获取)
businessInformation.beneficiary[].tradingVolumeMinteger受益人交易量
businessInformation.beneficiary[].currencyMstring受益人币种
linkToLiveVerification.verificationLinkOstring验证链接
linkToLiveVerification.validityTimeOstring验证到期
linkToLiveVerification.statusOstring验证状态

响应data参数

字段名称类型描述
requestIDstring请求唯一id
subMerchantIdstring子商户商户号
merchantNamestring子商户昵称
merchantEmailstring(email)子商户邮箱
statusstring子商户状态(可能的值见商户状态)
personalInformation.longTermEffectivenessboolean证件长期有效
personalInformation.nationalitystring国籍
personalInformation.identityTypeinteger证件类型
personalInformation.identityNumberstring证件号码
personalInformation.firstNamestring英文名
personalInformation.lastNamestring英文姓
personalInformation.firstNameCnstring中文名
personalInformation.lastNameCnstring中文姓
personalInformation.dateOfBirthstring出生日期(yyyy-MM-dd)
personalInformation.expirationDateBeganstring证件有效期开始(yyyy-MM-dd)
personalInformation.expirationDateEndedstring证件有效期结束(yyyy-MM-dd)
personalInformation.residenceCountrystring居住国家
personalInformation.residenceProvincestring居住省份
personalInformation.residenceCitystring居住城市
personalInformation.residenceAddressstring居住地址
personalInformation.residenceZipstring居住邮编
personalInformation.portraitFacestring证件人像面可查看链接
personalInformation.nationalEmblemSurfacestring证件国徽面可查看链接
personalInformation.proofOfAddress[string]地址证明文件可查看链接集合
businessInformation.applyProducts[string]申请产品
businessInformation.tradingVolumestring交易量
businessInformation.transactionsNumberinteger交易笔数
businessInformation.averageCollectionAmountstring平均入账金额
businessInformation.averagePaymentAmountstring平均出账金额
businessInformation.businessWebsite[string]业务网站
businessInformation.industryCategorystring行业类别
businessInformation.businessCountry[string]业务国家地区
businessInformation.servicesTypestring服务类型
businessInformation.openingPurposestring开户目的
businessInformation.payingParty[].namestring付款方名称
businessInformation.payingParty[].countrystring付款方国家
businessInformation.payingParty[].tradingVolumeinteger付款方交易量
businessInformation.payingParty[].currencystring付款方币种
businessInformation.beneficiary[].namestring受益人名称
businessInformation.beneficiary[].countrystring受益人国家
businessInformation.beneficiary[].tradingVolumeinteger受益人交易量
businessInformation.beneficiary[].currencystring受益人币种
linkToLiveVerification.verificationLinkstring验证链接
linkToLiveVerification.validityTimestring验证到期
linkToLiveVerification.statusstring验证状态

集成

添加子商户调用输入

{
        "merchantName": "testName",
        "merchantEmail": "[email protected]",
        "personalInformation": {
            "nationality": "CN",
            "identityType": "1",
            "identityNumber": "110000194910010101",
            "firstName": "firstName",
            "lastName": "lastName",
            "firstNameCn": "名",
            "lastNameCn": "姓",
            "dateOfBirth": "1949-10-01",
            "expirationDateBegan": "1949-10-01",
            "expirationDateEnded": "2025-12-12",
            "residenceCountry": "CN",
            "residenceProvince": "2257",
            "residenceCity": "19332",
            "residenceAddress": "详细地址",
            "residenceZip": "110100",
            "portraitFace": "1989162017658933248",
            "nationalEmblemSurface": "1989162072558178304",
            "proofOfAddress": [
                "1989162072558178304"
            ],
            "longTermEffectiveness": false
        },
        "businessInformation": {
            "applyProducts": [
                "GLOBAL_RECEIVABLES"
            ],
            "tradingVolume": "11111.00",
            "transactionsNumber": "11",
            "averageCollectionAmount": "11.00",
            "averagePaymentAmount": "12.00",
            "businessWebsite": [
                "https://premerchant.futurepay-develop.com/"
            ],
            "industryCategory": "commerce_trade",
            "businessCountry": [
                "CN"
            ],
            "servicesType": "LOGISTICS_TRANSPORTATION_OTHER",
            "openingPurpose": "开户目的",
            "payingParty": [
                {
                    "name": "付款方甲",
                    "country": "CN",
                    "tradingVolume": "44",
                    "currency": "CNY"
                },
                {
                    "name": "付款方乙",
                    "country": "CN",
                    "tradingVolume": "33",
                    "currency": "CNY"
                },
                {
                    "name": "付款方丙",
                    "country": "CN",
                    "tradingVolume": "22",
                    "currency": "CNY"
                }
            ],
            "beneficiary": [
                {
                    "name": "受益人甲",
                    "country": "CN",
                    "tradingVolume": "44",
                    "currency": "CNY"
                },
                {
                    "name": "受益人乙",
                    "country": "CN",
                    "tradingVolume": "11",
                    "currency": "CNY"
                },
                {
                    "name": "受益人丙",
                    "country": "CN",
                    "tradingVolume": "22",
                    "currency": "CNY"
                }
            ]
        }
    }

添加子商户调用输出

{
    "code": "0",
    "msg": "success",
    "serverTime": "1763347647783",
    "data": {
        "subMerchantId": "1990250402871947264",
        "requestID": "89b4a43b-f358-451a-967f-3bcbf9f88cfe",
        "merchantName": "testName",
        "merchantEmail": "[email protected]",
				"status": "Filling",
        "personalInformation": {
            "nationality": "CN",
            "identityType": "1",
            "identityNumber": "110000194910010101",
            "firstName": "firstName",
            "lastName": "lastName",
            "firstNameCn": "名",
            "lastNameCn": "姓",
            "dateOfBirth": "1949-10-01",
            "expirationDateBegan": "1949-10-01",
            "expirationDateEnded": "2025-12-12",
            "residenceCountry": "CN",
            "residenceProvince": "2257",
            "residenceCity": "19332",
            "residenceAddress": "详细地址",
            "residenceZip": "110100",
            "portraitFace": "https://futurebank-oss-dev.oss-ap-southeast-1.aliyuncs.com/baseInfo/1866780349053448192/kycAPI/0216b0cb6bf4458aa9d3317c664a4650.jpg?Expires=1763351247&OSSAccessKeyId=LTAI5t8WygUaJCd46Wk7fcKt&Signature=Sdo5BWOgnznxM2%2FR%2FQjgn6NuknI%3D",
            "nationalEmblemSurface": "https://futurebank-oss-dev.oss-ap-southeast-1.aliyuncs.com/baseInfo/1866780349053448192/kycAPI/c4fc11755d3c434f9b8e2c885511706d.jpg?Expires=1763351247&OSSAccessKeyId=LTAI5t8WygUaJCd46Wk7fcKt&Signature=vLurtX%2BB3Z2nPNo7c%2FjAIjRPBBg%3D",
            "proofOfAddress": [
                "https://futurebank-oss-dev.oss-ap-southeast-1.aliyuncs.com/baseInfo/1866780349053448192/kycAPI/c4fc11755d3c434f9b8e2c885511706d.jpg?Expires=1763351247&OSSAccessKeyId=LTAI5t8WygUaJCd46Wk7fcKt&Signature=vLurtX%2BB3Z2nPNo7c%2FjAIjRPBBg%3D"
            ],
            "longTermEffectiveness": false
        },
        "businessInformation": {
            "applyProducts": [
                "GLOBAL_RECEIVABLES"
            ],
            "tradingVolume": "11111.00",
            "transactionsNumber": "11",
            "averageCollectionAmount": "11.00",
            "averagePaymentAmount": "12.00",
            "businessWebsite": [
                "https://premerchant.futurepay-develop.com/"
            ],
            "industryCategory": "commerce_trade",
            "businessCountry": [
                "CN"
            ],
            "servicesType": "LOGISTICS_TRANSPORTATION_OTHER",
            "openingPurpose": "开户目的",
            "payingParty": [
                {
                    "name": "付款方甲",
                    "country": "CN",
                    "tradingVolume": "44",
                    "currency": "CNY"
                },
                {
                    "name": "付款方乙",
                    "country": "CN",
                    "tradingVolume": "33",
                    "currency": "CNY"
                },
                {
                    "name": "付款方丙",
                    "country": "CN",
                    "tradingVolume": "22",
                    "currency": "CNY"
                }
            ],
            "beneficiary": [
                {
                    "name": "受益人甲",
                    "country": "CN",
                    "tradingVolume": "44",
                    "currency": "CNY"
                },
                {
                    "name": "受益人乙",
                    "country": "CN",
                    "tradingVolume": "11",
                    "currency": "CNY"
                },
                {
                    "name": "受益人丙",
                    "country": "CN",
                    "tradingVolume": "22",
                    "currency": "CNY"
                }
            ]
        },
        "linkToLiveVerification": null
    },
    "success": true
}


修改子商户

修改子商户

端点目标 URL

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

生产环境请求地址：POST https://api.futurepay.global/api/v1/v1/Onboarding/linkMerchantApi/editSubMerchant

字段说明

调用的特定输入参数

字段名称必填类型描述
subMerchantIdMstring子商户商户号
merchantNameOstring(1,255)子商户昵称
merchantEmailOstring(1,64)子商户邮箱
personalInformation.longTermEffectivenessOboolean证件长期有效
personalInformation.nationalityOstring国籍(可选项：CN，HK，TW，MO)
personalInformation.identityTypeOinteger证件类型(1:身份证，2:护照)
personalInformation.identityNumberOstring(1,50)证件号码
personalInformation.firstNameOstring(1,50)英文名
personalInformation.lastNameOstring(1,50)英文姓
personalInformation.firstNameCnOstring(1,50)中文名
personalInformation.lastNameCnOstring(1,50)中文姓
personalInformation.dateOfBirthOstring(10)出生日期(yyyy-MM-dd)
personalInformation.expirationDateBeganOstring(10)证件有效期开始(yyyy-MM-dd)
personalInformation.expirationDateEndedQstring(10)证件有效期结束(yyyy-MM-dd)(longTermEffectiveness = false时必填，其他情况为空)
personalInformation.residenceCountryOstring居住国家iso2编码(通过获取国家 接口获取)
personalInformation.residenceProvinceQstring居住省份id(居住国家下存在省份时必填)(通过获取省份 接口获取)
personalInformation.residenceCityQstring居住城市id(居住省份下存在城市时必填)(通过获取城市 接口获取)
personalInformation.residenceAddressOstring(1,200)居住地址
personalInformation.residenceZipOstring(1,20)居住邮编
personalInformation.portraitFaceQstring证件人像面(identityType改变时必填)(文件id通过文件上传 获取)
personalInformation.nationalEmblemSurfaceQstring证件国徽面(identityType改变并且identityType=1时必填)(文件id通过文件上传 获取)
personalInformation.proofOfAddressO[string]地址证明文件(文件id通过文件上传 获取)
businessInformation.applyProductsO[string]申请产品(可选值见申请的产品 )
businessInformation.tradingVolumeOstring交易量
businessInformation.transactionsNumberOinteger交易笔数
businessInformation.averageCollectionAmountOstring平均入账金额
businessInformation.averagePaymentAmountOstring平均出账金额
businessInformation.businessWebsiteO[string]业务网站
businessInformation.industryCategoryOstring行业类别(可选值见行业类别 )
businessInformation.businessCountryO[string]业务国家地区(通过获取国家 接口获取)
businessInformation.servicesTypeOstring服务类型(可选类型见服务类别字典对照表)
businessInformation.openingPurposeOstring(1,200)开户目的
businessInformation.payingParty[].nameOstring(1,50)付款方名称(payingParty至少需要添加3位、最多10位付款方)
businessInformation.payingParty[].countryOstring付款方国家(通过获取国家 接口获取)
businessInformation.payingParty[].tradingVolumeOinteger付款方交易量
businessInformation.payingParty[].currencyOstring付款方币种
businessInformation.beneficiary[].nameOstring(1,50)受益人名称(beneficiary至少需要添加3位、最多10位受益人)
businessInformation.beneficiary[].countryOstring受益人国家(通过获取国家 接口获取)
businessInformation.beneficiary[].tradingVolumeOinteger受益人交易量
businessInformation.beneficiary[].currencyOstring受益人币种

响应data参数

字段名称类型描述
requestIDstring请求唯一id
subMerchantIdstring子商户商户号
merchantNamestring子商户昵称
merchantEmailstring(email)子商户邮箱
statusstring子商户状态(可能的值见商户状态)
personalInformation.longTermEffectivenessboolean证件长期有效
personalInformation.nationalitystring国籍
personalInformation.identityTypeinteger证件类型
personalInformation.identityNumberstring证件号码
personalInformation.firstNamestring英文名
personalInformation.lastNamestring英文姓
personalInformation.firstNameCnstring中文名
personalInformation.lastNameCnstring中文姓
personalInformation.dateOfBirthstring出生日期(yyyy-MM-dd)
personalInformation.expirationDateBeganstring证件有效期开始(yyyy-MM-dd)
personalInformation.expirationDateEndedstring证件有效期结束(yyyy-MM-dd)
personalInformation.residenceCountrystring居住国家
personalInformation.residenceProvincestring居住省份
personalInformation.residenceCitystring居住城市
personalInformation.residenceAddressstring居住地址
personalInformation.residenceZipstring居住邮编
personalInformation.portraitFacestring证件人像面可查看链接
personalInformation.nationalEmblemSurfacestring证件国徽面可查看链接
personalInformation.proofOfAddress[string]地址证明文件可查看链接集合
businessInformation.applyProducts[string]申请产品
businessInformation.tradingVolumestring交易量
businessInformation.transactionsNumberinteger交易笔数
businessInformation.averageCollectionAmountstring平均入账金额
businessInformation.averagePaymentAmountstring平均出账金额
businessInformation.businessWebsite[string]业务网站
businessInformation.industryCategorystring行业类别(可选值：commerce_trade：电商贸易，air_tourism：航空旅游，educational_services：教育服务，advertising_services：广告服务，communication_services：通信服务，convention_services：会议展览服务，software_services：软件服务，general_trade：一般贸易，procurement_trade：物流运输)
businessInformation.businessCountry[string]业务国家地区
businessInformation.servicesTypestring服务类型
businessInformation.openingPurposestring开户目的
businessInformation.payingParty[].namestring付款方名称
businessInformation.payingParty[].countrystring付款方国家
businessInformation.payingParty[].tradingVolumeinteger付款方交易量
businessInformation.payingParty[].currencystring付款方币种
businessInformation.beneficiary[].namestring受益人名称
businessInformation.beneficiary[].countrystring受益人国家
businessInformation.beneficiary[].tradingVolumeinteger受益人交易量
businessInformation.beneficiary[].currencystring受益人币种
linkToLiveVerification.verificationLinkstring验证链接
linkToLiveVerification.validityTimestring验证到期
linkToLiveVerification.statusstring验证状态

集成

修改子商户调用输入

{
    "subMerchantId": "1990250402871947264",
    "merchantName": "testName",
    "merchantEmail": "[email protected]",
    "personalInformation": {
        "nationality": "CN",
        "identityType": "1",
        "identityNumber": "110000194910010101",
        "firstName": "firstName",
        "lastName": "lastName",
        "firstNameCn": "名",
        "lastNameCn": "姓",
        "dateOfBirth": "1949-10-01",
        "expirationDateBegan": "1949-10-01",
        "expirationDateEnded": "2025-12-12",
        "residenceCountry": "CN",
        "residenceProvince": "2257",
        "residenceCity": "19332",
        "residenceAddress": "详细地址",
        "residenceZip": "110100",
        "portraitFace": "1989162017658933248",
        "nationalEmblemSurface": "1989162072558178304",
        "proofOfAddress": [
            "1989162072558178304"
        ],
        "longTermEffectiveness": false
    },
    "businessInformation": {
        "applyProducts": [
            "GLOBAL_RECEIVABLES"
        ],
        "tradingVolume": "11111.00",
        "transactionsNumber": "11",
        "averageCollectionAmount": "11.00",
        "averagePaymentAmount": "12.00",
        "businessWebsite": [
            "https://premerchant.futurepay-develop.com/"
        ],
        "industryCategory": "commerce_trade",
        "businessCountry": [
            "CN"
        ],
        "servicesType": "LOGISTICS_TRANSPORTATION_OTHER",
        "openingPurpose": "开户目的",
        "payingParty": [
            {
                "name": "付款方甲",
                "country": "CN",
                "tradingVolume": "44",
                "currency": "CNY"
            },
            {
                "name": "付款方乙",
                "country": "CN",
                "tradingVolume": "33",
                "currency": "CNY"
            },
            {
                "name": "付款方丙",
                "country": "CN",
                "tradingVolume": "22",
                "currency": "CNY"
            }
        ],
        "beneficiary": [
            {
                "name": "受益人甲",
                "country": "CN",
                "tradingVolume": "44",
                "currency": "CNY"
            },
            {
                "name": "受益人乙",
                "country": "CN",
                "tradingVolume": "11",
                "currency": "CNY"
            },
            {
                "name": "受益人丙",
                "country": "CN",
                "tradingVolume": "22",
                "currency": "CNY"
            }
        ]
    }
}

修改子商户调用输出

{
    "code": "0",
    "msg": "success",
    "serverTime": "1763350047088",
    "data": {
        "subMerchantId": "1990250402871947264",
        "requestID": "511dfc3f-8d18-4fc3-9aa9-ad2494a675a0",
        "merchantName": "testName",
        "merchantEmail": "[email protected]",
				"status": "Filling",
        "personalInformation": {
            "nationality": "CN",
            "identityType": "1",
            "identityNumber": "110000194910010101",
            "firstName": "firstName",
            "lastName": "lastName",
            "firstNameCn": "名",
            "lastNameCn": "姓",
            "dateOfBirth": "1949-10-01",
            "expirationDateBegan": "1949-10-01",
            "expirationDateEnded": "2025-12-12",
            "residenceCountry": "CN",
            "residenceProvince": "2257",
            "residenceCity": "19332",
            "residenceAddress": "详细地址",
            "residenceZip": "110100",
            "portraitFace": "https://futurebank-oss-dev.oss-ap-southeast-1.aliyuncs.com/baseInfo/1866780349053448192/kycAPI/0216b0cb6bf4458aa9d3317c664a4650.jpg?Expires=1763353647&OSSAccessKeyId=LTAI5t8WygUaJCd46Wk7fcKt&Signature=NSXfN8g9YgGWJ1DuEeCL2X1zb00%3D",
            "nationalEmblemSurface": "https://futurebank-oss-dev.oss-ap-southeast-1.aliyuncs.com/baseInfo/1866780349053448192/kycAPI/c4fc11755d3c434f9b8e2c885511706d.jpg?Expires=1763353647&OSSAccessKeyId=LTAI5t8WygUaJCd46Wk7fcKt&Signature=SQSTzgJ%2B0MuHtP3aJLjF92BzyfA%3D",
            "proofOfAddress": [
                "https://futurebank-oss-dev.oss-ap-southeast-1.aliyuncs.com/baseInfo/1866780349053448192/kycAPI/c4fc11755d3c434f9b8e2c885511706d.jpg?Expires=1763353647&OSSAccessKeyId=LTAI5t8WygUaJCd46Wk7fcKt&Signature=SQSTzgJ%2B0MuHtP3aJLjF92BzyfA%3D"
            ],
            "longTermEffectiveness": null
        },
        "businessInformation": {
            "applyProducts": [
                "GLOBAL_RECEIVABLES"
            ],
            "tradingVolume": "11111.00",
            "transactionsNumber": "11",
            "averageCollectionAmount": "11.00",
            "averagePaymentAmount": "12.00",
            "businessWebsite": [
                "https://premerchant.futurepay-develop.com/"
            ],
            "industryCategory": "commerce_trade",
            "businessCountry": [
                "CN"
            ],
            "servicesType": "LOGISTICS_TRANSPORTATION_OTHER",
            "openingPurpose": "开户目的",
            "payingParty": [
                {
                    "name": "付款方甲",
                    "country": "CN",
                    "tradingVolume": "44",
                    "currency": "CNY"
                },
                {
                    "name": "付款方乙",
                    "country": "CN",
                    "tradingVolume": "33",
                    "currency": "CNY"
                },
                {
                    "name": "付款方丙",
                    "country": "CN",
                    "tradingVolume": "22",
                    "currency": "CNY"
                }
            ],
            "beneficiary": [
                {
                    "name": "受益人甲",
                    "country": "CN",
                    "tradingVolume": "44",
                    "currency": "CNY"
                },
                {
                    "name": "受益人乙",
                    "country": "CN",
                    "tradingVolume": "11",
                    "currency": "CNY"
                },
                {
                    "name": "受益人丙",
                    "country": "CN",
                    "tradingVolume": "22",
                    "currency": "CNY"
                }
            ]
        },
        "linkToLiveVerification": {
            "verificationLink": null,
            "validityTime": null,
            "status": null
        }
    },
    "success": true
}


查询子商户信息

查询子商户信息

端点目标 URL

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

生产环境请求地址：POST https://api.futurepay.global/api/v1/v1/Onboarding/linkMerchantApi/editSubMerchant

字段说明

调用的特定输入参数

字段名称必填类型描述
subMerchantIdMstring子商户商户号

响应data参数

字段名称类型描述
requestIDstring请求唯一id
subMerchantIdstring子商户商户号
merchantNamestring子商户昵称
merchantEmailstring(email)子商户邮箱
statusstring子商户状态(可能的值见商户状态)
personalInformation.longTermEffectivenessboolean证件长期有效
personalInformation.nationalitystring国籍
personalInformation.identityTypeinteger证件类型
personalInformation.identityNumberstring证件号码
personalInformation.firstNamestring英文名
personalInformation.lastNamestring英文姓
personalInformation.firstNameCnstring中文名
personalInformation.lastNameCnstring中文姓
personalInformation.dateOfBirthstring出生日期(yyyy-MM-dd)
personalInformation.expirationDateBeganstring证件有效期开始(yyyy-MM-dd)
personalInformation.expirationDateEndedstring证件有效期结束(yyyy-MM-dd)
personalInformation.residenceCountrystring居住国家
personalInformation.residenceProvincestring居住省份
personalInformation.residenceCitystring居住城市
personalInformation.residenceAddressstring居住地址
personalInformation.residenceZipstring居住邮编
personalInformation.portraitFacestring证件人像面可查看链接
personalInformation.nationalEmblemSurfacestring证件国徽面可查看链接
personalInformation.proofOfAddress[string]地址证明文件可查看链接集合
businessInformation.applyProducts[string]申请产品
businessInformation.tradingVolumestring交易量
businessInformation.transactionsNumberinteger交易笔数
businessInformation.averageCollectionAmountstring平均入账金额
businessInformation.averagePaymentAmountstring平均出账金额
businessInformation.businessWebsite[string]业务网站
businessInformation.industryCategorystring行业类别
businessInformation.businessCountry[string]业务国家地区
businessInformation.servicesTypestring服务类型
businessInformation.openingPurposestring开户目的
businessInformation.payingParty[].namestring付款方名称
businessInformation.payingParty[].countrystring付款方国家
businessInformation.payingParty[].tradingVolumeinteger付款方交易量
businessInformation.payingParty[].currencystring付款方币种
businessInformation.beneficiary[].namestring受益人名称
businessInformation.beneficiary[].countrystring受益人国家
businessInformation.beneficiary[].tradingVolumeinteger受益人交易量
businessInformation.beneficiary[].currencystring受益人币种
linkToLiveVerification.verificationLinkstring验证链接
linkToLiveVerification.validityTimestring验证到期
linkToLiveVerification.statusstring验证状态

集成

查询子商户信息调用输入

{
    "subMerchantId": "1990250402871947264"
}

查询子商户信息调用输出

{
	"code": "0",
	"msg": "success",
	"serverTime": "1763350488691",
	"data": {
		"subMerchantId": "1990250402871947264",
		"requestID": "32a4820c-7c49-43c7-bc0f-1d72e1a8c65c",
		"merchantName": "testName",
		"merchantEmail": "[email protected]",
		"status": "Filling",
		"personalInformation": {
			"nationality": "CN",
			"identityType": "1",
			"identityNumber": "110000194910010101",
			"firstName": "firstName",
			"lastName": "lastName",
			"firstNameCn": "名",
			"lastNameCn": "姓",
			"dateOfBirth": "1949-10-01",
			"expirationDateBegan": "1949-10-01",
			"expirationDateEnded": "2025-12-12",
			"residenceCountry": "CN",
			"residenceProvince": "2257",
			"residenceCity": "19332",
			"residenceAddress": "详细地址",
			"residenceZip": "110100",
			"portraitFace": "https://futurebank-oss-dev.oss-ap-southeast-1.aliyuncs.com/baseInfo/1866780349053448192/kycAPI/0216b0cb6bf4458aa9d3317c664a4650.jpg?Expires=1763354088&OSSAccessKeyId=LTAI5t8WygUaJCd46Wk7fcKt&Signature=fHlvwYArpa4H7eaBN%2B8rDBU1Afg%3D",
			"nationalEmblemSurface": "https://futurebank-oss-dev.oss-ap-southeast-1.aliyuncs.com/baseInfo/1866780349053448192/kycAPI/c4fc11755d3c434f9b8e2c885511706d.jpg?Expires=1763354088&OSSAccessKeyId=LTAI5t8WygUaJCd46Wk7fcKt&Signature=sjHFTHFWkaRj9bUA3t59YDHK5g8%3D",
			"proofOfAddress": [
				"https://futurebank-oss-dev.oss-ap-southeast-1.aliyuncs.com/baseInfo/1866780349053448192/kycAPI/c4fc11755d3c434f9b8e2c885511706d.jpg?Expires=1763354088&OSSAccessKeyId=LTAI5t8WygUaJCd46Wk7fcKt&Signature=sjHFTHFWkaRj9bUA3t59YDHK5g8%3D"
			],
			"longTermEffectiveness": null
		},
		"businessInformation": {
			"applyProducts": [
				"GLOBAL_RECEIVABLES"
			],
			"tradingVolume": "11111.00",
			"transactionsNumber": "11",
			"averageCollectionAmount": "11.00",
			"averagePaymentAmount": "12.00",
			"businessWebsite": [
				"https://premerchant.futurepay-develop.com/"
			],
			"industryCategory": "commerce_trade",
			"businessCountry": [
				"CN"
			],
			"servicesType": "LOGISTICS_TRANSPORTATION_OTHER",
			"openingPurpose": "开户目的",
			"payingParty": [
				{
					"name": "付款方甲",
					"country": "CN",
					"tradingVolume": "44",
					"currency": "CNY"
				},
				{
					"name": "付款方乙",
					"country": "CN",
					"tradingVolume": "33",
					"currency": "CNY"
				},
				{
					"name": "付款方丙",
					"country": "CN",
					"tradingVolume": "22",
					"currency": "CNY"
				}
			],
			"beneficiary": [
				{
					"name": "受益人甲",
					"country": "CN",
					"tradingVolume": "44",
					"currency": "CNY"
				},
				{
					"name": "受益人乙",
					"country": "CN",
					"tradingVolume": "11",
					"currency": "CNY"
				},
				{
					"name": "受益人丙",
					"country": "CN",
					"tradingVolume": "22",
					"currency": "CNY"
				}
			]
		},
		"linkToLiveVerification": {
			"verificationLink": null,
			"validityTime": null,
			"status": null
		}
	},
	"success": true
}

子商户提交审核

子商户提交审核

端点目标 URL

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

生产环境请求地址：POST https://api.futurepay.global/api/v1/v1/Onboarding/linkMerchantApi/submitReview

字段说明

调用的特定输入参数

字段名称必填类型描述
subMerchantIdMstring子商户商户号

集成

子商户提交审核调用输入

{
    "subMerchantId": "1990250402871947264"
}

子商户提交审核调用输出

{
    "code": "0",
    "msg": "succeeded",
    "serverTime": "1763351728504",
    "success": true
}

字典对照表

业务类别字典对照表

valuename
LOGISTICS_TRANSPORTATION_OTHER物流运输-其他
LOGISTICS_TRANSPORTATION_EXPRESS物流运输-快递服务
LOGISTICS_TRANSPORTATION_WAREHOUSE物流运输-仓储服务
LOGISTICS_TRANSPORTATION_LAND物流运输-陆运运输服务
LOGISTICS_TRANSPORTATION_AIR物流运输-空运运输服务
LOGISTICS_TRANSPORTATION_SEA物流运输-海运运输服务
MARKET_PURCHASE_OTHER市场采购贸易-其他
MARKET_PURCHASE_VEHICLES_AUTO_PARTS市场采购贸易-车辆、机械设备及汽配用品
MARKET_PURCHASE_DAILY_OFFICE_SUPPLIES市场采购贸易-日用/办公用品
MARKET_PURCHASE_FOOD_BEVERAGE市场采购贸易-食品及饮料
MARKET_PURCHASE_FURNITURE_LAMP市场采购贸易-家具灯具
MARKET_PURCHASE_3C_PRODUCTS市场采购贸易-3C数码家电
MARKET_PURCHASE_BABY_PRODUCTS市场采购贸易-母婴用品
MARKET_PURCHASE_ELECTRON市场采购贸易-电子产业（如电子元器件）
MARKET_PURCHASE_CHEMICAL市场采购贸易-化学产品和塑料制品
MARKET_PURCHASE_MEDICINE市场采购贸易-医药及医疗器械
MARKET_PURCHASE_BEAUTY_MAKEUP市场采购贸易-美容化妆
MARKET_PURCHASE_CLOTHING_BAGS市场采购贸易-服饰箱包
GENERAL_TRADE_OTHER一般贸易-其他
GENERAL_TRADE_VEHICLES_AUTO_PARTS一般贸易-车辆、机械设备及汽配用品
GENERAL_TRADE_DAILY_OFFICE_SUPPLIES一般贸易-日用/办公用品
GENERAL_TRADE_FOOD_BEVERAGE一般贸易-食品及饮料
GENERAL_TRADE_FURNITURE_LAMP一般贸易-家具灯具
GENERAL_TRADE_3C_PRODUCTS一般贸易-3C数码家电
GENERAL_TRADE_BABY_PRODUCTS一般贸易-母婴用品
GENERAL_TRADE_ELECTRON一般贸易-电子产业（如电子元器件）
GENERAL_TRADE_CHEMICAL一般贸易-化学产品和塑料制品
GENERAL_TRADE_MEDICINE一般贸易-医药及医疗器械
GENERAL_TRADE_BEAUTY_MAKEUP一般贸易-美容化妆
GENERAL_TRADE_CLOTHING_BAGS一般贸易-服饰箱包
EC_CLOTHING_BAGS电商贸易-服饰箱包
EC_BEAUTY_MAKEUP电商贸易-美容化妆
EC_MEDICINE电商贸易-医药及医疗器械
EC_CHEMICAL电商贸易-化学产品和塑料制品
EC_ELECTRON电商贸易-电子产业（如电子元器件）
EC_BABY_PRODUCTS电商贸易-母婴用品
EC_3C_PRODUCTS电商贸易-3C数码家电
EC_FURNITURE_LAMP电商贸易-家具灯具
EC_FOOD_BEVERAGE电商贸易-食品及饮料
EC_DAILY_OFFICE_SUPPLIES电商贸易-日用/办公用品
EC_VEHICLES_AUTO_PARTS电商贸易-车辆、机械设备及汽配用品
EC_OTHER电商贸易-其他
SOFTWARE_SERVICE_GAME软件服务-游戏应用开发者
SOFTWARE_SERVICE_LIVE_BROADCAST软件服务-直播/语聊/社交应用开发者
SOFTWARE_SERVICE_VIDEO_AUDIO软件服务-影音/图文工具类应用开发者
SOFTWARE_SERVICE_VIRTUAL_RECHARGE软件服务-虚拟产品充值
SOFTWARE_SERVICE_APPLICATION_PUBLISHER软件服务-应用发行商
SOFTWARE_SERVICE_AD软件服务-广告流量变现
SOFTWARE_SERVICE_STREAM软件服务-流媒体视频制作
SOFTWARE_SERVICE_CLOUD_SERVICE_PROVIDER软件服务-云服务商
SOFTWARE_SERVICE_SUBSCRIBE_SERVICE_PLATFORM软件服务-订阅服务平台
SOFTWARE_SERVICE_OTHER软件服务-其他
EDUCATION_STUDY_ABROAD_SERVICE教育服务-留学服务
EDUCATION_ONLINE教育服务-线上教育
EDUCATION_OTHER教育服务-其他
AD_SERVICE_MARKET广告服务-广告营销服务
AD_SERVICE_OTHER广告服务-其他
CONVENTION_EXHIBITION_SERVICE_EXHIBIT会议展览服务-展览服务
CONVENTION_EXHIBITION_SERVICE_OTHER会议展览服务-其他
CONVENTION_EXHIBITION_SERVICE_MEET会议展览服务-会议服务
AIR_TRAVEL_OTHER航空旅游-其他
AIR_TRAVEL_TICKET_COMPANY航空旅游-票务公司
AIR_TRAVEL_CAR_RENTAL_COMPANY航空旅游-租车公司
AIR_TRAVEL_OTA航空旅游-在线旅行社
AIR_TRAVEL_HOTEL航空旅游-酒店集团
AIR_TRAVEL_TICKET_AGENCY航空旅游-机票代理
AIR_TRAVEL_AIRLINE航空旅游-航空公司
AIR_TRAVEL_TRAVEL_AGENCY_TMC航空旅游-旅行社/商旅管理公司
COMMUNICATION_SERVICE_TELE通信服务-电信服务
COMMUNICATION_SERVICE_OTHER通信服务-其他

行业类别

valuename
commerce_trade电商贸易
air_tourism航空旅游
educational_services教育服务
advertising_services广告服务
communication_services通信服务
convention_services会议展览服务
software_services软件服务
general_trade一般贸易
procurement_trade物流运输

申请的产品

valuename
GLOBAL_RECEIVABLES全球收款
GLOBAL_PAYMENTS全球付款
CURRENCY_EXCHANGE极速换汇
EXCHANGE_SETTLEMENT结汇业务

商户状态

valuename
Filling填写中
Pending待审核
Activated已激活
Returned退回
Closed关闭

WEBHOOK

当子商户状态变更时，我们会发送如下通知到您的主商户回调地址

{
	"merchantId": "1866780349053448192",
	"notificationItems": [
		{
			"eventCode": "SUB_MERCHANT_STATUS_NOTIFY",
			"subMerchantId": 1990250402871947264,
			"status": "Activated",
			"eventDate": 1763359209167
		}
	]
}

Updated about 16 hours ago