Skip to main content
PUT /api/v2/buyer/storefronts/{storefrontId}/billing-policy Sets the buyer account’s billing preference for one selected seller. The caller must have the ADMIN or SUPER_ADMIN account role. Use agent for consolidated billing on your Interchange invoice and operator for direct billing by the seller or connected platform. The seller must support the requested party. Operator-auth platforms and direct-only sellers expose only operator and should be shown as read-only when there is no choice.

​
Lock boundary

The preference stays editable until Interchange dispatches the first real activation for an eligible advertiser. Direct-billing acceptance by itself does not lock the policy when no eligible advertiser exists. After dispatch begins, the endpoint fails closed with 409 CONFLICT; changing the policy then requires a future billing migration process.

​
Request

​
Parameters

​
Response

​
Errors

  • 400 VALIDATION_ERROR — the ID or billing party is invalid, or the seller does not support the requested policy.
  • 401 UNAUTHORIZED — the bearer token is missing or invalid.
  • 403 FORBIDDEN — the caller is not an account administrator.
  • 409 CONFLICT — the seller is not selected, the policy is already locked, or it changed concurrently.
See Errors for the full error contract.

Accept direct billing

Record the account-wide acceptance required by a direct policy

Update selection override

Select the seller before changing its billing policy