对账单查询
POST
http://crm.houcaller.com/ysPayController/queryStatement
请求头
参数名
类型
描述
必填
strParams
String
加密后的参数 参考加密方法 参考请求DEMO
必填
请求参数
参数名
类型
描述
必填
merchantsName
String
商户名称
可选
mid
String
商户号
可选
branchName
String
分店名称
可选
tid
String
终端号
可选
payName
String
支付方式
可选
tradeType
String
交易类型
可选
payNo
String
交易参考号
可选
orderNo
String
商户订单号
可选
settlementMid
String
结算商户号
可选
returdNo
String
退货订单号
可选
cardNo
String
卡号
可选
beginTime
String
开始时间
可选
endTime
String
结束时间
可选
start
String
分页下标
必填
length
String
分页下标
必填
请求示例
响应数据
参数名
类型
注释
描述
bank
string
发卡行
示例：微信钱包
branchName
string
分店名称
示例：厦门宅小牛科技服务有限公司
cardNo
string
卡号
示例：000000******0000
id
string
主键
示例：2c926045834465b4018345bdb3630017
liquidationAmount
string
清算金额
示例：498.90
liquidationDate
string
清算日期(/)
示例：2022/09/15
merchantsName
string
商户名称
示例：厦门宅小牛科技服务有限公司
mid
string
商户号
示例：89835065812APRE
orderNo
string
商户订单号
示例：146AEU220915115400P3T6S5OZ
payDate
string
交易日期(-)
示例：2022-09-15
payDetailTime
string
交易时间(:)
示例：11:54:07
payName
string
支付方式
示例：微信
payNo
string
交易参考号
示例：29622753368N
payTime
int
添加时间
示例：1663214047000
settlementMid
string
结算商户号
示例：89835065812APRE
settlementTime
string
清算日期
示例：20220915
tid
string
终端号
示例：UEN7NT67
tradeAmount
string
交易金额
示例：500.00
tradePoundage
string
交易手续费
示例：1.10
tradeTime
string
交易时间
示例：20220915115407
tradeType
string
交易类型
示例：消费
返回示例
订单状态码
参数名
描述
NEW_ORDER
新订单
UNKNOWN
不明确的交易状态
TRADE_CLOSED
在指定时间段内未支付时关闭的交易；在交易完成全额退款成功时关闭的交易；支付失败的交易。 TRADE_CLOSED的交易不允许进行任何操作。
WAIT_BUYER_PAY
交易创建，等待买家付款。
TRADE_SUCCESS
支付成功
TRADE_REFUND
订单转入退货流程
平台错误码
参数名
描述
原因和应对措施
SUCCESS
成功
INTERNAL_ERROR
内部错误
系统错误，请联系技术支持。
BAD_REQUEST
请求报文有错
报文格式有错误，请对照文档检查报文格式。
NO_SERVICE
没有能处理请求msgtype的服务
msgType错误，请检查文档，msgType是否拼写正确。
TIMEOUT
处理超时
处理超时，很可能是微信和支付宝的网络请求没应答，建议重试或者撤销交易。
NO_ORDER
找不到请求的原始订单
对应的mid+merOrderId不正确，无法找到原交易，请检查merOrderId是否跟原交易一致。
OPERATION_NOT_ALLOWED
当前不允许此操作
订单已经关闭，不能执行退货等操作。
TARGET_FAIL
支付宝方支付失败，如请求没有成功，或者请求成功，但是没有正确处理。
支付宝或者微信方业务失败，请根据返回信息确定具体原因。
DUP_ORDER
重复的订单请求
支付请求的merOrderId重复，请检查终端是否做过复位操作，导致流水号等重复。
NET_ERROR
跟支付包通讯出问题，包括请求发送异常，报文应答不是200，请求被取消，应答超时等。
通讯问题，联系运行检查网络情况。
NO_MERCHANT
找不到请求指定的商户
请求报文的mid在网付前置无法找到相关的配置，请确认终端的商户号是否正确在网付前置配置，是否经过转商户处理。
ORDER_PROCESSING
订单正在处理中，不允许并发操作。
当前订单的上一次操作没有完成，订单处于锁定状态，请等待一分钟后再试。
INACTIVE_MERCHANT
商户被置为inactive状态
交易商户在网付前置被冻结。
ABNORMAL_REQUEST_TIME
请求时间异常
请求终端或者平台的系统时间不正常，请检查系统时间。
TXN_DISCARDED
请求开始处理时间延迟过大，交易被丢弃。
系统负载过大，交易被丢弃，请联系运行。
BAD_SIGN
签名错误
报文签名错误，请联系技术指导签名算法。
INVALID_MSGSRC
商户来源错误
系统配置有问题，请联系技术。
INVALID_ORDER
订单信息异常
该订单支付时有异常，缺少关键数据，请先做一笔订单查询，补充关键数据后再次进行退货等操作。
NO_CROSS_DAY_TRADING
不允许跨日交易
可能某些渠道不支持跨日撤销，建议做退货。
DENIED_IP
不允许此IP交易
IP不在白名单中，请联系管理员确认。
INVLID_MERCHANT_CONFIG
错误的商户配置
商户配置参数有问题，请联系业务人员检查商户配置参数。
INVALID_RESPONSE
无效的应答报文
支付渠道方的应答报文有问题，比如验签失败、报文格式错误等。