Skip to main content
Billing connects your storefront to Stripe so Scope3 can clear payments on your behalf. You provision a Stripe Express account, complete Stripe’s KYC onboarding, and Scope3 settles buyer payments and pays out to your bank — net of the platform fee and any additional fees on your billing config. Setup is optional by default. It becomes required once a connected inventory source advertises agent billing, since buyers can then ask Scope3 to clear payments through that source. While onboarding is incomplete, the billing_setup readiness check blocks activation in that case. Without Stripe, your storefront operates on external agreements only and you bill buyers directly. Onboarding is interactive: provision returns a Stripe-hosted onboardingUrl (links expire after 24 hours), or you can mount Stripe Connect components in-app with an embedded account session. Once charges and payouts are enabled, balance transactions, payouts, and invoices become readable. Parent customers can manage child-account billing by passing ?targetCustomerId=<childId>; child accounts always inherit billing from the parent and cannot provision their own. All examples use the storefront base URL: 
https://api.interchange.io/api/v2/storefront
Authenticate every request with Authorization: Bearer $SCOPE3_API_KEY.

​
Task reference

​
Setup

Provision Stripe Connect

POST /billing/connect — create the Express account

Get onboarding URL

GET /billing/onboard — fresh hosted onboarding link

Create account session

POST /billing/account-session — embedded onboarding UI

Update billing config

PUT /billing — fees, currency, net days (admin)

​
Status

Get billing config

GET /billing — current fees, currency, onboarding status

Get account status

GET /billing/status — charges, payouts, balance

List billing accounts

GET /billing/accounts — child-account status (parent)

​
Money

Get balance transactions

GET /billing/transactions — ledger entries

Get payouts

GET /billing/payouts — payouts to your bank

​
Invoices

List invoices

GET /billing/invoices — issued invoices

List pending invoice items

GET /billing/pending-invoice-items — not yet invoiced