你可以请求一个 transfer 对象向个人用户或企业账户发起微信(仅支持向个人用户的零钱或银行卡转账)、支付宝或者银行卡的转账。所有与企业付款相关的要素信息都存储在 transfer 对象之中,你可以通过发起企业付款请求创建新的 transfer 对象,也可以随时查看企业付款对象的状态。每个 transfer 对象都拥有一个标识 id,该 id 在系统内唯一。
注:微信企业付款区分"企业付款到零钱"和"企业付款到银行卡",使用此功能时请确保在微信处开通相应产品。此外,使用微信服务商模式商户暂不支持企业付款。
| 属性 | 描述 | 
|---|---|
| id string | 企业付款对象 id,由 Ping++ 生成,27 位长度字符串。 | 
| object string | 值为 "transfer"。 | 
| type string | 付款类型,转账到个人用户为 b2c,转账到企业用户为 b2b(wx、wx_pub、wx_lite 和 balance 渠道的企业付款,仅支持 b2c)。 | 
| created timestamp | 创建时间,用 Unix 时间戳表示。 | 
| time_transferred timestamp | 支付完成时间, 用 Unix 时间戳表示。由第三方支付渠道返回。 | 
| livemode boolean | 是否是 live模式。 | 
| status string | 付款状态。目前支持 8 种状态:accepted: 转账已受理;pending: 处理中; paid: 付款成功; failed: 付款失败; scheduled: 待发送; wait_user_confirm: 待收款用户确认;transferring: 转账中; canceling: 商户撤销请求受理成功;cancelled: 转账撤销完成。 | 
| app expandable string | 转账对应的 app对象的id。expandable可展开,查看如何获取App ID。 | 
| channel string | 付款使用的第三方支付渠道名称。目前支持 wx(微信 App)、wx_pub(微信 JSAPI)、wx_lite(微信小程序)、alipay(支付宝)、unionpay(银联电子代付)、allinpay(通联代付)和balance(余额)。 | 
| order_no string | 付款使用的商户内部订单号。 wx/wx_pub/wx_lite规定为 1 ~ 32 位不能重复的数字字母组合;alipay为 1 ~ 64 位不能重复的数字字母组合;unionpay为 1 ~ 16 位的纯数字;allinpay为 20 ~ 40 位不能重复的数字字母组合,必须以签约的通联的商户号开头(建议组合格式:通联商户号 + 时间戳 + 固定位数顺序流水号,不包含+号);balance为 1 ~ 64 位不能重复的数字字母组合,支持"-"和"_"。 | 
| amount int | 付款金额,相关渠道的限额,请查看帮助中心。单位为对应币种的最小货币单位,例如:人民币为分。 | 
| amount_settle int | 清算金额,单位为对应币种的最小货币单位,例如:人民币为分。 | 
| currency string | 三位 ISO 货币代码,目前仅支持人民币 cny。 | 
| recipient string | 接收者 id,使用微信企业付款到零钱时为用户在 wx、wx_pub及wx_lite渠道下的open_id,使用企业付款到银行卡时不需要此参数;渠道为unionpay时,不需要传该参数;渠道为alipay时,若 type 为 b2c,为个人支付宝账号,若 type 为 b2b,为企业支付宝账号;渠道为allinpay时,可不传该参数。渠道为balance时,为用户在当前 app 下的用户 id。 | 
| description string | 备注信息,最多 255 个 Unicode 字符。渠道为 unionpay时,最多 99 个 Unicode 字符,不可包含特殊字符;渠道为wx、wx_pub、wx_lite时,最多 99 个英文和数字的组合或最多 33 个中文字符,不可包含特殊字符;渠道为alipay时,最多 100 个 Unicode 字符;渠道为allinpay时,最多 30 个 Unicode 字符;渠道为balance时,最多 255 个 Unicode 字符。 | 
| metadata hash | 参考元数据。 | 
| transaction_no string | 交易流水号,由第三方渠道提供。 | 
| failure_msg string | 企业付款订单的错误消息的描述。 | 
| extra hash | transfer相关的附加参数,详情参考请求参数说明。 | 
{
  "id": "tr_HqbzHCvLOaL4La1ezHfDWTqH",
  "object": "transfer",
  "type": "b2c",
  "created": 1432724825,
  "time_transferred": null,
  "livemode": true,
  "status": "pending",
  "app": "app_1Gqj58ynP0mHeX1q",
  "channel": "wx_pub",
  "order_no": "123456789",
  "amount": 100,
  "amount_settle": 100,
  "currency": "cny",
  "recipient": "o7zpMs5MW2-52GAy5hRrjdYVCktU",
  "description": "Your Description",
  "transaction_no": "1000018301201505200184147302",
  "failure_msg":null,
  "extra": {
      "user_name": "User Name",
      "force_check": true
  }
}