支付产品
- 付款码支付
- Native支付
- JSAPI支付
- APP支付
- 小程序支付
- H5支付
- 委托代扣
资金类产品
- 分账（发起交易）
- 分账（操作分账）
- 分账（发起退款）
- 分账（账单及资金查询）
其他产品
- 子商户进件
- H5权限申请
- 海关报关

申请解约

更新时间：2025.01.07

商户与用户的签约关系有误或者商户主动要求与用户之前的签约协议时可调用此接口完成解约。

注意：

目前商户侧支持使用委托代扣协议id完成解约。同时，用户可以通过微信客户端发起解约，解约结果将通过“解约回调地址”通知商户侧。商户在申请代扣权限获取模板ID时，需要同时提供“解约回调地址”给到微信支付进行配置，当发生解约关系的时候，微信服务器会向此地址通知解约信息，内容与签约返回一致（详见签约返回）。

1. 接口说明

适用对象：直连模式机构模式

请求URL：https://apihk.mch.weixin.qq.com/v3/global/papay/contracts/{contract_id}/terminate

请求方式：POST

Path 指该参数为路径参数

Query 指该参数为URL参数

Body 指该参数需在请求JSON传参

2. 请求参数

参数名	变量	类型[长度限制]	必填	描述
委托代扣协议ID	contract_id	string[1,64]	是	Path 委托代扣签约成功后由微信返回的委托代扣协议id，选择contract_id查询，则此参数必填示例值：100005698
应用ID	appid	string[1,32]	是	Body 商户号绑定的appid 注意：仅适用于直连模式示例值：wxcbda96de0b165486
服务商应用ID	sp_appid	string[1,32]	是	Body 服务商绑定的appid 注意：仅适用于机构模式示例值：wxcbda96de0b165486
子商户号	sub_mchid	string[1,32]	是	Body 微信支付分配的子商户号注意：仅适用于机构模式示例值：10000097
子商户应用ID	sub_appid	string[1,32]	否	Body 发起签约的子商户号绑定的appid 注意：仅适用于机构模式示例值：wxcbda96de0b165484
解约备注	termination_note	string[1,256]	否	Body 解约原因的备注说明，如：签约信息有误，须重新签约示例值：解约原因

请求示例

场景一：直连模式

1POST
2https://apihk.mch.weixin.qq.com/v3/global/papay/contracts/100005698/terminate
3{
4	"appid": "wxcbda96de0b165486", 
5	"termination_note": "Cause of termination" 
6}

场景二：服务商模式/机构模式

1POST
2https://apihk.mch.weixin.qq.com/v3/global/papay/contracts/100005698/terminate
3{
4	"sp_appid": "wxcbda96de0b165486",
5	"sub_mchid": "10000097",
6	"sub_appid": "wxcbda96de0b165484", 
7	"termination_note": "Cause of termination" 
8}

3. 返回参数

处理成功，应答无内容

返回示例

1204
2处理成功，应答无内容

4. 错误码

状态码	错误码	描述	解决方案
403	CONTRACT_NOT_EXIST	签约协议不存在	请检查签约协议号是否正确,是否已解约
400	PARAM_ERROR	参数错误	请确认参数都正确传入，然后重试
500	SYSTEM_ERROR	系统错误	先查询签约协议状态，再尝试重试