Colle Marketplace
Colle.ioWebApp (Live)WebApp (Test)
  • Contracts Overview
  • Functional Requirements
  • Contract Descriptions
  • Technical Project & Audit Details
  • Test Coverage Report
  • Static Analysis
  • Royalty Pool Explained
  • Sale State Explained
  • Sales Tax Explained
  • marketplace
    • IMarketHub
    • IMarketHubRegistrar
    • MarketHub
    • MarketHubRegistrar
    • MarketHubRegistrarUpgradeable
    • collections
      • ColleCollection
      • ColleCollectionUpgradeable
      • CollectionRegistry
      • IColleCollection
      • IColleCollectionUpgradeable
      • ICollectionRegistry
    • currencies
      • BaseCurrency
      • CurrencyRegistry
      • ICurrency
      • ICurrencyRegistry
      • USDCCurrency
    • escrow
      • EscrowUpgradeable
      • IEscrow
      • IEscrowRegistry
    • kycs
      • Account
      • IKYCRegistry
      • KYCRegistry
    • markets
      • BaseMarketUpgradeable
      • IListingMarket
      • IMarket
      • IMarketRegistry
      • IOfferMarket
      • ListingMarketUpgradeable
      • MarketRegistry
      • OfferMarketUpgradeable
    • royalties
      • BaseRoyalty
      • BlackTierRoyalty
      • GoldTierRoyalty
      • GreenTierRoyalty
      • IRoyalty
      • IRoyaltyPool
      • IRoyaltyRegistry
      • PlatinumTierRoyalty
      • RoyaltyPool
      • RoyaltyRegistry
      • v1
        • BlackTierRoyaltyV1
        • GoldTierRoyaltyV1
        • GreenTierRoyaltyV1
        • PlatinumTierRoyaltyV1
    • taxes
      • ITaxPolicyRegistry
      • Tax
      • TaxPolicyRegistry
    • upgrade-gatekeeper
      • IUpgradeGatekeeper
      • UpgradeGatekeeper
    • vaults
      • IVault
      • IVaultRegistry
      • VaultUpgradeable
  • team-smart-wallet
    • ITeamSmartWallet
    • ITeamSmartWalletHelper
    • TeamSmartWallet
    • TeamSmartWalletFactory
    • TeamSmartWalletPermitHelper
  • utils
    • MarketAccess
    • MarketAccessUpgradeable
    • Signature
    • SignatureValidator
Powered by GitBook
On this page
  • States
  • Starting
  • In-progress
  • Ending
  • Key Actions
  • Buyer
  • Seller
  • Colle
  • Escrow

Sale State Explained

PreviousRoyalty Pool ExplainedNextSales Tax Explained

Last updated 1 year ago

Sale state machine

States

The possible states of a sale are:

Starting

  • Awaiting Settlement

  • Awaiting ERC20 Deposit

In-progress

  • Pending Sale

  • Processing Sale

  • Shipping To Buyer

  • Received

  • Shipping To Colle For Authentication

  • Colle Processing Sale

  • Shipping To Colle For Dispute

Ending

  • Issue With Delivery

  • Issue With Product

  • Sale Cancelled

  • Sale Success

Key Actions

Buyer

  1. Triggers a sale by accepting a listing. They can pay on-chain, or pay off-chain.

  2. If they chose to pay on-chain, they must approve and update the state within 24 hours, or cancel the sale

  3. Can cancel a pending sale before the seller begins processing

  4. Can dispute an item upon receiving it within 48 hours

  5. Can accept an item upon receiving it

Seller

  1. Triggers a sale by accepting an offer. The buyer set in the offer whether they are paying now, paying later, or paying off-chain.

  2. If the buyer chose to pay on-chain and 24 hours have passed without payment, the seller can cancel the sale

  3. The seller can cancel a pending sale

  4. The seller can cancel a processing sale

  5. The seller can ship the item to the buyer or Colle for authentication (depending on seller tier)

Colle

  1. If the buyer chose to pay off-chain, Colle can either approve once the payment has settled, or cancel if the funds do not settle

  2. Colle can cancel a pending sale

  3. Colle can cancel a processing sale

  4. Colle listens to the shipping API to confirm when shipments have arrived, or a issue arrises with shipping

  5. If the buyer disputes a sale, Colle can approve or reject this dispute

Escrow

  1. Releases the payment to the seller and NFT to the buyer if: a. The buyer accepts the item upon receiving it. b. The window for the buyer to dispute an item upon receiving it has ended (e.g., 48 hours have passed without a dispute or acceptance).

  2. Returns the payment to the buyer and NFT to the seller if: a. The buyer cancels the sale. b. The seller cancels the sale. c. Colle cancels the sale. d. Colle determines the watch was not as described during authentication or dispute.

  3. Releases payment and the NFT to Colle if: a. Issues with UPS arise, and insurance is involved. Colle is responsible for working with the insurance company and making all parties whole.