充值预下单接口

功能概述

用户使用银行卡向账户中充值金额。(只支持个人借记卡)

接口地址

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

参数名称 参数中文名称 类型& 长度 参数说明 是否必填
merchantId 商户编号 varchar(9) 商户在首信易系统的唯一 id,可在商户后台查看 M
requestId 订单号 varchar(50) 提交的订单号必须在账户交易中唯一;首信易数据支付系统中对于已创建的订单,商户端不能重复提交。 M
walletId 钱包 ID varchar(19) 用户钱包在我司的唯一编号 M
currency 币种 varchar(15) CNY 人民币 M
amount 充值金额 varchar(18) 单位:分 M
notifyUrl 通知地址 varchar(200) 订单终态后首信易支付会向该地址发送通知,该地址可以带参数,“https://www.5upay.com/callback.action?test=test 注意:如不填notifyUrl 的参数值您的服务器将得不到订单终态的通知。 O
timeout 订单超时时间 Int(4) 此参数用于设置订单的超时时间(只能设置 1-1440)。分钟为单位 O
remark 备注 varchar(300) 商户在首信易为订单进行备注,通过支付结果返回商户 O
hmac 参数签名 varchar(500) 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 M

参数示例

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

同步返回参数列表

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

参数示例

{ "walletId":"33704400121811678", "amount":1, "serialNumber":"1218056647844558848", "merchantId":"890000595", "requestId":"202002251582614048062", "hmac":"ScDMU1beriu/NfUZqM3sMYWpUrE+YHWZkSe/figoCmImKDEvsx23UKvuGd0iVA6 TakKywoiCyyheOd8jx+QS93+qmd2NZofc2qGOtXiENUuKSE6JggxYfhM5HXvYGOPK4CRIe mSk9G3QSCO5qaazaXmIW9axFcjUqlL9q8ZNzrtjogLtLfLLvnNRCuAPj3un42Bi0OgAnUH82b X2S1j3CFbZj/t3RBY/UVpS2L0Yawhinmfnniv/NOHX3EBYo98ReRmzSI297P75Zy0sn//2zuPQ0 iy9ZBrJZMUQdYP++oOQaBOLqzmycwgsBJqMILvu1SEUkSKCNGXN983OEvrecA==", "orderStatus":"INIT", "currency":"CNY", "createDateTime":"2020-01-17 14:28:44", "status":"SUCCESS", "token":"20200117894624402831544806629376" }

异步返回参数列表

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

参数示例

{ "status":"SUCCESS", "orderStatus":"INIT", "merchantId":"890000595", "requestId":"202002251582614048062", "serialNumber":"124456654", "walletId": "111111111", "currency":"CNY", "amount":200, "createDateTime":"2019-10-21 15:54:38", "completeDateTime":"2019-10-21 15:59:38", "hmac":"TfvuXVM1zTslDVvhr7a2mwMl/g/xs7G2sBI48H1u5Q1A6hQxflnpOMI7e37o3WW +rKMQknkhXJeXhfOqW2cSkcmC3xX9vyUAoi3QnTjO6USotMSxFzWRTHR/4K7dLiuvZE v5DftJJc9AEiDrzHkqQNRt9plwIeUSr0I66ShivITggipOm3/+y1VQheanwUvUoQQGUC2sF Z/LtHGmfd7zL+UGsrlrpRT1mO8HCbhD/FOMtlu+uHJVFtRfQAy7F2hbicBqcUJf0qnpn86a Ez//ZkdisQ8dTZi5OEoQo2CrIBHqimp4tgBOw+5CBqLUt/TpIZJUyfcEGaWoH0u7dBoAjw ==" }