获取商务中心余额

您可以使用本接口对商务中心中的广告账号进行充值和扣款，也可以获取商务中心资金余额，以及商务中心内广告账户的资金余额。

代理商商务中心和直客商务中心都能执行资金管理相关操作。

注意
只有拥有财务经理或财务分析师权限的用户才能在商务中心执行资金管理和发票的相关操作。您可以使用/bc/member/invite/ 和 /bc/member/update/设置或更改成员权限。

v1.2与v1.3版本对比

以下表格概括了 v1.2与v1.3接口的变化。 ``xtable |变化内容{30%}|v1.2{35%}|v1.3{35%}| |---|---|---| |接口路径|/v1.2/bc/balance/get/| /v1.3/bc/balance/get/| |请求参数类型|bc_id: number |bc_id: string | |新增请求参数|/|payment_portfolio_id| |返回参数类型|bc_id: number |bc_id: string | |新增返回参数|/|payment_portfolio_type`|


## 请求

**地址** https://business-api.tiktok.com/open_api/v1.3/bc/balance/get/

**方法** GET

**Header**

```xtable
|字段|类型|描述|
|---|---|---|
|Access-Token {必填}|string|授权access_token，可以通过[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口获取。  |

参数

|字段|类型|描述|
|---|---|---|
|bc_id {必填}|string| 商务中心ID。 |
|payment_portfolio_id|string|财务资产组合 ID。<br><br>若想获取与商务中心同属一个客户的财务资产组合列表，需使用 [/payment_portfolio/get/](1839151931301954.html) 接口。|

示例

(code curl http)
curl --get -H "Access-Token:xxx" \
--data-urlencode "bc_id=BC_ID" \
https://business-api.tiktok.com/open_api/v1.3/bc/balance/get/
(/code)

|字段|类型|描述|
|---|---|---|
|code |number|返回码,详见[附录-返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)  |
|message |string|返回信息,详见[附录-返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)  |
|data |object|返回数据。<br><br><p><span style="color:darkred"><b>注意</b></span>：若商务中心已启用支付组合，下列参数将返回支付组合而非商务中心的数据：<ul><li>`account_balance`</li><li>`valid_account_balance`</li><li>`frozen_balance`</li><li>`tax`</li><li> `cash_balance`</li><li>`valid_cash_balance` </li><li>`payment_portfolio_type`</li></ul>  |
#|bc_id |string| 商务中心ID。 |
#|currency |string| 商务中心币种，取值范围见[附录-币种](https://ads.tiktok.com/marketing_api/docs?id=1737585839634433)  |
#|account_balance |number| 商务中心总余额，保留两位小数 |
#|valid_account_balance |number| 商务中心有效账户余额，保留两位小数 |
#|frozen_balance |number| 商务中心冻结余额，保留两位小数 |
#|tax |number| 商务中心税费，保留两位小数 |
#|cash_balance |number| 商务中心现金余额，保留两位小数 |
#|valid_cash_balance |number| 商务中心有效现金余额，保留两位小数 |
#|grant_balance |number| 商务中心赠款余额，保留两位小数 |
#|valid_grant_balance |number| 商务中心有效赠款余额，保留两位小数 |
#|payment_portfolio_type|string|财务资产组合类型。<br><br>枚举值：<ul><li>`SHARED`：高级财务资产组合。对于高级财务资产组合，资金为集中管理，由所有关联的广告账号共同使用。</li><li>`NON_SHARED`：标准财务资产组合。对于标准财务资产组合，每个关联的广告账号的资金均为单独管理。</li></ul>|
|request_id |string|请求的日志id，唯一标识一个请求  |

示例

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "message": "OK",
    "code": 0,
    "data": {}
}
(/code);