服务商代开发
基础
数据与智能专区
应用接收专区通知
连接微信
客户联系
办公
服务商代开发
服务端API
接口调用许可
订单管理
使用余额支付订单
使用余额支付订单
最后更新:2024/05/28

目录

  • 提交余额支付订单任务
  • 获取订单支付结果
  • 可以调用以下接口以使用充值账户余额进行订单支付,详情见 充值功能指引
    可以支付的订单包括单企业购买单企业续期多企业购买创建的订单,支付成功后自动扣款,且服务商可接收到支付成功的回调。

    提交余额支付订单任务

    使用该接口创建支付任务,该接口默认使用充值账户余额进行支付。提交成功后,该订单无法再变更支付方式

    提交支付任务成功后,支付任务异步进行,服务商还需要调用“获取订单支付结果”以获取支付的最终结果

    请求方式: POST(HTTPS
    请求地址: https://qyapi.weixin.qq.com/cgi-bin/license/submit_pay_job?provider_access_token=ACCESS_TOKEN

    请求包体:

    {
    	"payer_userid": "USERID",
    	"order_id": "ORDERID"
    }

    参数说明:

    参数是否必须说明
    provider_access_token应用服务商的接口调用凭证,获取方法参见服务商的凭证
    payer_userid支付人,服务商企业内成员的明文userid,用于充值账户的流水记录。该userid必须登录过企业微信,并且企业微信已绑定微信,且必须为服务商企业内具有“购买接口许可”权限的管理员。
    order_id要使用充值账户余额支付的接口许可订单id

    返回结果:

    {
    	"errcode": 0,
    	"errmsg": "ok",
    	"jobid": "JOBID"
    }

    参数说明:

    参数说明
    errcode错误码
    errmsg错误码说明
    jobid支付任务的jobid

    获取订单支付结果

    使用该接口获取余额订单支付任务的执行结果。仅在提交了 “余额支付订单任务” 后的7天内可获取 。

    请求方式: POST(HTTPS
    请求地址: https://qyapi.weixin.qq.com/cgi-bin/license/pay_job_result?provider_access_token=ACCESS_TOKEN

    请求包体:

    {
    	"jobid": "JOBID"
    }

    参数说明:

    参数是否必须说明
    provider_access_token应用服务商的接口调用凭证,获取方法参见服务商的凭证
    jobid“提交余额支付订单任务” 返回的jobid

    返回结果:

    {
    	"errcode": 0,
    	"errmsg": "ok",
    	"status": 3,
    	"pay_job_result": {
    		"errcode": 700001,
    		"errmsg": "xxx",
    		"fail_corp_list": [{
    			"corpid": "wwxxx",
    			"errcode": 700002,
    			"errmsg": "xxx"
    		}]
    	}
    }

    参数说明:

    参数说明
    errcode错误码,表示接口调用是否成功(而非支付是否成功)。
    如:支付失败时,该错误码会返回0。
    errmsg错误码说明
    status支付任务结果。
    1:支付成功
    2:支付任务执行中,稍后再试
    3:支付失败
    pay_job_result支付结果的信息,仅在支付失败时返回,详见PayJobResult

    PayJobResult 说明

    参数说明
    errcode支付失败原因的错误码,可能包含账户原因和企业原因,可能的错误码见 pay_job_result.errcode说明
    errmsg支付失败原因的错误码描述
    fail_corp_list当支付失败原因属于企业原因时长度非0,单企业下单时列表长度为1,详见FailCorp

    FailCorp 说明

    参数说明
    corpid企业corpid
    errcode本企业支付失败原因的错误码,可能的错误码见 pay_job_result.errcode说明
    errmsg本企业支付失败原因的错误码说明

     

    pay_job_result.errcode说明

    错误码说明分类
    701160存在未通过支付检查的企业企业原因
    90432充值账户未开通账户原因
    90433账户余额不足账户原因
    701161订单已经指定使用微信网银支付账户原因
    48001支付人无权限其他原因
    701005无效的接口许可订单id其他原因
    701084订单不是待支付状态其他原因
    701147部分订单超过了单比支付金额上限其他原因

    fail_corp_list.errcode说明

    错误码说明
    701129企业下无服务商的应用订单
    701130企业下服务商应用订单均已过期

     

    上一篇获取多企业订单详情
    下一篇激活账号
      本节内容
    服务端API
    基础
    数据与智能专区
    应用接收专区通知
    连接微信
    客户联系
    办公
    客户端API
    小程序
    基础
    连接微信
    办公
    WECOM-JSSDK
    JS-SDK
    基础
    连接微信
    办公
    更新日志
    联系我们