交易记录接口

功能概述

此接口用于查询钱包账户的每月交易记录。

备注:在使用此接口前请使用交易记录统计接口查询判断所查月份是否有交易记录,有交易记录方可调用此接口查询该月数据。

接口地址

https://webox-api.5upay.com/webox/tradeRecord/bill

参数名称 参数中文名称 类型& 长度 参数说明 是否必填
merchantId 商户编号 varchar(9) 商户在首信易系统的唯一 id,可在商户后台查看 M
requestId 订单号 varchar(50) 包括红包,充值,转账订单号等,不是自定义号 O
walletId 钱包 ID varchar(19) 用户钱包在我司的唯一编号 M
pageIndex 当前页数 varchar(20) 当前页数,初始值为 1 M
pageSize 每页的条数 varchar(20) 如果为空 默认 20 条,最大 100 条 O
direction 资金方向 固定值 INCREASE 增加(入账) O
DECREASE 减少(出账)
如果不选,默认包括所有资金方向
tradeType 交易类型 固定值 WEBOX_RECHARGE 充值 O
WEBOX_TRANSFER 转账
WEBOX_TRANSFER_REFUND 转账退款
WEBOX_WITHHOLDING 提现
WEBOX_REDPACKET 红包
WEBOX_REDPACKET_ONE_TO_ONE 一对一红包
WEBOX_REDPACKET_GROUP_NORMAL 普通群红包
WEBOX_REDPACKET_GROUP_LUCK 拼手气红包
WEBOX_REDPACKET_REFUND红包退款
WEBOX_MERCHANT_RECHARGE 企业付款
WEBOX_APP_PAY 支付
WEBOX_APP_PAY_REFUND 支付退款
SPLIT_PAYMENT 分账
SPLIT_REFUND_PAYMENT 分账退款
如果不选,默认包括所有交易类型
queryMonth 查询月份 varchar(20) 格式:yyyy-MM 例如:2020-05 M
hmac 参数签名 varchar(500) 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 M

参数示例

{ "direction": "DECREASE", "hmac": "rwKxuVg1qFrlNRE0aZA671wsmpTFV1Uye3jXLkxI5m8Kv4cUhIFzBJ/KP/iNQnI0CDSqZ9av/ qEdrf+0CW5eE5U2+YISUs3pT7biGBj+CqOuz6gnuLcWualUi5w6RZRgnuvjkYwCdIuL1Vq3eL r3wcLmS6PwyHMWBrwJZ91BVmbCUy0AjNtnvfYLmL6pxg34YpxZNqmBEzfm5kOXR8ami4 9vnfCt3X2BP646arodukJkTUa+u+BO9WK3F0t0FXxr/l+rnvIMpDWCd961Oeggl+YMDF5owZ 3Xg9LKygeIDeDCg5SCC/N5aYPqI81xqrcsX5Ax62dn2pUWzhNCMlrfbQ==", "merchantId": "896668917", "pageIndex": "1", "pageSize": "20", "queryMonth": "2020-06", "requestId": "1591070050577", "tradeType": "WEBOX_REDPACKET", "walletId": "10000000000012939" }

同步返回参数列表

参数名称 参数中文名称 参数说明
status 响应状态 SUCCESS 响应正常
FAIL 响应异常
direction 资金方向 同请求参数
tradeType 交易类型 同请求参数
merchantId 商户编号 同请求参数
requestId 订单号 同请求参数
walletId 钱包 ID 同请求参数
queryMonth 查询月份 同请求参数
total 查询当前结果条数 查询当前结果条数
pageSize 每页的条数 同请求参数
pageIndex 当前页数 同请求参数
records 记录列表 见下表(记录列表)
hmac 参数签名 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程

记录列表(records)

参数名称 参数中文名称 参数说明
direction 资金方向 INCREASE 增加(入账),包括充值,转账接收,转账拒收、转账超时、红包超时和红包领取。DECREASE 减少(出账),包括提现,转账和发红包。
tradeType 交易类型 WEBOX_RECHARGE 充值
WEBOX_TRANSFER 转账
WEBOX_TRANSFER_REFUND 转账退款
WEBOX_WITHHOLDING 提现
WEBOX_REDPACKET 红包
WEBOX_ONE_TO_ONE 一对一红包
WEBOX_GROUP_NORMAL 普通群红包
WEBOX_GROUP_LUCK 拼手气红包
WEBOX_REDPACKET_REFUND 红包退款
WEBOX_MERCHANT_RECHARGE 企业付款
WEBOX_APP_PAY 支付
WEBOX_APP_PAY_REFUND 支付退款
SPLIT_PAYMENT 分账
SPLIT_REFUND_PAYMENT 分账退款
tradeRecordId 交易记录 ID 交易记录唯一值,用于查看交易详情和删除
requestId 订单号 预下单订单号或抢红包订单号
serialNumber 交易流水号 预下单交易流水号或抢红包交易流水号
orderStatus 订单状态 SUCCESS 成功
SEND 已发送
TIMEOUT 超时退款
REJECT 拒收
currency 币种 预下单币种
amount 金额 预下单金额
createDateTime 创建时间 订单预下单的时间,或退款发起时间 格式:yyyy-MM-dd HH:mm:ss
completeDateTime 支付完成时间 订单支付完成的时间,或领取时间 格式:yyyy-MM-dd HH:mm:ss
summary 摘要 订单支付,返回商品摘要,其他返回中文交易类型

参数示例

{ "direction": "DECREASE", "hmac": "nwVmIWbJZxtOq6XQq8EKsxJi8o02V6Kjz9+aViwsP6qEpt0IfH6MiVg79vLHYU1qLQR8e ggEaRFFuW7JA9JWKN/6gLGS16OEmDo44P73PX8p0v4ZcC51UlxjpFP43t6+Sxp9DO2 soP9BnzPghPkBZciXCM2iUwvtpJnuclJRVhbbLZkCikrJ3w3TstCl8XHdou6T45MNgwlYb maerh59Rt7ICHyl3LIr3a4mXTnHn7SSfp6GFyCc/xi6f+OYUULg49qP9UQ6D8soHcUVXZ ZwADrisaULp16xmHC+bcNVbLneB4ULZ9uptIWKxCtekzx/MDpJ4ruv9IL3bS1KuwzhkQ= =", "merchantId": "896668917", "pageIndex": "1", "pageSize": "20", "queryMonth": "2020-06", "records": [{ "amount": 1300, "completeDateTime": "2020-06-02 11:54:22", "currency": "CNY", "direction": "DECREASE", "requestId": "1591070050577", "serialNumber": "1267665785615163392", "status": "TIMEOUT", "tradeRecordId": "126766578561516339210000000000012939DECREASE", "tradeType": "WEBOX_GROUP_LUCK" }], "requestId": "1591070050577", "status": "SUCCESS", "total": "1", "tradeType": "WEBOX_REDPACKET", "walletId": "10000000000012939" }