This page covers the store record and the data models that make up its business
identity.
Store
A store is the marketplace vendor. It owns offers, orders, and payouts, and it
holds the profile shown to customers on the storefront. A store is represented by
the Seller data model (table seller, id prefix sel).
A store settles in exactly one currency, set by currency_code. A seller who
needs to trade in several currencies creates a separate store for each one, and
each store operates independently.
Professional details
A store can carry professional details: a corporate name, a registration number,
and a tax id. These are represented by the ProfessionalDetails data model. When
this record is present, the store is a registered business. When it is absent,
the store is an individual seller.
Addresses and payment details
A store keeps its addresses as SellerAddress records, one each for a warehouse,
return, or business address. The bank details used to settle payouts live on a
PaymentDetails record. Both are satellite records of the store, and fulfillment
and payout settlement read from them.
ProfessionalDetails, SellerAddress, and PaymentDetails are one-to-one with
the store and are deleted along with it.