Skip to main content
A sponsored buyer is an advertiser that joined your storefront through one of your join links. It is a buyer account sponsored by your organization and scoped to your storefront: the buyer discovers and transacts only against your inventory and never sees the wider marketplace. This is your “my buyers” surface. Each sponsored buyer carries a status that gates whether it can transact, and you move that status as you onboard, pause, and resume buyers. All examples use the storefront base URL: 
https://api.interchange.io/api/v2/storefront
Authenticate every request with Authorization: Bearer $SCOPE3_API_KEY. Results are scoped to your seller customer context — you can only see and manage buyers your organization sponsors.

​
Status lifecycle

A sponsored buyer moves through three states. The status is the transaction gate: only an active buyer can create or edit media buys against your storefront.
StatusMeaningCan transact?
pendingJoined through a manual_approve link; awaiting your review.No
activeApproved (or joined through an auto_approve link).Yes
suspendedPaused by you.No
Allowed transitions:
  • pending → active — Approve a buyer awaiting review.
  • pending or active → suspended — Suspend a buyer to pause new transactions.
  • suspended → active — Reactivate a suspended buyer.
Suspending a buyer blocks new media buys and edits. It does not pause in-flight delivery on media buys that are already running.

​
Key concepts

  • Scope is enforced, not advisory. A sponsored buyer is confined to your storefront at every read and write path — discovery, product details, and media-buy creation. They cannot pin or transact against any other storefront.
  • Posture. Sponsored buyers are prepay day-one; the posture field future-proofs for credit terms.
  • Buyer identity. buyerName is the buyer’s company/display name from their core customer record. It is null when not yet resolvable.

​
Task reference

List sponsored buyers

Every buyer your organization sponsors

Approve sponsored buyer

Admit a pending buyer

Suspend sponsored buyer

Pause an active buyer

Reactivate sponsored buyer

Resume a suspended buyer

Join links

Mint the links buyers join through

All sponsored-buyer tasks

Every operation in one place

Storefront onboarding

End-to-end seller setup

Errors

Shared error contract