TOOL API
bc_
Processes a Business Center payment transfer: recharge money to or deduct money from an ad account in a Business Center, or increase or decrease the credit balance of a Business Center. Both Agency and Direct Business Centers can use this endpoint. Only users with Finance Manager permission can process a payment; member permissions can be configured with /bc/member/invite/ and /bc/member/update/.
Call information
- Tool slug
- tiktok-ads.bc_transfer
- Provider
- TikTok for Business
- Average response
- 0 ms
- Calls in 7 days
- 0
Input parameters
advertiser_idAd account ID. Required when `transfer_level` is `ADVERTISER` or omitted.
amount_infoDetails of the amount to process. Valid only when `transfer_level` is `ADVERTISER`. You must specify one of `amount_info`, `cash_amount`, or `grant_amount`. If `amount_info` is provided, top-level `cash_amount` and `grant_amount` are ignored.
bc_idrequiredBusiness Center ID. When `transfer_level` is `BC`, this must be the ID of a Business Center that has enabled Monthly Invoicing.
cash_amountRounded to two decimal places. You must specify one of `amount_info`, `cash_amount`, or `grant_amount`. If Balance Sharing is enabled and `transfer_level` is `ADVERTISER`, this field is not supported. When `transfer_level` is `ADVERTISER` or omitted, this is the cash amount to process. When `transfer_level` is `BC` or omitted, this is the credit amount to process. Value must be > 0. If `transfer_type` is `RECHARGE` and you specify a cash amount for an ad account transfer, a minimum transferable amount applies; get it from `/advertiser/balance/get/` in `min_transferable_amount.cash_amount`.
grant_amountVoucher amount to process, rounded to two decimal places. You must specify one of `amount_info`, `cash_amount`, or `grant_amount`. When `transfer_level` is `BC`, this field is not supported. Value must be > 0.
payment_portfolio_idPayment Portfolio ID. Required if multiple Payment Portfolios belong to the same client as the Business Center specified by `bc_id`.
request_idIdempotency key for the transfer request. Valid only when `transfer_level` is `BC` or `ADVERTISER`. If you retry the same request with the same `request_id`, only one request succeeds. This is different from the response `request_id`, which uniquely identifies the HTTP request. When `transfer_level` is `BC`, the value should be a 32-bit string. When `transfer_level` is `ADVERTISER`, the value should be a 32-bit string and idempotency is guaranteed for a 30-minute window. Idempotency for ad account-level transfers using `request_id` is currently an allowlist-only feature.
transfer_levelTransfer level. `ADVERTISER` recharges money to or deducts money from an ad account. `BC` increases or decreases the credit balance of the Business Center; when `transfer_level` is `BC`, you must provide in `bc_id` a Business Center ID with Monthly Invoicing enabled. Default: `ADVERTISER`.
transfer_typerequiredHow to process the payment. `RECHARGE` recharges money to an ad account or increases the credit balance of a Business Center. `REFUND` deducts money from an ad account or decreases the credit balance of a Business Center.