文档
测试

订单关闭

POST
http://crm.houcaller.com/ysPayController/ysClose

请求头

参数名
类型
描述
必填
strParams
String
加密后的参数 参考加密方法 参考请求DEMO
必填

请求参数

参数名
类型
描述
必填
posId
String
机构ID
必填
merOrderId
String
商户订单号
必填

请求示例

加密前:{ "merOrderId":"EU220919200542WN4IDCQK", "posId":"HKL0005" } 加密后: 7CD0146BD15816A010F9F3CACC04F49E0DF4D24A40348A274226615466C975DA046426016C7E09BA4C835562F27FE503B1F50E81BF0CC4C18285DA58307F50BB5C2D19C9ECC04A5B1A320824CCE0EDF028F3DCD79F4AB320

响应数据

参数名
注释
描述
connectSys
链接系统
示例:UNIONPAY
delegatedFlag
标识
示例:N
merName
商户名称
示例:厦门宅小牛科技服务有限公司
mid
商户号
示例:89835065812APRE
settleDate
结算时间
示例:2022-10-26
settleRefId
清分ID
示例:30374965478N
tid
终端号
示例:UEN7NT67
totalAmount
支付总金额
示例:1
targetMid
支付渠道商户号
示例:527237510
responseTimestamp
报文响应时间
示例:2022-10-26 09:43:01
errCode
平台错误代码
示例:SUCCESS
targetStatus
目标平台的状态
示例:SUCCESS|SUCCESS
seqId
平台流水号
示例:30374965478N
merOrderId
商户订单号
示例:146AEU221026094202YW982FRO
status
交易状态
示例:TRADE_CLOSED
targetSys
目标平台代码
示例:WXPay

返回示例

{ "connectSys":"UNIONPAY", "delegatedFlag":"N", "merName":"厦门宅小牛科技服务有限公司", "mid":"89835065812APRE", "settleDate":"2022-10-26", "settleRefId":"30374965478N", "tid":"UEN7NT67", "totalAmount":1, "targetMid":"527237510", "responseTimestamp":"2022-10-26 09:43:01", "errCode":"SUCCESS", "targetStatus":"SUCCESS|SUCCESS", "seqId":"30374965478N", "merOrderId":"146AEU221026094202YW982FRO", "status":"TRADE_CLOSED", "targetSys":"WXPay" }

订单状态码

参数名
描述
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
无效的应答报文
支付渠道方的应答报文有问题,比如验签失败、报文格式错误等。