获取允许的居住国家

端点目标 URL

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

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

字段说明

调用的特定输入参数

字段名称	必填	类型	描述
`merchantId`	M	string	商户号
`queryName`	O	string	查询参数

响应data参数

字段名	类型	说明
`id`	String	国家的唯一标识
`name`	String	国家名称
`iso2`	String	国家的iso2编码
`currency`	String	国家的默认币种

集成

获取允许的居住国家调用输入

{
    "merchantId":"1866780349053448192",
    "queryName": "china"
}

获取允许的居住国家调用输出

{
    "code": "0",
    "msg": "success",
    "serverTime": "1768299820696",
    "data": [
        {
            "id": "45",
            "name": "中国",
            "iso2": "CN",
            "currency": "CNY"
        }
    ],
    "success": true
}

获取国家下的省份/州

端点目标 URL

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

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

字段说明

调用的特定输入参数

字段名称	必填	类型	描述
`merchantId`	M	string	商户号
`countryCode`	M	string	国家iso2编码
`queryName`	O	string	查询参数

响应data参数

名称	类型	必选	约束	说明
`id`	string	false	none	省份/州编号
`name`	string	false	none	省份/州名称
`countryCode`	string	false	none	国家iso2编码
`zipCode`	string	false	none	省份邮政编码

集成

获取国家下的省份/州调用输入

{
  "merchantId":"1866780349053448192",
	"countryCode":"CN",
  "queryName": "浙江"
}

获取国家下的省份/州调用输出

{
    "code": "0",
    "msg": "success",
    "serverTime": "1768299863598",
    "data": [
        {
            "id": "2247",
            "name": "浙江省",
            "countryCode": "CN",
            "zipCode": "330000"
        }
    ],
    "success": true
}

获取省份/州下的城市

端点目标 URL

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

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

字段说明

调用的特定输入参数

字段名称	必填	类型	描述
`merchantId`	M	string	商户号
`provinceId`	M	string	省份/州编号
`queryName`	O	string	查询参数

响应data参数

名称	类型	必选	约束	说明
`id`	string	false	none	城市编号
`name`	string	false	none	城市名称
`stateId`	string	false	none	省份/州编号
`zipCode`	string	false	none	城市邮政编码

集成

获取省份/州下的城市调用输入

{
  "merchantId":"1866780349053448192",
	"provinceId": "2247",
  "queryName": "杭州"
}

获取省份/州下的城市调用输出

{
    "code": "0",
    "msg": "success",
    "serverTime": "1768299909850",
    "data": [
        {
            "id": "19598",
            "name": "杭州市",
            "stateId": "2247",
            "zipCode": "330100"
        }
    ],
    "success": true
}