转账预下单接口

功能概述

用户使用账户余额或绑定银行卡向该商户下另一个钱包账户进行转账。

接口地址

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

参数名称 参数中文名称 类型& 长度 参数说明 是否必填
merchantId 商户编号 varchar(9) 商户在首信易系统的唯一身份标识,商户完成首信易系统注册后可登录商户后台商户服务查看。 M
requestId 订单编号 varchar(50) 提交的订单号必须在账户交易中唯一;首信易数据支付系统中对于已创建的订单,商户端不能重复提交。长度小于 50,必须由日期加自定义号组成,例如 20200224******。 M
walletId 钱包 ID varchar(19) 转账发起钱包账户 ID M
amount 转账金额 varchar(18) 单位:分 M
currency 币种 varchar(15) CNY 人民币 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 交易流水号 首信易支付系统交易流水号
currency 币种 默认:CNY
walletId 钱包 ID 同请求参数
token 票据 限制调用移动端权限的。(仅一次)
amount 转账金额 同请求参数
remark 备注 在下单请求中提交的备注信息,返回给商户
createDateTime 创建时间 预下单时间,格式:yyyy-MM-dd HH:mm:ss
hmac 参数签名 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程

参数示例

{ "walletId":"33704400121565473", "amount":1, "serialNumber":"1218075402340130816", "orderStatus":"INIT", "targetWalletId":"3370440012184656", "createDateTime":"2020-01-17 15:21:24", "token":"20200117585052402844799193141248", "merchantId":"890000595", "requestId":"202002251582614048062", "hmac":"shXC915f6jQGiac38+MgyWnDBqpmUyuO/aF4/qG87Mno9rPGPJDEPENWYYRmnkf WeL2IQcdflHBrO1YCxRio6XF8ittC47PnijK9K/WOdSGGjPxMQPStvTWWQG56Z7M9unSSie w4qsmZA3L25ZjVpq3jsyQ5uAgUWuYArFHhQ6eEk3f4/EJrwSZfArwnufT8Bmg9yN46bdQ6Ds I/voUixAG5h9BG/SgSwm0qKVVMaFpHjk7xRSoDAXihvqQqjGsxjbPrJSv8nhhSsXaSkqviHYvc tyVAzeATXBhSWH6glF/LbDW3oZbzzOdvioIBgPSBPzkT9qmNytd7G2Hqhd0FsQ==", "currency":"CNY", "status":"SUCCESS" }

异步返回参数列表

参数名称 参数中文名称 参数说明
orderStatus 转账状态 SUCCESS 转账成功,收款方已经确认
SEND 已发送
REJECT 拒收,收款方主动拒收
TIMEOUT 超时,超过 24 小时未领取或拒收,订单原金额退还
FAIL 失败,付款前失败
CANCEL 取消,没有支付,24 小时后变取消
merchantId 商户编号 同请求参数
requestId 订单号 同请求参数
serialNumber 交易流水号 首信易支付系统交易流水号
walletId 钱包 ID 同请求参数
amount 转账金额 同请求参数
paymentType 支付方式 BALANCE 余额支付
BANK_CARD 银行卡支付
createDateTime 创建时间 预下单时间 格式:yyyy-MM-dd HH:mm:ss
debitDateTime 支付完成时间 支付完成时间,格式:yyyy-MM-dd HH:mm:ss
refundType 退回方式 BALANCE 余额退回
BANK_CARD 银行卡退回
refundAmount 退回金额 退回金额
bankCardNumber 卡号 掩码卡号,支付方式为银行卡时,返回此参数
bankCode 银行代码 支付方式为银行卡时,返回此参数
bankName 银行名称 支付方式为银行卡时,返回此参数
remark 备注 在下单请求中提交的备注信息,返回给商户
completeDateTime 完成时间 转账确认、拒收或退回时间, 格式:yyyy-MM-dd HH:mm:ss
orderErrorMessage 订单错误信息 只有订单状态出现异常时返回此参数
hmac 参数签名 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程

参数示例

{ "status":"SUCCESS", "transferStatus":"INIT", "merchantId":"890000595", "requestId":"202002251582614048062", "serialNumber":"12446567456654", " walletId":"111111111", "amount":200, "paymentType":"BALANCE", "createDateTime":"2019-10-21 15:54:38", "paymentTime":"2019-10-21 15:58: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 ==" }