接口说明

接口名称 cancel_contract
是否幂等 否
接口模式 直连
异步通知 否

应用场景

用于商户发起解除签约关系。

注意事项

接口参数

  • 请求参数：
字段名 变量名 必填 类型 示例值 描述
代理商商户号 agentMerId 否 S(16) 100000 宝付支付分配的商户号
代理商终端号 agentTerId 否 S(16) 100000 宝付支付分配的终端号
交易商户号 merId 是 S(16) 123456987 宝付支付分配的商户号
交易终端号 terId 是 S(16) 123456789 宝付支付分配的终端号
商户订单号 outTradeNo 是 S(32) 1234323JKHDFE1243252 商户系统内部服务订单号，要求32个字符内，且在同一个商户号下唯一。
注：解约需要生成新的订单号，与签约的订单号不能重复。建议使用不同的生成规则，避免重复。
交易时间 txnTime 是 T 20210315155012 订单交易时间
签约模板ID planId 是 S(32) 1234323JKHDFE1243252 签约模板ID，与接入产品对应，入网时生成
签约协议ID contractId 是 S(32) 1234323JKHDFE1243252 签约接口返回的token
请求渠道参数 reqExtend 是 C 请求渠道参数，字段详细说明参考下文
请求渠道参数：reqExtend。
业务扩展参数 bizExtend 否 C 预留字段

请求渠道参数：reqExtend

字段名 变量名 必填 类型 示例值 描述
二级商户代码 subMerId 否 S(15) SUB464887 商户类型为平台类商户接入时必须上送
二级商户全称 subMerName 否 S(40) 白云科技有限公司 商户类型为平台类商户接入时必须上送
二级商户简称 subMerAbbr 否 S(16) 白云科技 商户类型为平台类商户接入时必须上送
  • 返回参数
字段名 变量名 必填 类型 示例值 描述
代理商商户号 agentMerId 否 S(16) 100000 宝付支付分配的商户号
代理商终端号 agentTerId 否 S(16) 100000 宝付支付分配的终端号
交易商户号 merId 是 S(16) 123456987 宝付支付分配的商户号
交易终端号 terId 是 S(16) 123456789 宝付支付分配的终端号
商户订单号 outTradeNo 是 S(32) 1234323JKHDFE1243252 调用接口传入的商户订单号
宝付交易号 tradeNo 否 S(32) 230904111102220002521469 与商户订单号对应的宝付侧唯一交易号
订单状态 orderState 是 E SUCCESS 详见：订单状态-云闪付签约状态
业务扩展参数 bizExtend 否 C 预留字段，返回Json格式
业务结果 resultCode 是 S(16) SUCCESS 业务处理结果
错误代码 errCode 否 S(32) SYSTEM_BUSY 当业务结果FAIL时，返回错误代码
错误描述 errMsg 否 S(128) 系统繁忙，请稍后再试 当业务结果为FAIL时，返回错误描述
作者：xiaofeng  创建时间：2025-03-25 15:22
最后编辑：xiaofeng  更新时间：2025-06-05 10:43