企业微信(WeCom)-基础 icon

企业微信(WeCom)-基础

企业微信基础功能 - 通讯录、应用消息、群聊、消息推送、企业互联、素材、系统、电子发票、第三方应用授权、接口调用许可、收银台、对外收款、小程序对外收款、企业红包/向员工付款、数据与智能专区、会话内容存档、推广二维码、账号ID、安全管理

Actions248

企业红包与向员工付款 → [兼容旧商户·企业红包] 发放企业红包

AI-generated

Summary

发放一笔旧版企业微信红包，使用商户支付凭证通过 XML 接口提交。配置唯一商户订单号、收款人 OpenID、分金额、祝福语、项目名称和备注；可选指定发送应用或发送者名称、场景 ID、发送者头像素材 ID及额外 XML 字段。此操作会实际转出资金，超时或系统错误时应使用原订单号查询或重试。

Inputs

  • credentials (required) — 配置企业微信商户支付凭证，包含商户号、密钥与证书。旧版接口对新创建的企业微信可能不可用。
  • mch_billno (required) — 唯一商户订单号，最多 28 个字符；出现超时或系统错误时复用原单号。
  • re_openid (required) — 收款人的企业微信 OpenID，最多 32 个字符。
  • total_amount (required) — 红包金额，单位为分，至少 1；默认值为 100。
  • wishing (required) — 红包祝福语，最多 128 个字符，默认“恭喜发财”。
  • act_name (required) — 红包项目名称，最多 32 个字符。
  • remark (required) — 红包备注，最多 256 个字符。
  • agentid — 可选应用 AgentID，最多 20 个字符。以应用名义发送时填写；与发送者名称二选一，留空时使用凭证中的默认应用。
  • sender_name — 可选发送者名称，最多 128 个字符。以个人名义发送时填写；与应用 AgentID 二选一。
  • scene_id — 可选红包场景，例如商品促销、抽奖或企业内部福利。属性说明指出金额大于 200 元或小于 1 元时必填。
  • sender_header_media_id — 可选发送者头像素材 media_id，最多 128 个字符。
  • extraXmlFields — 可选额外业务字段 JSON，默认空对象；仅接受安全 XML 字段名及字符串或数字值，表单核心字段优先。

Output shape

每个输入项对应一次商户 XML API 请求的结果记录。

会实际发放资金。若请求超时或发生系统错误，使用原商户订单号查询或重试，避免更换订单号导致重复发放。

Links

Discussion