Get billing config

GET /api/v2/storefront/billing Returns your Seller Account’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 Seller Account remain Interchange-cleared (agent) and funds continue to accrue, but Interchange cannot disburse them. Missing payout details do not block activation or silently switch a booking to seller-cleared settlement. Save details with Set payout details before you need a payout.

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

Start building

Core Concepts

Buyer operations

Seller operations

Cross-Cutting Reference

Buyer API reference

Seller API reference

Release Notes

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