支付分订单创建之后，由于某些原因导致订单不能正常支付时，可使用此接口取消订单。

订单为以下状态时可以取消订单：CREATED（已创单）、DOING（进行中）（包括商户完结支付分订单后，且支付分订单收款状态为待支付USER_PAYING）

注意：
• DOING状态包含了订单用户确认、已完结-待支付（USER_PAYING）的状态，因此这种状态下订单也是可以被取消的，请确认当前操作是否正确，防止误操作将完结后需要支付分收款的单据取消。


特别注意：待支付（USER_PAYING）状态下，当用户正在尝试通过收银台主动支付订单金额时，取消支付分订单API无法调用成功，可等待3min后重试

请求方法

参数名 参数描述 类型[长度限制] 必填 备注
method 方法名 string[1,32] 是 SERVICEORDER_CANCEL
requestDate 交易日期 string[1,14] 是 格式[yyyyMMddHHmmss]，
如：20190101140908
version 版本 string[1,16] 是 接口版本：1.0
format 请求格式 string[1,16] 是 业务请求参数格式，支持：JSON
merchantNo 商户号 string[1,16] 是 商户在慧收钱的商户号，由慧收钱生成并下发
signType 加密类型 string[1,16] 是 RSA2:签名机制查看说明
signContent 业务数据 string 是 业务请求参数
sign 签名数据 string[1,128] 否 签名数据

加密参数

参数名 参数描述 类型[长度限制] 必填 备注
transNo 商户订单号 string[1,64] 是 商户系统内部订单号保证不重复
serviceId 服务ID string[1,32] 是 调用该接口提交的服务ID。 示例值：500001
appid 应用ID string[1,32] 是 调用接口提交的公众账号ID。 示例值：wxd678efh567hg6787
reason 取消原因 string[1,30] 是 最多30个字符，每个汉字/数字/英语都按1个字符计算超过长度报错处理。

加密数据模板

{
  "transNo": "2012020347837",
  "serviceId": "500001",
  "appid": "wxd678efh567hg6787",
  "reason": "用户投诉"
}

公共响应参数

变量 参数名 类型[长度限制] 必填 描述
success 响应状态 string[1,32] 是 服务端响应状态，如果为true，则可以调用result；如果为false，则调用errorCode来获取出错信息
errorCode 错误码 string[1,32] 否 响应码
errorMsg 错误描述 string[1,128] 否 响应描述
result 响应内容 string 否 业务响应参数
sign 签名数据 string[1,128] 否 响应验签数据

业务响应参数

参数名 参数描述 类型[长度限制] 必填 备注
transNo 商户订单号 string[1,64] 是 商户系统内部订单号保证不重复
tradeNo 交易订单号 string[1,32] 是 支付平台交易订单号
serviceId 服务ID string[1,32] 是 调用该接口提交的服务ID。 示例值：500001
appid 应用ID string[1,32] 是 调用接口提交的公众账号ID。 示例值：wxd678efh567hg6787
respCode 错误码 string[1,32] 是 详见错误码
respMsg 错误信息 string[1,128] 是 详见错误码

响应格式

{
    "success": true, 
    "result": "88faca1f2511cc194367ffd96aa78a4cdf25a8284b0cd74b75e331b37c642b26aaeb46f2e4be38080eeb2b78575abd715d58fd30bbf59e167d64d0b714487f9462381e499a48524b1704694f256fa8f6e917d33cd413e365872ef2c7eede37ab4b23f67dcf6f34ec0daf65a34502123f792a646bea6447c126a612087825b17b91e585f74e56220328b198982e62a734387cd8556927e6881878b821969b6e784a20771cf55fad70a4368b8650c0ece0a7903678e1ad6134f6c711329a3e3e456c28ffbfc607fa6bf1f969a4d38b35ca3bf9ad81f71b2d2ad816502d579c0c4fc1f1fccec74a861c4679c5217be0176bf1eebcb57aea381f922fcf920aa471198be972f0c4f9fab10f7885b9c09eda977351b40e9058247ec30da55dd4c0be4a9de7d996e186e9f9ff2693f564f0eaddca9d7ff9f3b813d0c70bdba75b2a1bf9bd4ddf28ff66c45d6ce31e188d8606c82078d842008a9a1b4c1b64b7b2d3632087e46bbc4322181a9832cecd852682fdb72d336b32512bde94e81ba322fe9d2d", 
    "errorCode": null, 
    "errorMsg": null
}

密文解密参数

作者：xiaochen  创建时间：2023-05-24 14:41
最后编辑：admin  更新时间：2024-09-19 18:06