报关请求接口

功能概述

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

接口地址

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) GUANGZHOU_OFFICAL广州海关(总署版) M
NINGBO 宁波海关
TIANJIN_OFFICAL 天津海关(总署版)
ZHUHAI_OFFICAL 珠海海关(总署版)
ZHENGZHOU_ZONGBAO_OFFICAL 郑州综保(总署版)
CHONGQING_OFFICAL 重庆海关(总署版)
ZHENGZHOU_WUBAO_OFFICAL 郑州物保(总署版)
OFFICAL 直连总署版
SHENZHEN_OFFICAL 深圳海关(总署版)
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": "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 报关通道 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 失败

示例

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