Skip to main content
PUT /api/v2/storefront/billing Updates your storefront’s billing configuration — platform fee percentage, additional partner fees, settlement currency, and default payment terms. Admin-only. Send only the fields you want to change. Returns the full updated configuration.

​
Request

curl -X PUT https://api.interchange.io/api/v2/storefront/billing \
  -H "Authorization: Bearer $SCOPE3_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "platformFeePercent": 12.5,
    "fees": [
      { "name": "Ad serving", "description": "Third-party ad serving", "feePercent": 2 }
    ],
    "currency": "USD",
    "defaultNetDays": 30
  }'

​
Parameters

FieldTypeRequiredNotes
platformFeePercentnumberNoPlatform fee percentage, 0–100
feesarrayNoAdditional partner fees. Each entry: name (required, 1–255), feePercent (required, 0–100), description (optional, max 500)
currencystringNoISO 4217 currency code, three uppercase letters (e.g. USD)
defaultNetDaysintegerNoPayment terms in days (≥ 0)

​
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"
  }
}
The response is the full StorefrontBillingResponse after the update, mirroring Get billing config.

​
Errors

  • 400 VALIDATION_ERROR — platformFeePercent or a feePercent out of the 0–100 range, malformed currency, or negative defaultNetDays.
See Errors for the full error contract.

Billing tasks

All billing operations

Get billing config

Read the current configuration

Get account status

Charges, payouts, and balance

Billing overview

Stripe Connect concepts