Skip to main content
GET /api/v2/storefront/billing Returns your storefront’s billing configuration: Stripe onboarding status, platform fee percentage, any additional partner fees, settlement currency, and payment terms. billing is null when no configuration exists yet. When billing is inherited from a parent customer, inherited is true.

​
Request

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

​
Parameters

FieldTypeRequiredNotes
targetCustomerIdnumberNoQuery param. Parent customers read a child account’s config

​
Response

{
  "billing": {
    "stripeConnectedAccountId": "acct_1Abc2DefGhiJklMn",
    "onboardingStatus": "complete",
    "platformFeePercent": 12.5,
    "fees": [
      { "name": "Ad serving", "description": "Third-party ad serving", "feePercent": 2 }
    ],
    "currency": "USD",
    "defaultNetDays": 30,
    "inherited": false,
    "createdAt": "2026-04-25T12:00:00Z",
    "updatedAt": "2026-05-01T09:30:00Z"
  }
}
onboardingStatus is one of pending, complete, or restricted. platformFeePercent, fees, currency, and defaultNetDays are null until configured. When billing is null, the storefront has no billing configuration at all.

​
Errors

  • 400 VALIDATION_ERROR — malformed request or invalid targetCustomerId.
See Errors for the full error contract.

Billing tasks

All billing operations

Update billing config

Change fees, currency, net days (admin)

Get account status

Charges, payouts, and balance

Billing overview

Stripe Connect concepts