客户信息报备接口主要用于向跨境合作银行报送企业客户信息,客户需上传真实信息以便在银行成功备案从而进行跨境业务。
https://apis.5upay.com/foreign/customs/report/order
参数名称 | 参数中文名称 | 类型& 长度 | 参数说明 | 是否必填 |
---|---|---|---|---|
merchantId | 商户编号 | varchar(9) | 商户在首信易系统的唯一id,可在商户后台查看 | M |
requestId | 商户请求号 | varchar(50) | 订单号为商户自行拟定,提交的订单号必须在自身平台交易中唯一。首信易支付系统已付或撤销的订单,商户平台不能以相同的订单号再次提交。 | M |
channelType | 通道类型 | varchar(30) | 通道类型,用于区分所报备的通道 枚举值:PINGAN |
C |
customsInfos | 报备商户详情 | Object[] | 订单号为商户自行拟定,提交的订单号必须在自身平台交易中唯一。首信易支付系统已付或撤销的订单,商户平台不能以相同的订单号再次提交。 | M |
hmac | 参数签名 | varchar(500) | 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 | M |
参数名称 | 参数中文名称 | 类型& 长度 | 参数说明 | 是否必填 |
---|---|---|---|---|
entName | 企业名称 | varchar(100) | 客户名称,必须中文 | M |
custCode | 组织机构代码 | varchar(9) | 实际交易的付款人证件号,对公:9位的企业代码 | M |
countryCode | 常驻国家代码 | varchar(3) | 默认156(中国) | M |
businessPlaceCode | 住所/经营场所代码 | varchar(6) | 必须是行政区划表中存在的记录,如110101 | M |
industryAttribute | 行业属性代码 | varchar(4) | 必须是行业属性代码表中存在的最细分类的记录,如0203 | M |
economiesType | 经济类型代码 | varchar(3) | 必须是经济类型代码表中存在的最细分类的记录,如160 | M |
specialEconomicZone | 是否特殊经济区内企业 | 固定值 | true 是 | M |
false 否 | ||||
specialEconomicZoneEntType | 特殊经济区内企业类型代码 | varchar(2) | 详见特殊经济区内企业类型代码表 | M |
若是否特殊经济区内企业选择否,可选00或60 | ||||
若是否特殊经济区内企业=是,可选01、02、03、04、05、06、07、08、09、10、11、12、99 | ||||
若是否特殊经济区内企业=是,且企业为非自由贸易试验区的特殊经济区内企业,本项可选01、02、03、04、05、06、07、08、09、10、11、99 | ||||
若是否特殊经济区内企业=是,且企业为自由贸易试验区的特殊经济区内企业,本项可选12 | ||||
customerAddress | 客户地址 | varchar(100) | 客户地址,外管要求,客户地址必须中文 | M |
customerContact | 客户联系人 | varchar(50) | 客户联系人 | M |
customerContactTelephone | 客户联系人电话 | varchar(20) | 客户联系人电话 | M |
postalCode | 邮编 | varchar(6) | 邮编 | C |
参数名称 | 参数中文名称 | 参数说明 |
---|---|---|
merchantId | 商户编号 | 同请求参数 |
requestId | 订单号 | 同请求参数 |
status | 请求状态 | SUCCESS 成功 |
FAILED 失败 | ||
ERROR 错误 | ||
hmac | 参数签名 | 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 |