报关请求接口

功能概述

本接口可对商户提供海关报送功能

接口地址

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

请求参数列表 （payer，付款人信息）

参数名称 参数中文名称 类型& 长度 参数说明 是否必填
payerName 用户姓名 varchar(50) 用户姓名 C
IdNum 证件号 varchar(18) 用户身份证号 C
phoneNum phoneNum varchar(11) 用户手机号 C

请求参数列表 （customsInfos，报关信息）

参数名称 参数中文名称 类型& 长度 参数说明 是否必填
customsChannel 报关通道 varchar(20) OFFICAL 直连总署版 M
ZHEJIANG 浙江海关
QINGDAO 青岛海关
NINGBO 宁波海关
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

参数示例

{ "merchantId": "100000050", "paySerialNumber": "e09b2f9474d0452db254e1977c8db0c5", "notifyUrl": "http://demo.5upay.com/sdk/customs/notify", "customsInfos": [ { "amount": 1, "customsChannel": "GUANGZHOU", "freight": 1, "goodsAmount": 1, "tax": "test", " insuredAmount ": "1", "merchantCommerceCode": "123456", "merchantCommerceName": "test", "storeHouse ": "", "customsCode ": "5208", "ciqCode ": "000067", "functionCode ": " CUS ", "businessType ": " B2C ", "dxpid": "DXPENT0000012084" } ], "hmac": "c44122ac030ec74335fb424b6eaa49ae" }

请求同步返回参数列表

参数名称 参数中文名称 参数说明
merchantId 商户编号 商户在首信易系统的唯一身份标识，商户完成首信易系统注册后可登录商户后台商户服务查看。
paySerialNumber 支付流水号 支付流水号
status 请求状态 SUCCESS:发起成功(不代表报关成功，只能说明报关请求成功提交至首信易系统)
FAILED:发起失败，重新发起
ERROR:请求数据或者请求后系统流程出现问题，根据返回错误进行检查数据或者联系首信易
hmac 参数签名 商户生成的参数签名结果，获取hmac的方法请参考请求加密流程

示例

{ "hmac": "1bcd07ed8f3b8023171dd321048b1bce", "merchantId": "120140257", "paySerialNumber": "a5ff176ec5d140cc859980a41eab0e0a", "status": "SUCCESS" }

订单异步返回参数列表

参数名称 参数中文名称 参数说明
merchantId 商户编号 商户编号
paySerialNumber 支付流水号 支付流水号
customsInfos 报关参数信息 JSON(二维数组)，参数见下表，报关信息
hmac 参数签名 商户生成的参数签名结果，获取hmac的方法请参考请求加密流程

返回参数 （customsInfos，报关信息）

参数名称 参数中文名称 参数说明
customsChannel 报关通道 OFFICAL 直连总署版
amount 报关金额 单位:分，1元=100分
freight 运费 单位:分，1元=100分，如果不填，默认为0
goodsAmount 支付货款 单位:分，1元=100分，如果不填，默认为0
tax 支付税款 单位:分，1元=100分，如果不填，默认为0
status 报关状态 PROCESSING 处理中
SUCCESS 成功
FAILED 失败

示例

{ "customsInfos": [{ "amount": "1", "customsChannel": "GUANGZHOU_OFFICAL", "freight": "1", "goodsAmount": "1", "status": "SUCCESS", "tax": "1" }], "hmac": "05827f07cfb41a72229345fd56ae87b2", "merchantId": "120140257", "paySerialNumber": "095f227843974396adcf72810d488bd5" }