提现免密（商户直连）

功能概述

用于商户直接替用户发起提现，无需用户输入支付密码。（只支持个人借记卡）

接口地址

https://webox-api.5upay.com/webox/withholding/directSubmit

参数名称	参数中文名称	类型& 长度	参数说明	是否必填
merchantId	商户编号	varchar(9)	商户在首信易系统的唯一 id，可在商户后台查看	M
requestId	订单编号	varchar(50)	提交的订单号必须在账户交易中唯一；首信易数据支付系统中对于已创建的订单，商户端不能重复提交	M
walletId	钱包 ID	varchar(19)	提现发起方钱包账户 ID	M
currency	币种	固定值	CNY 人民币	M
amount	提现金额	varchar(18)	单位：分	M
arrivalAmount	实际到账金额	varchar(18)	单位：分	M
cashierBindCardId	绑卡id	varchar(64)	此参数用于指定提现银行卡	M
notifyUrl	通知地址	varchar(200)	订单终态后首信易支付会向该地址发送通知，该地址可以带参数，“https://www.5upay.com/callback.action?test=test 注意：如不填notifyUrl 的参数值您的服务器将得不到订单终态的通知。	O
returnBackNotifyUrl	退票通知地址	varchar(200)	首信易接收到渠道返回退票通知后，会向该地址发送通知	O
remark	备注	varchar(300)	商户在首信易为订单进行备注，通过支付结果返回商户	O
hmac	参数签名	varchar(500)	商户生成的参数签名结果，获取hmac的方法请参考请求加密流程	M

参数示例

{ "merchantId": "890000595", "requestId": "202002251582614048062", "walletId": "12345678", "currency": "CNY", "amount": "100", "arrivalAmount":"50", "cashierBindCardId":" 202304111722700000", "notifyUrl": "https://demo.5upay.com/sdk", "hmac": null }

同步返回参数列表

参数名称	参数中文名称	参数说明
status	响应状态	SUCCESS 响应正常 FAIL 响应异常
orderStatus	提现状态	PROCESS 打款中 SUCCESS 成功 CANCEL 取消
merchantId	商户编号	同请求参数
requestId	订单号	同请求参数
serialNumber	交易流水号	首信易支付系统交易流水号
walletId	钱包 ID	同请求参数
currency	币种	CNY
amount	提现金额	同请求参数
arrivalAmount	实际到账金额	同请求参数
remark	备注	在下单请求中提交的备注信息，返回给商户
createDateTime	创建时间	提现预下单时间，格式：yyyy-MM-dd HH:mm:ss
code	错误编码	错误编码
errorMessage	错误信息	错误信息
hmac	参数签名	商户生成的参数签名结果，获取hmac的方法请参考请求加密流程

参数示例

{ "walletId":"5200002530000004646", "amount":1, "serialNumber":"1648306918776770560", "arrivalAmount":1, "orderStatus":"PROCESS", "remark":"", "createDateTime":"2023-04-18 20:46:08", "merchantId":"896671189", "requestId":"20234181681821904180", "hmac":"Zgd4zExZ08v7/1dnVKkg1Z+PV0gqU7425kxNFMvpys8FVmhAlULfmbLmqp3JbQqylnBdvyTOy1ZsJyvgb+ZKU0u rUY21EAA+qWjIenojlzFQ3DbiXusOL0HVre+lWw6vmPlnzhL7tbSTFRKfhv9IsIEA==", "currency":"CNY", "status":"SUCCESS" }

异步返回参数列表

参数名称	参数中文名称	参数说明
status	响应状态	SUCCESS 响应正常 FAIL 响应异常
orderStatus	提现状态	SUCCESS 成功 FAIL 失败 CANCEL 取消
merchantId	商户编号	同请求参数
requestId	订单号	同请求参数
serialNumber	交易流水号	首信易支付系统交易流水号
walletId	钱包 ID	同请求参数
amount	提现金额	同请求参数
arrivalAmount	实际到账金额	同请求参数
bankCardNumber	卡号	掩码卡号
bankCode	银行代码	提现目标银行的银行代码
bankName	银行名称	提现目标银行的银行名称
remark	备注	在下单请求中提交的备注信息，返回给商户
createDateTime	创建时间	预下单时间格式：yyyy-MM-dd HH:mm:ss
completeDateTime	完成时间	支付完成时间，格式：yyyy-MM-dd HH:mm:ss
orderErrorMessage	订单错误信息	只有订单状态出现异常时返回此参数
hmac	参数签名	商户生成的参数签名结果，获取hmac的方法请参考请求加密流程

参数示例

{ "bankCode":"CCB", "walletId":"5200003880000003962", "amount":1000, "completeDateTime":"2023-04-18 13:38:54", "serialNumber":"1648199103273902080", "arrivalAmount":700, "bankCardNumber":"622***1126", "orderStatus":"SUCCESS", "bankName":"中国建设银行", "createDateTime":"2023-04-18 13:37:43", "merchantId":"896671260", "requestId":"1681796262845", "hmac":"nYvJyypsUb64PpI5+FAAn9OMfuIaJ5Jyu5ahBmzULijMOGvbAjRpVm3j2ip9afUxHFoZnC8vh511k6j995W0+LpD7J70o eh5613/iq2kpuY4f2s1F2Q0MGCVNSBsDEUeRDErMH897dQDw==", "status":"SUCCESS" }