← 返回目录
📁 API Reference › BC Payment Portfolios

将信用额度分配给财务资产组合

您可以使用本接口将单个客户的信用额度分配给一个或多个财务资产组合。

请求

地址 https://business-api.tiktok.com/open_api/v1.3/payment_portfolio/credit_line/update/

方法 POST

Header

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。<br>可以通过[获取访问令牌](1738373164380162.html)接口获取。|
|Content-Type {必填}|string|请求信息类型。<br>允许格式:`application/json`。|

参数

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|allocation_details {必填}|object[]|信用额度分配的详情。<br><br>最大数量:10。|
#|payment_portfolio_id {必填}|string|高级财务资产组合 ID。<br><br>若想获取可用财务资产组合 ID 的列表,需使用 [/payment_portfolio/get/](1839151931301954.html) 接口并筛选 `payment_portfolio_type` 为 `SHARED` 的财务资产组合。|
#|allocation_percentage {必填}|number|希望分配给该财务资产组合的信用额度百分比,保留四位小数。<br><br>取值范围:0-1。<br><br><p><span style="color:darkred"><b>注意</b></span>:<ul><li>分配给每个财务资产组合的百分比必须大于已用信用额度百分比。若想确认财务资产组合的已用信用额度百分比,请查看 [/payment_portfolio/get/](1839151931301954.html) 返回的 `min_allocation_percentage`。</li><li>如果您的总信用额度在后期变化,其每个组合的信用额度将根据设置的百分比进行调整。</li><li>每个组合的可用信用额度将在未结账单结清后自动恢复。您无需手动重新分配金额。</li></ul>|

示例

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/payment_portfolio/credit_line/update/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: application/json' \
--data '{
    "allocation_details": [
        {
            "payment_portfolio_id": "{{payment_portfolio_id}}",
            "allocation_percentage": {{allocation_percentage}}
        },
        {
            "payment_portfolio_id": "{{payment_portfolio_id}}",
            "allocation_percentage": {{allocation_percentage}}
        }
    ]
}'
(/code)

返回

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|code |number| 返回码。完整返回码列表及描述,参见[附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|message |string| 返回信息。更多信息参见[附录 - 返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。 |
|request_id |string| 请求的日志 ID,唯一标识一个请求。 |
|data |object| 返回数据。 |

示例

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

内容来源:TikTok API for Business 官方文档 · 本地归档

在接这个接口时卡住了?
Stuck wiring this API into production? We build ad-delivery tooling on these platforms — campaign automation, reporting pipelines, error-handling and migration between API versions.
联系我们 · Talk to us 每日平台更新简报 →