提现预下单接口

功能概述

用户将账户余额提现到自己的银行卡。(只支持个人借记卡)

接口地址

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

参数名称 参数中文名称 类型& 长度 参数说明 是否必填
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) 此参数用于指定提现银行卡 C
notifyUrl 通知地址 varchar(200) 订单终态后首信易支付会向该地址发送通知,该地址可以带参数,“https://www.5upay.com/callback.action?test=test 注意:如不填notifyUrl 的参数值您的服务器将得不到订单终态的通知。 O
returnBackNotifyUrl 退票通知地址 varchar(200) 首信易接收到渠道返回退票通知后,会向该地址发送通知 O
timeout 订单超时时间 Int(4) 此参数用于设置订单的超时时间(只能设置 1-1440)。分钟为单位 O
remark 备注 varchar(300) 商户在首信易为订单进行备注,通过支付结果返回商户 O
hmac 参数签名 varchar(500) 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 M

参数示例

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

同步返回参数列表

参数名称 参数中文名称 参数说明
status 响应状态 SUCCESS 响应正常
FAIL 响应异常
orderStatus 提现状态 INIT 初始化状态
merchantId 商户编号 同请求参数
requestId 订单号 同请求参数
serialNumber 交易流水号 首信易支付系统交易流水号
walletId 钱包 ID 同请求参数
currency 币种 CNY
amount 提现金额 同请求参数
arrivalAmount 实际到账金额 同请求参数
token 票据 通过此参数调起移动端 SDK(仅可使用一次)
remark 备注 在下单请求中提交的备注信息,返回给商户
createDateTime 创建时间 提现预下单时间,格式:yyyy-MM-dd HH:mm:ss
code 错误编码 错误编码
errorMessage 错误信息 错误信息
hmac 参数签名 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程

参数示例

{ "walletId":"3370440012167473", "amount":1, "serialNumber":"121806767670768512", "arrivalAmount":1, "orderStatus":"INIT", "createDateTime":"2020-01-17 15:28:51", "token":"20200117379517402846673950500000", "merchantId":"890000595", "requestId":"202002251582614000000", "hmac":"oQ+r/OEmMEvW5IddymLI1pbZIa5PJMYukPRUVD2bTRAwWhSdGjqYZ7yG3oUeyQ BA==", "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的方法请参考请求加密流程

参数示例

{ "status":"SUCCESS", "transferStatus":"INIT", "merchantId":"890000595", "requestId":"202002251582614000000", "serialNumber":"124456654", " walletId":"111111111", "amount":200, "createDateTime":"2019-10-21 15:54:38", "completeDateTime":"2019-10-21 15:59:38", "hmac":"TfvuXVM1zTslDVvhr7a2mwMl/g/xs7G2sBI48H1u5Q1A6hQxflnpOMI7e37o3WW Ez//ZkdisQ8dTZi5OEoQo2CrIBHqimp4t==" }