密码确认提交接口

功能概述

本接口用于商户需要钱包帐户支付密码确认场景,如:输入密码后确认收货

接口地址

https://webox-api.5upay.com/webox/payPasswordValidate/create

参数名称 参数中文名称 类型& 长度 参数说明 是否必填
merchantId 商户编号 varchar(9) 商户在首信易系统的唯一身份标识,商户完成首信易系统注册后可登录商户后台商户服务查看。 M
requestId 订单编号 varchar(50) 提交的订单号必须在账户交易中唯一;首信易数据支付系统中对于已创建的订单,商户端不能重复提交。长度小于 50,必须由日期加自定义号组成,例如 20200224******。 M
authType 验证类型 固定值 FACE_SCAN 强制刷脸 , 传强制刷脸时只能唤起刷脸进行确认;不传则是根据用户配置进行唤起相应确认 O
walletId 钱包 ID varchar(19) 用户钱包在我司的唯一编号 M
notifyUrl 通知地址 varchar(200) 提交 成功后首信易支付会向该地址发送五次成功通知,该地址可以带参数,“https://www.5upay.com/Notify.action?test=test 注意:如不填 notifyUrl的参数值验证成功后您的服务器将得不到验证成功的通知。 O
timeout 订单超时时间 Int(4) 此参数用于设置订单的超时时间(只能设置 1-1440)。分钟为单位 O
hmac 参数签名 varchar(500) 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 M

参数示例

{ "merchantId": "890000595", "requestId": "202002251582614048062", "walletId ":"1233345", "notifyUrl": "https://qa-sdk.5upay.com/webox/Notify", "hmac": null }

同步返回参数列表

参数名称 参数中文名称 参数说明
status 响应状态 SUCCESS 响应正常
FAIL 响应异常
orderStatus 订单状态 INIT
merchantId 商户编号 同请求参数
requestId 订单号 同请求参数
walletId 钱包 ID 同请求参数
serialNumber 订单流水号 首信易支付系统订单流水号
token 票据 限制调用移动端权限的。(仅一次)
createDateTime 创建时间 格式:yyyy-MM-dd HH:mm:ss
hmac 参数签名 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程

参数示例

{ "status":"SUCCESS", "orderStatus":"INIT", "merchantId":"890000595", "requestId":"202002251582614048062", "serialNumber":"201911042372723735545584806014976", "token":"20191022221481371367938298683392", "walletId":"11111111" "createDateTime":"2019-10-22 18:43:36", "hmac":"NJ6mmeVuilTlmWC2ps8vFkxJPqyehltp3h92LPutr0PuE+vdt32o7AOqHFozN7I8 3KI5y+CoQy1XE8w3d+xEmClPMwhviIZYRcDUoq4IFI7LjHGtUHpISwDx4/21mjTMyDc6q ISC+6PBBW6iqbGTcv0XZTGRxULhtkxrJ4qk/FlHGwP/5mwKyqOapWHS1nbufHkf5fhR8 BviurnNQHPwhIUXJpbieJGRS+aDvw/zIfG49MhHKESbttHhgGaZmResmxyWUlrDCrYY8 xYnBKhn7Z/ohR2IRz7U8yO8oRQbSj6FU5GOMknFXhbDSIR/FK05TnioDuc5mNTk0Vvs oSsmmg==", }

异步返回参数列表

参数名称 参数中文名称 参数说明
orderStatus 验证状态 SUCCESS 成功
CANCEL 取消
merchantId 商户编号 同请求参数
requestId 订单号 同请求参数
serialNumber 订单流水号 首信易支付系统订单流水号
walletId 钱包 ID 钱包 ID
createDateTime 创建时间 密码确认下单时间, 格式:yyyy-MM-dd HH:mm:ss
completeDateTime 完成时间 密码确认完成时间, 格式:yyyy-MM-dd HH:mm:ss
orderErrorMessage 订单错误信息 只有订单状态出现异常时返回此参数
hmac 参数签名 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程

参数示例

{ "orderStatus":"SUCCESS", "merchantId":"890000595", "requestId":"1571654460635", "serialNumber":"12345678", "walletId":"11111111" "createDateTime":"2019-10-21 18:41:17", "completeDateTime":"2019-10-21 18:51:17", "hmac":"IpsfuWXscJCvcSCMtHbDZIqpFwG+TcvD3tLVbuZGflIbBv7DDigsYARc2h7b6oR Oec/9DKb41CqYWw2E7IegMj+OmDRUZOF6pXgNE8l7sAW+68UKJ4xKOFRCyqmw4H HZaxh7An5Ml/IYI1pfUYyAVSfaQGdnef4CTdkq+JJfBTjB2BED6CE0sCBEtWE7eT/bOYE +Ha1wlVhpbBxRG8/301QK5WtVh8l5whsdqDw+WqqEw5DMoxpBopZfrF8oxqNA/6/Fzb/ ZApUG4rwzRfFXBQaGQHZVe+JFTuOoXfDhPrdqT5Qhm6i2OZindeHx2Q0YoCxMNKu9f YIupX1Vw53Stg==" }