报关查询接口

功能概述

本接口用于商户查询报关状态

接口地址

https://apis.5upay.com/customs/query

参数名称 参数中文名称 类型& 长度 参数说明 是否必填
merchantId 商户编号 varchar(20) 商户在首信易系统的唯一身份标识,商户完成首信易系统注册后可登录商户后台商户服务查看 M
paySerialNumber 支付流水号 varchar(32) 支付流水号 M
hmac 参数签名 varchar(500) 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 M

参数示例

{ "merchantId": "100000050", "requestId": "095f227843974396adcf72810d488bd5", "hmac":"095f227843974396adcf72810d488bd5" }

查询返回参数列表

参数名称 参数中文名称 参数说明
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" }