妥投提交接口

功能概述

妥投确认接口用于商户对支付成功订单，通过应用接口程序，实现提交订单包裹单号和妥投确认状态信息的业务处理。

接口地址

https://apis.5upay.com/icc/delivery

参数名称 参数中文名称 类型& 长度 参数说明 是否必填
merchantId 商户编号 varchar(9) 商户在首信易系统的唯一身份标识，商户完成首信易系统注册后可登录商户后台商户服务查看。 M
requestId 订单号 varchar(50) 不可为空值，为商户提交待付款订单接口所定义的订单编号 M
deliveryId 妥投单号 varchar(50) 不可为空值，为订单编号对应的妥投单编号。长度不超过 50 个字符。 M
hmac 参数签名 varchar(500) 商户生成的参数签名结果，获取hmac的方法请参考请求加密流程 M

参数示例

{ merchantId: ”12333221”, requestId: ”123141512341”, deliveryId: “123245”, hmac：” af2884b7c656d12df6aeb8bc7a8ad5c6” }

请求返回参数列表

注意：当响应处理正常即 status 参数值为 SUCCESS 的情况下，报文才包括商户编号、订单编号等信息。

参数名称 参数中文名称 参数说明
status 响应状态 响应正常 SUCCESS
响应异常 ERROR
merchantId 商户编号 同请求参数的商户编号
requestId 订单号 同请求参数的订单号
deliveryId 妥投单号 同请求参数的妥投单号
deliveryStatus 妥投结果状态 妥投操作结果状态。可能值包括
SUCCESS 操作成功
FAILED 操作失败
hmac 参数签名 商户生成的参数签名结果，获取hmac的方法请参考请求加密流程

参数示例

{ merchantId: ”12333221”, requestId: ”123141512341”, deliveryId: ”12565841”, deliveryIStatus：" SUCCESS ", hmac：”af291df5d288690d2b7d7bcff7dc5a74447ce1502c1edcc9293051bb6 a517d686fbb31de72bfd14938d474fa6dd0afb82a2c222a6a345e41683d456a1 42e3376c5c8f07dc5bc92dd5b09af316fa478a003189ed4d4c956d33162de11a 8aec8ab6abcf66b19833302780cffaa25c7e40bb9b2ccc59adc44e3fcb4632bce 5d9cf9” }