本接口可对商户提供海关报送功能
https://apis.5upay.com/customs/order
参数名称 | 参数中文名称 | 类型& 长度 | 参数说明 | 是否必填 |
---|---|---|---|---|
merchantId | 商户编号 | varchar(20) | 商户在首信易系统的唯一身份标识,商户完成首信易系统注册后可登录商户后台商户服务查看 | M |
paySerialNumber | 支付流水号 | varchar(32) | 此项传在首信易支付成功订单返回的订单流水号 | M |
notifyUrl | 通知地址 | varchar(200) | 支付成功后首信易支付会向该地址发送五次成功通知,该地址可以带参数,“www.5upay.com/callback.action?test=test”注意:如不填 notifyUr的参数值订单成功后您的服务器将得不到成功的通知。 | M |
payer | 付款人信息 | JSON | 见下表,付款人信息,(此项如果不传付款人信息按照收单时传入的付款人信息为准) | C |
customsInfos | 报关信息 | Json(二维数组) | 见下表,报关信息 | M |
hmac | 参数签名 | varchar(500) | 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 | M |
参数名称 | 参数中文名称 | 类型& 长度 | 参数说明 | 是否必填 |
---|---|---|---|---|
payerName | 用户姓名 | varchar(50) | 用户姓名 | C |
IdNum | 证件号 | varchar(18) | 用户身份证号 | C |
phoneNum | phoneNum | varchar(11) | 用户手机号 | C |
参数名称 | 参数中文名称 | 类型& 长度 | 参数说明 | 是否必填 |
---|---|---|---|---|
customsChannel | 报关通道 | varchar(20) | OFFICAL 直连总署版 | M |
amount | 报关金额 | Long(20) | 单位:分,1元=100分 | M |
freight | 运费 | Long(20) | 单位:分,1元=100分,如果不填,默认为0 | O |
goodsAmount | 支付货款 | Long(20) | 单位:分,1元=100分,如果不填,默认为0 | O |
tax | 支付税款 | Long(20) | 单位:分,1元=100分,如果不填,默认为0 | O |
insuredAmount | 保费 | Long(20) | 单位:分,1元=100分,如果不填,默认为0 | O |
merchantCommerceName | 企业备案名称 | Max(100) | 企业在海关备案的名称 | O |
merchantCommerceCode | 企业备案号 | Max(20) | 企业在海关的备案号 | O |
storeHouse | 仓 | varchar (50 ) | 商品所在仓 | O |
customsCode | 主管海关代码 | varchar(4) | 5141 广州机场 | C |
5165 南沙旅检 | ||||
5167 南沙货港 | ||||
5169 番禺东发 | ||||
5145 广州邮办 | ||||
5208 黄埔开发区 | ||||
5216 太平海关驻沙田办事处 | ||||
5130 广州萝岗 | ||||
5185 佛山海关快件监管现场 | ||||
ciqCode | 检验检疫机构代码 | varchar(6) | 000067 机场的国检组织机构代码 | C |
000077 黄埔开发区的组织机构代码 | ||||
443433 黄埔状元谷组织机构代码 | ||||
functionCode | 业务类型 | varchar(10) | CUS 单向海关 | C |
CIQ 单向国检 | ||||
BC 同时发送 | ||||
BBC 同时发送 | ||||
businessType | 业务类型 | varchar(10) | B2B2C | C |
B2C | ||||
dxpid | dxpid | varchar(50) | DXPENT0000012770 南京 | C |
DXPENT0000012808 重庆 | ||||
DXPENT0000012084 广州 | ||||
DXPENT0000012642 深圳 |
参数名称 | 参数中文名称 | 参数说明 |
---|---|---|
merchantId | 商户编号 | 商户在首信易系统的唯一身份标识,商户完成首信易系统注册后可登录商户后台商户服务查看。 |
paySerialNumber | 支付流水号 | 支付流水号 |
status | 请求状态 | SUCCESS:发起成功(不代表报关成功,只能说明报关请求成功提交至首信易系统) |
FAILED:发起失败,重新发起 | ||
ERROR:请求数据或者请求后系统流程出现问题,根据返回错误进行检查数据或者联系首信易 | ||
hmac | 参数签名 | 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 |
参数名称 | 参数中文名称 | 参数说明 |
---|---|---|
merchantId | 商户编号 | 商户编号 |
paySerialNumber | 支付流水号 | 支付流水号 |
customsInfos | 报关参数信息 | JSON(二维数组),参数见下表,报关信息 |
hmac | 参数签名 | 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 |
参数名称 | 参数中文名称 | 参数说明 |
---|---|---|
customsChannel | 报关通道 | GUANGZHOU_OFFICAL广州海关(总署版) |
NINGBO 宁波海关 | ||
TIANJIN_OFFICAL 天津海关(总署版) | ||
ZHUHAI_OFFICAL 珠海海关(总署版) | ||
ZHENGZHOU_ZONGBAO_OFFICAL 郑州综保(总署版) | ||
CHONGQING_OFFICAL 重庆海关(总署版) | ||
ZHENGZHOU_WUBAO_OFFICAL 郑州物保(总署版) | ||
OFFICAL 直连总署版 | ||
SHENZHEN_OFFICAL 深圳海关(总署版) | ||
amount | 报关金额 | 单位:分,1元=100分 |
freight | 运费 | 单位:分,1元=100分,如果不填,默认为0 |
goodsAmount | 支付货款 | 单位:分,1元=100分,如果不填,默认为0 |
tax | 支付税款 | 单位:分,1元=100分,如果不填,默认为0 |
status | 报关状态 | PROCESSING 处理中 |
SUCCESS 成功 | ||
FAILED 失败 |