创建 Balance Transfer 对象

发起一次余额转账请求时需要创建一个新的 balance_transfer 对象。该接口不支持商户向用户转账，如果要发起 B2C 转账，请使用 企业付款 发起，将渠道设置为 balance，在企业付款完成后，会自动为你生成 balance_transfer 对象。 如果使用了余额分润，在分润结算发起后，也会自动生成 balance_transfer 对象。注： 使用此接口必须保证用户可提现余额大于0。

请求参数描述
APP_ID required string对应 app 对象的 id，该参数仅需要填写在请求地址内，查看 如何获取App ID。
amount required int接收方收到转账的金额，单位为分。
user required string发送方 user 对象的 id，该值不能为 "0"。
recipient required string接收方 user 对象的 id。
order_no required string商户订单号，必须在商户的系统内唯一，取值范围 1~64 位。
user_fee optional int向发起转账的用户额外收取的手续费，单位为分，默认值为 "0"，且值需小于 amount。
description optional string附加说明，最多 60 个 Unicode 字符。
metadata optional hash详见 元数据。

返回

返回 balance_transfers 对象，或者返回一个错误，详见 错误。

定义

POST https://api.pingxx.com/v1/apps/{APP_ID}/balance_transfers
待补充
待补充
待补充
待补充
待补充
待补充
待补充

请求示例

curl https://api.pingxx.com/v1/apps/app_1Gqj58ynP0mHeX1q/balance_transfers \
-H "Pingplusplus-Signature: {SIGNATURE}" \
-H "Pingplusplus-Request-Timestamp: 1496728534" \
-u sk_test_ibbTe5jLGCi5rzfH4OqPW9KC: \
-d '{
  "amount": 100,
  "description": "余额转账",
  "user": "user_007",
  "recipient": "user_008",
  "order_no": "2017071110259981"
}'
待补充
待补充
待补充
待补充
待补充
待补充
待补充

返回示例

{
  "id": "311117071315154300000100",
  "object": "balance_transfer",
  "app": "app_1Gqj58ynP0mHeX1q",
  "created": 1496728534,
  "livemode": false,
  "status": "succeeded",
  "amount": 1000,
  "order_no": "2017071110259981",
  "user": "user_007",
  "recipient": "user_008",
  "user_fee": 0,
  "user_balance_transaction": "310317060612081500000101",
  "recipient_balance_transaction": "310317060612081500000201",
  "description": "余额转账",
  "metadata": {}
}