发送扣款预通知

更新时间:2024.09.09

前置条件

签约成功后回调的签约协议号(contract_id

接口功能

给用户发送扣款预通知

接口说明

支持商户:【普通商户】

请求方式:【POST】/v3/edu-papay/user-notifications/{contract_id}/send

请求域名:【主域名】https://api.mch.weixin.qq.com 使用该域名将访问就近的接入点

     【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点 ,指引点击查看

请求参数

Header HTTP头参数

Authorization  必填 string

请参考签名认证生成认证信息


Accept  必填 string

请设置为application/json


Content-Type  必填 string

请设置为application/json


path 路径参数

contract_id  必填 string(32)

【签约协议号】标识用户与某签约模版的一次签约,具有唯一性


body 包体参数

appid  必填 string(32)

【服务商APPID】微信公众平台为商户的应用分配的ID,与服务商商户号存在绑定关系

请求示例

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/edu-papay/user-notifications/wx8888888888888888/send \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" \
5  -H "Content-Type: application/json" \
6  -d '{
7    "appid" : "wx8888888888888888"
8  }'
9

应答参数

无应答包体

应答示例

204 No Content

1'无应答包体'
2

 

错误码

公共错误码

状态码

错误码

描述

解决方案

400

PARAM_ERROR

参数错误

请根据错误提示正确传入参数

400

INVALID_REQUEST

HTTP 请求不符合微信支付 APIv3 接口规则

请参阅 接口规则

401

SIGN_ERROR

验证不通过

请参阅 签名常见问题

500

SYSTEM_ERROR

系统异常,请稍后重试

请稍后重试

业务错误码

状态码

错误码

描述

解决方案

500

SYSTEM_ERROR

系统错误

系统异常,请使用相同参数稍后重新调用

403

NO_AUTH

商户无权限

请开通商户号权限。请联系产品或商务申请

403

NOT_ENOUGH

余额不足

用户账号余额不足,请用户充值或更换支付卡后再支付

429

RATELIMIT_EXCEEDED

频率限制

请降低频率后重试

400

INVALID_REQUEST

请求的业务参数符合参数格式,但不符合业务规则

请使用正确的参数重新调用

401

SIGN_ERROR

签名错误

请检查签名参数和方法是否都符合签名算法要求

400

ALREADY_EXISTS

资源已存在

尝试创建的资源已存在,无需重复创建

404

NOT_FOUND

请求的资源不存在

请商户检查需要查询的ID或者请求URL是否正确

 

 

反馈
咨询
目录
置顶