Get billing config

GET /api/v2/storefront/billing Returns your storefront’s billing configuration: payout setup status, platform fee percentage, any additional partner fees, payout currency, payment terms, and the payout details on file (masked — the account number is never returned after save). billing is null when no configuration exists yet. When billing is inherited from your organization, inherited is true. Also available to agents as the get_billing_info operation.

Request

curl "https://api.interchange.io/api/v2/storefront/billing" \
  -H "Authorization: Bearer $SCOPE3_API_KEY"

Parameters

Field	Type	Required	Notes
`targetCustomerId`	number	No	Query param. Organizations read a managed account’s config

Response

{
  "billing": {
    "onboardingStatus": "complete",
    "platformFeePercent": 12.5,
    "fees": [
      { "name": "Ad serving", "description": "Third-party ad serving", "feePercent": 2 }
    ],
    "currency": "USD",
    "country": "US",
    "defaultNetDays": 30,
    "payoutDetails": {
      "beneficiaryName": "Meridian Media Group Inc.",
      "addressLine1": "500 Harbor Blvd",
      "addressLine2": null,
      "city": "Seattle",
      "region": "WA",
      "postalCode": "98101",
      "countryCode": "US",
      "accountNumberLast4": "6789",
      "bankIdentifierType": "FEDWIRE_ABA",
      "bankIdentifierValue": "021000021",
      "completedAt": "2026-07-01T09:30:00Z"
    },
    "inherited": false,
    "createdAt": "2026-04-25T12:00:00Z",
    "updatedAt": "2026-05-01T09:30:00Z"
  }
}

Field	Type	Notes
`onboardingStatus`	enum	Payout setup status: `pending`, `complete` (payout details on file), or `restricted`
`platformFeePercent`	number \| null	Platform fee percentage
`fees`	array \| null	Additional partner fees (`name`, `description`, `feePercent`)
`currency`	string \| null	Payout currency (ISO 4217)
`country`	string \| null	ISO 3166-1 alpha-2 country used for billing
`defaultNetDays`	number \| null	Payment terms in days
`payoutDetails`	object \| null	Masked bank details on file — see below. `null` until saved
`inherited`	boolean	Whether this config is inherited from the organization

payoutDetails carries beneficiaryName, the beneficiary address fields, accountNumberLast4 (the only part of the account number ever returned), bankIdentifierType + bankIdentifierValue, and completedAt. While payoutDetails is null, media buys against your storefront cannot use Interchange-cleared (agent) settlement. A normal storefront is blocked from activation rather than silently switching to seller-cleared — save details with Set payout details.

Errors

400 VALIDATION_ERROR — malformed request or invalid targetCustomerId.

See Errors for the full error contract.

Billing tasks

All billing operations

Set payout details

Save the bank account Interchange pays into

Update billing config

Change fees, currency, net days (admin)

Billing overview

How payouts work and why bank details are needed

Billing tasks Get payout activity

⌘I

Getting Started

Operating Your Storefront

Inventory Sources

Real-Time Targeting (TMP)

Approvals & Reviews

Buyer Onboarding

Demand & Signals

Proposals & Agents

Buyer Routing

Analytics & Activity

Billing

Account

Request

Parameters

Response

Errors

Billing tasks

Set payout details

Update billing config

Billing overview

​Request

​Parameters

​Response

​Errors

​Related

Billing tasks

Set payout details

Update billing config

Billing overview

Request

Parameters

Response

Errors

Related