Transfers 企业付款

你可以请求一个 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付款状态。目前支持 4 种状态:pending: 处理中; paid: 付款成功; failed: 付款失败; scheduled: 待发送。
app expandable string转账对应的 app 对象的 idexpandable 可展开,查看如何获取App ID
channel string付款使用的第三方支付渠道名称。目前支持 wx(微信 App)、wx_pub(微信公众号)、wx_lite(微信小程序)、alipay(支付宝)、unionpay(银联电子代付)、allinpay(通联代付)、jdpay(京东代付)和balance(余额)。
order_no string付款使用的商户内部订单号。wx/wx_pub/wx_lite 规定为 1 ~ 32 位不能重复的数字字母组合; alipay 为 1 ~ 64 位不能重复的数字字母组合;unionpay 为 1 ~ 16 位的纯数字; allinpay 为 20 ~ 40 位不能重复的数字字母组合,必须以签约的通联的商户号开头(建议组合格式:通联商户号 + 时间戳 + 固定位数顺序流水号,不包含+号); jdpay 为 1 ~ 64 位不能重复的数字字母组合;balance 为 1 ~ 64 位不能重复的数字字母组合,支持"-"和"_"。
amount int付款金额,相关渠道的限额,请查看帮助中心。单位为对应币种的最小货币单位,例如:人民币为分。
amount_settle int清算金额,单位为对应币种的最小货币单位,例如:人民币为分。
currency string三位 ISO 货币代码,目前仅支持人民币 cny。
recipient string接收者 id,使用微信企业付款到零钱时为用户在 wxwx_pubwx_lite 渠道下的 open_id,使用企业付款到银行卡时不需要此参数;渠道为 unionpay 时,不需要传该参数;渠道为 alipay 时,若 type 为 b2c,为个人支付宝账号,若 type 为 b2b,为企业支付宝账号;渠道为 jdpayallinpay 时,可不传该参数。渠道为 balance 时,为用户在当前 app 下的用户 id。
description string备注信息,最多 255 个 Unicode 字符。渠道为 unionpay 时,最多 99 个 Unicode 字符,不可包含特殊字符;渠道为 wxwx_pubwx_lite 时,最多 99 个英文和数字的组合或最多 33 个中文字符,不可包含特殊字符;渠道为 alipayjdpay 时,最多 100 个 Unicode 字符;渠道为 allinpay 时,最多 30 个 Unicode 字符;渠道为 balance 时,最多 255 个 Unicode 字符。
metadata hash参考元数据
transaction_no string交易流水号,由第三方渠道提供。
failure_msg string企业付款订单的错误消息的描述。
extra hashtransfer 相关的附加参数,详情参考请求参数说明。

示例对象

{
  "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
  }
}