客户信息报备接口

功能概述

客户信息报备接口主要用于向跨境合作银行报送企业客户信息,客户需上传真实信息以便在银行成功备案从而进行跨境业务。

接口地址

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

报备商户详情 customsInfos

参数名称 参数中文名称 类型& 长度 参数说明 是否必填
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": "120140134", "requestId": "1700464189342", "hmac": "kqfms4417awhyhj6pe3cqkridmogjm1nqqcvix8fsyzif5pz7jgtogq6l7uehv7lkdljlepx8rwle1wshrzzenplr3mdjrm0fi uasy/hipdcltxtdcocv0dll1mudi6mfmfeybve9gxw/o5+fa/v9vhoywffstg960f3cvqy1h+7dbvkrwhnrvxctwlu7n+ub4wlb jgftr+5bayahevxo71z4kzd3zpr3tzu+keficjvh1kuldujjxurxlrnqvkca16tukezy2krhxnb7hmeb5vmwoodmywd7kch39hh 34+spvp2uisr5viyp1bgpsc+nessy0sim8oerd5nci25uq==", "channelType": "PINGAN", "customsInfos": [{ "entName": "测试", "custCode": "000000000", "countryCode": "156", "businessPlaceCode": "110101", "industryAttribute": "0203", "economiesType": "160", "specialEconomicZone": true, "specialEconomicZoneEntType": "00", "customerAddress": "北京", "customerContact": "测试", "customerContactTelephone": "139***5678", "postalCode": "100000" }] }

请求同步返回参数列表

参数名称 参数中文名称 参数说明
merchantId 商户编号 同请求参数
requestId 订单号 同请求参数
status 请求状态 SUCCESS 成功
FAILED 失败
ERROR 错误
hmac 参数签名 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程

示例

{ "merchantId": "120140134", "requestId": "1700731190409", "hmac": "3046022100fc5041cd4bb4a57003a34fa89e297d9857f4017c94a3643db7c90cb8d7972289022100bf9d781705a9ddb2b 991b0c28cb3d7cb649b926e3e6cb6ca071256674e957a61", "status": "SUCCESS" }