# 获取微信支付反馈投诉图片的签名头部

接口应在服务器端调用,不可在前端(小程序、网页、APP等)直接调用,具体可参考接口调用指南

接口英文名:get_upload_file_sign

本接口用于获取微信支付反馈投诉图片的签名头部

# 1. 调用方式

# HTTPS 调用

POST https://api.weixin.qq.com/xpay/get_upload_file_sign?access_token=ACCESS_TOKEN&pay_sig=PAY_SIG

# 云调用

  • 本接口不支持云调用。

# 第三方调用

  • 本接口支持第三方平台代商家调用。

  • 该接口所属的权限集 id 为:157

  • 服务商获得其中之一权限集授权后,可通过使用 authorizer_access_token 代商家进行调用,具体可查看 第三方调用 说明文档。

# 2. 请求参数

# 查询参数 Query String Parameters

参数名类型必填示例说明
access_tokenstringACCESS_TOKEN接口调用凭证,可使用 access_tokenauthorizer_access_token
pay_sigstring-支付签名

# 请求体 Request Payload

参数名类型必填说明
envnumber0-正式环境 1-沙箱环境(仅作为签名校验,查询的结果都是正式环境的)
wxpay_urlstring微信支付的图片地址格式为"https://api.mch.weixin.qq.com/v3/merchant-service/images/{xxxxxx}"
convert_cosboolean是否转存到cos,转存后可以获得图片的临时下载地址,30分钟有效
complaint_idstring对应的反馈投诉id

# 3. 返回参数

# 返回体 Response Payload

参数名类型说明
errcodenumber错误码
errmsgstring错误信息
signstring返回微信支付图片请求的Authorization头部值,具体使用方法可查看备注
cos_urlstring当convert_cos为true时才有意义,返回转存后的url地址,30分钟有效

# 4. 注意事项

  1. 微信支付的图片资源下载需要在http请求的时候必填以下3个头部信息,否则会报错

    • Authorization,签名验证,由本接口的sign返回
    • Accept,值需要是"application/json"
    • User-Agent,UA不能为空
  2. 使用支付签名

    签名参数为 pay_sig,加在 query 后面

    例如接口地址是:https://api.weixin.qq.com/xpay/query_user_balance?access_token=xxxx

    加上签名后则需要传 https://api.weixin.qq.com/xpay/query_user_balance?access_token=xxxx&pay_sig=xxx

# 5. 代码示例

本接口无代码示例

# 6. 错误码

以下是本接口的错误码列表,其他错误码可参考 通用错误码;调用接口遇到报错,可使用官方提供的 API 诊断工具 辅助定位和分析问题。

错误码错误描述
-1系统错误
268490001openid错误
268490002请求参数字段错误,具体看errmsg
268490003签名错误
268490004重复操作(赠送和代币支付和充值广告金相关接口会返回,表示之前的操作已经成功)
268490005订单已经通过cancel_currency_pay接口退款,不支持再退款
268490006代币的退款/支付操作金额不足
268490007图片或文字存在敏感内容,禁止使用
268490008代币未发布,不允许进行代币操作
268490009用户session_key不存在或已过期,请重新登录
268490011数据生成中,请稍后调用本接口获取
268490012批量任务运行中,请等待完成后才能再次运行
268490013禁止对核销状态的单进行退款
268490014退款操作进行中,稍后可以使用相同参数重试
268490015频率限制
268490016退款的left_fee字段与实际不符,请通过query_order接口查询确认
268490018广告金充值帐户行业 id 不匹配
268490019广告金充值帐户 id已绑定其他 appid
268490020广告金充值帐户主体名称错误
268490021账户未完成进件
268490022广告金充值账户无效
268490023广告金余额不足
268490024广告金充值金额必须大于 0

# 7. 适用范围

本接口暂未明确可调用账号类型,或在业务中根据调用传参自行确定是否可调用,请以实际调用情况为准。