客户信息报备接口主要用于向跨境合作银行报送企业客户信息,客户需上传真实信息以便在银行成功备案从而进行跨境业务。
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的方法请参考请求加密流程 |