Skip to main content
POST /api/v2/storefront/billing/connect Creates a Stripe Express account for your storefront and returns a hosted onboarding URL. Redirect the operator to onboardingUrl to complete Stripe’s KYC flow. Onboarding links expire after 24 hours — if the operator drops out, fetch a fresh one with Get onboarding URL. Child customer accounts inherit billing from the parent and cannot provision their own.

​
Request

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

​
Parameters

FieldTypeRequiredNotes
targetCustomerIdnumberNoQuery param. Parent customers provision on behalf of a child account. Validated against the parent/child relationship

​
Response

{
  "stripeConnectedAccountId": "acct_1Abc2DefGhiJklMn",
  "onboardingUrl": "https://connect.stripe.com/setup/e/acct_1Abc2DefGhiJklMn/abc123"
}
stripeConnectedAccountId is the Stripe Express account now bound to your storefront. Redirect the operator to onboardingUrl to finish KYC before charges and payouts enable.

​
Errors

  • 400 VALIDATION_ERROR — child customers cannot provision billing directly, or Stripe is not configured on the server.
See Errors for the full error contract.

Billing tasks

All billing operations

Get onboarding URL

Fresh hosted onboarding link

Get account status

Check charges, payouts, and balance

Billing overview

Stripe Connect concepts