: <value> } }], images: [{ url }], thumbnail, ... }","response":"{ product: { id: string, variants: [{ id, inventory_item_id }, ...] } }","codeRef":"lib/src/features/seller/products/create_product_screen.dart // via vendor_service.dart:230","notes":"auth: seller. Returned inventory_item_ids are needed for the subsequent location-levels calls."}},{"featureSlug":"seller-products","featureTitle":"Seller Products (Physical)","nodeSlug":"vendor-service-products","nodeTitle":"VendorService — Physical Products Slice","call":{"method":"POST","endpoint":"/vendor/products/:id","purpose":"Update product fields (partial).","request":"Partial product fields","response":"{ product: Product }","codeRef":"lib/src/features/seller/products/edit_product_screen.dart // via vendor_service.dart:250","notes":"auth: seller."}},{"featureSlug":"seller-products","featureTitle":"Seller Products (Physical)","nodeSlug":"vendor-service-products","nodeTitle":"VendorService — Physical Products Slice","call":{"method":"DELETE","endpoint":"/vendor/products/:id","purpose":"Delete a physical product.","response":"200 (no body)","codeRef":"lib/src/features/seller/products/seller_products_screen.dart // Delete confirm","notes":"auth: seller."}},{"featureSlug":"seller-products","featureTitle":"Seller Products (Physical)","nodeSlug":"vendor-service-products","nodeTitle":"VendorService — Physical Products Slice","call":{"method":"GET","endpoint":"/vendor/stock-locations","purpose":"Bootstrap the list of stock locations (warehouse / store).","response":"{ stock_locations: [{ id, name, ... }] }","codeRef":"lib/src/features/seller/products/create_product_screen.dart // location bootstrap","notes":"auth: seller."}},{"featureSlug":"seller-products","featureTitle":"Seller Products (Physical)","nodeSlug":"vendor-service-products","nodeTitle":"VendorService — Physical Products Slice","call":{"method":"POST","endpoint":"/vendor/stock-locations","purpose":"Create a first-time stock location.","request":"{ name: string, address?: any }","response":"{ stock_location: StockLocation }","codeRef":"lib/src/features/seller/products/create_product_screen.dart // first-time creation","notes":"auth: seller."}},{"featureSlug":"seller-products","featureTitle":"Seller Products (Physical)","nodeSlug":"vendor-service-products","nodeTitle":"VendorService — Physical Products Slice","call":{"method":"POST","endpoint":"/vendor/inventory-items/:id/location-levels","purpose":"Set initial stocked_quantity for a variant at a stock location.","request":"{ location_id: string, stocked_quantity: number }","response":"{ ... }","codeRef":"lib/src/features/seller/products/create_product_screen.dart","notes":"auth: seller. Called per variant post product-create."}},{"featureSlug":"seller-products","featureTitle":"Seller Products (Physical)","nodeSlug":"vendor-service-products","nodeTitle":"VendorService — Physical Products Slice","call":{"method":"POST","endpoint":"/vendor/inventory-items/:id/location-levels/:levelId","purpose":"Update a variant's stocked_quantity at an existing location level.","request":"{ stocked_quantity: number }","response":"{ ... }","codeRef":"lib/src/features/seller/products/edit_product_screen.dart // variant stock change","notes":"auth: seller."}},{"featureSlug":"seller-products","featureTitle":"Seller Products (Physical)","nodeSlug":"vendor-service-products","nodeTitle":"VendorService — Physical Products Slice","call":{"method":"POST","endpoint":"/vendor/product-location/:productId","purpose":"Attach a geographic location (lat/lng/address) to a product.","request":"{ lat: number, lng: number, address?: string }","response":"{ ... }","codeRef":"lib/src/features/seller/products/create_product_screen.dart // post-create","notes":"auth: seller."}},{"featureSlug":"seller-products","featureTitle":"Seller Products (Physical)","nodeSlug":"vendor-service-products","nodeTitle":"VendorService — Physical Products Slice","call":{"method":"POST","endpoint":"/vendor/files","purpose":"Multipart upload of a product image to the vendor files endpoint.","request":"FormData({ file: File, purpose: 'public' })","response":"{ url: string }","codeRef":"lib/src/core/services/vendor_service.dart:650 // uploadPublicFile","notes":"auth: seller. Used by both create + edit product screens for image upload."}},{"featureSlug":"seller-products","featureTitle":"Seller Products (Physical)","nodeSlug":"marketplace-service-detail","nodeTitle":"MarketplaceService.getProductById (customer detail)","call":{"method":"GET","endpoint":"/store/physical-products/:productId?fields=*variants.calculated_price","purpose":"Customer-side single product fetch (fallback when ProductDetailScreen has no route extra).","response":"{ product: Product }","errors":["product not found → thrown as 'Product not found', surfaced as state.error"],"codeRef":"lib/src/features/shared/product_details/views/product_details_screen.dart // loadProduct","notes":"auth: customer. calculated_price requires the explicit fields query."}},{"featureSlug":"seller-balance","featureTitle":"Seller Balance & Payouts","nodeSlug":"stripe-service","nodeTitle":"StripeService","call":{"method":"GET","endpoint":"/vendor/stripe/payout-account","purpose":"Read the current Stripe Connect payout account state.","response":"PayoutAccountModel | null","errors":["404 / 400 / 403 / 401 are swallowed as null (treated as 'no account yet')"],"codeRef":"lib/src/features/seller/bank_account/views/bank_account_screen.dart // initial load","notes":"auth: seller bearer."}},{"featureSlug":"seller-balance","featureTitle":"Seller Balance & Payouts","nodeSlug":"stripe-service","nodeTitle":"StripeService","call":{"method":"POST","endpoint":"/vendor/stripe/payout-account","purpose":"Submit Step 1 of onboarding: account_token from Stripe → backend creates the Connect account.","request":"{ account_token: string /* ct_... */ }","response":"PayoutAccountModel","codeRef":"lib/src/features/seller/bank_account/views/bank_account_screen.dart // Step 1 submit","notes":"auth: seller bearer."}},{"featureSlug":"seller-balance","featureTitle":"Seller Balance & Payouts","nodeSlug":"stripe-service","nodeTitle":"StripeService","call":{"method":"POST","endpoint":"/vendor/stripe/bank_account","purpose":"Submit Step 2 of onboarding: bank_token from Stripe → backend attaches the bank account.","request":"{ bank_token: string /* btok_... */ }","response":"{ ... }","codeRef":"lib/src/features/seller/bank_account/views/bank_account_screen.dart // Step 2 submit","notes":"auth: seller bearer."}},{"featureSlug":"seller-balance","featureTitle":"Seller Balance & Payouts","nodeSlug":"stripe-service","nodeTitle":"StripeService","call":{"method":"POST","endpoint":"/vendor/stripe/verify-identity","purpose":"Submit Step 3 of onboarding: front-of-document file id → backend submits identity to Stripe.","request":"{ front_file_id: string /* file_... */ }","response":"{ ... }","codeRef":"lib/src/features/seller/bank_account/views/bank_account_screen.dart // Step 3 submit","notes":"auth: seller bearer."}},{"featureSlug":"seller-balance","featureTitle":"Seller Balance & Payouts","nodeSlug":"stripe-service","nodeTitle":"StripeService","call":{"method":"GET","endpoint":"/vendor/stripe/account","purpose":"Refresh the full Stripe account JSON after onboarding completes.","response":"Stripe account JSON | null","codeRef":"lib/src/features/seller/bank_account/views/bank_account_screen.dart // refresh after step 3","notes":"auth: seller bearer."}},{"featureSlug":"seller-balance","featureTitle":"Seller Balance & Payouts","nodeSlug":"stripe-service","nodeTitle":"StripeService","call":{"method":"GET","endpoint":"/vendor/stripe/balance","purpose":"Available + pending balance in cents.","response":"BalanceModel { available, pending /* cents */ } | null","codeRef":"lib/src/features/seller/balance/views/balance_screen.dart","notes":"auth: seller bearer."}},{"featureSlug":"seller-balance","featureTitle":"Seller Balance & Payouts","nodeSlug":"stripe-service","nodeTitle":"StripeService","call":{"method":"GET","endpoint":"/vendor/stripe/transactions","purpose":"Paginated list of seller transactions.","response":"{ transactions: TransactionModel[] }","codeRef":"lib/src/features/seller/balance/views/balance_screen.dart","notes":"auth: seller bearer."}},{"featureSlug":"seller-balance","featureTitle":"Seller Balance & Payouts","nodeSlug":"stripe-service","nodeTitle":"StripeService","call":{"method":"GET","endpoint":"/vendor/stripe/transactions/:id","purpose":"Transaction detail (rendered in a bottom sheet).","response":"TransactionDetailModel | null","codeRef":"lib/src/features/seller/balance/widgets/transaction_detail_sheet.dart","notes":"auth: seller bearer."}},{"featureSlug":"seller-balance","featureTitle":"Seller Balance & Payouts","nodeSlug":"stripe-service","nodeTitle":"StripeService","call":{"method":"POST","endpoint":"https://api.stripe.com/v1/tokens","purpose":"Direct Stripe call (Step 1): tokenize personal account details into an account token (ct_...).","request":"form-urlencoded: account[individual][first_name|last_name|email|phone|dob[day|month|year]], account[individual][address][line1|city|state|postal_code|country], account[business_type], account[tos_shown_and_accepted]='true'","response":"{ id: 'ct_...' }","codeRef":"lib/src/features/seller/bank_account/views/bank_account_screen.dart // Step 1, via stripe_service.dart:127","notes":"auth: Bearer = STRIPE_PUBLISHABLE_KEY. Hits api.stripe.com directly."}},{"featureSlug":"seller-balance","featureTitle":"Seller Balance & Payouts","nodeSlug":"stripe-service","nodeTitle":"StripeService","call":{"method":"POST","endpoint":"https://api.stripe.com/v1/tokens","purpose":"Direct Stripe call (Step 2): tokenize bank account details into a bank token (btok_...).","request":"form-urlencoded: bank_account[country|currency|account_holder_name|account_holder_type|account_number]","response":"{ id: 'btok_...' }","codeRef":"lib/src/features/seller/bank_account/views/bank_account_screen.dart // Step 2, via stripe_service.dart:152","notes":"auth: Bearer = STRIPE_PUBLISHABLE_KEY."}},{"featureSlug":"seller-balance","featureTitle":"Seller Balance & Payouts","nodeSlug":"stripe-service","nodeTitle":"StripeService","call":{"method":"POST","endpoint":"https://files.stripe.com/v1/files","purpose":"Direct Stripe call (Step 3): upload identity document and receive a file_id.","request":"FormData({ file: File, purpose: 'identity_document' })","response":"{ id: 'file_...' }","codeRef":"lib/src/features/seller/bank_account/views/bank_account_screen.dart // Step 3, via stripe_service.dart:210 // uploadFileToStripe","notes":"auth: Bearer = STRIPE_PUBLISHABLE_KEY. Hits files.stripe.com."}}],"environments":"$undefined"}]]}]] </article></body></html>

8:[["$","$L11",null,{"crumbs":[{"label":"Home","href":"/"},{"label":"Projects","href":"/projects"},{"label":"Seaven","href":"/projects/seaven"},{"label":"API"}]}],["$","div",null,{"className":"px-6 py-6","children":[["$","div",null,{"className":"mx-auto max-w-3xl text-center mb-8","children":[["$","h1",null,{"className":"text-3xl font-bold tracking-tight","children":"API Catalog"}],["$","p",null,{"className":"text-muted-foreground mt-2","children":["Every endpoint ","Seaven"," talks to — contract, lifecycle status and a runnable request for each."]}]]}],["$","$L12",null,{"projectSlug":"seaven","projectTitle":"Seaven","entries":[{"featureSlug":"auth","featureTitle":"Authentication","nodeSlug":"login-notifier","nodeTitle":"Login Notifier","call":{"method":"POST","endpoint":"/auth/customer/emailpass-verified","purpose":"Authenticate as a customer with email + password and receive a session token (mandatory leg of the dual-login).","request":"{ email: string, password: string }","response":"{ token: string }","codeRef":"lib/src/features/shared/auth/login/presentation/login.dart","notes":"auth: none. First leg of dualLogin; any non-401 customer error throws."}},{"featureSlug":"auth","featureTitle":"Authentication","nodeSlug":"login-notifier","nodeTitle":"Login Notifier","call":{"method":"POST","endpoint":"/auth/seller/emailpass-verified","purpose":"Best-effort seller login using the same credentials — used to detect multi-role users.","request":"{ email: string, password: string }","response":"{ token: string }","errors":["401 treated as 'not a seller' — swallowed and returned as null"],"codeRef":"lib/src/features/shared/auth/login/presentation/login.dart","notes":"auth: none. Second leg of dualLogin; 401 is swallowed."}},{"featureSlug":"auth","featureTitle":"Authentication","nodeSlug":"login-notifier","nodeTitle":"Login Notifier","call":{"method":"POST","endpoint":"/auth/customer/google-mobile","purpose":"Exchange a Google OAuth payload (id_token + access_token) for a customer session token.","request":"{ id_token: string, access_token: string, expires_in: number, token_type: string, scope: string, refresh_token: string }","response":"{ token: string }","codeRef":"lib/src/features/shared/auth/login/presentation/login.dart","notes":"auth: none. No seller path yet — sellerToken is null."}},{"featureSlug":"auth","featureTitle":"Authentication","nodeSlug":"login-notifier","nodeTitle":"Login Notifier","call":{"method":"POST","endpoint":"/auth/apple/callback","purpose":"Exchange an Apple Sign-In identity payload for a customer session token.","request":"{ id_token: string, access_token: string, email?: string, first_name?: string, last_name?: string }","response":"{ token: string }","codeRef":"lib/src/features/shared/auth/login/presentation/login.dart","notes":"auth: none. Apple only sends name/email on first authorization; later logins rely on backend mapping by Apple subject ID."}},{"featureSlug":"auth","featureTitle":"Authentication","nodeSlug":"register-notifier","nodeTitle":"Register Notifier","call":{"method":"POST","endpoint":"/auth/customer/emailpass-verified/register","purpose":"Create a customer account; backend emails an OTP and does NOT issue a session yet.","request":"{ email: string, password: string }","response":"{ success: true }","errors":["200 with { type: 'unauthorized', message } — Medusa-style soft failure surfaced as Exception"],"codeRef":"lib/src/features/shared/onboarding_register/presentation/pages/register_step_page.dart","notes":"auth: none. Session is intentionally NOT saved here — the user is authenticated only after the OTP verify call."}},{"featureSlug":"auth","featureTitle":"Authentication","nodeSlug":"register-notifier","nodeTitle":"Register Notifier","call":{"method":"POST","endpoint":"/auth/customer/emailpass-verified/verify","purpose":"Verify the emailed OTP and finally issue the customer session token.","request":"{ email: string, otp: string }","response":"{ token: string }","codeRef":"lib/src/features/shared/onboarding_register/presentation/pages/otp_step_page.dart","notes":"auth: none. The returned token is persisted via AuthStorageService.saveSessionOtp."}},{"featureSlug":"auth","featureTitle":"Authentication","nodeSlug":"forgot-password-notifier","nodeTitle":"Forgot Password Notifier","call":{"method":"POST","endpoint":"/auth/customer/emailpass-verified/reset-password","purpose":"Trigger a password-reset email for the given address.","request":"{ identifier: string /* email */ }","response":"201 (no body)","codeRef":"lib/src/features/shared/auth/forget_password/presentation/forget_password.dart","notes":"auth: none. Idempotent — same 201 whether the email exists or not (enumeration-safe)."}},{"featureSlug":"auth","featureTitle":"Authentication","nodeSlug":"forgot-password-notifier","nodeTitle":"Forgot Password Notifier","call":{"method":"POST","endpoint":"/auth/reset-password/verify","purpose":"Verify the OTP from the reset email and receive a short-lived reset token.","request":"{ email: string, otp: string }","response":"{ success: true, data: { token: string } }","errors":["{ success: false, error: string } — verbatim error surface"],"codeRef":"lib/src/features/shared/auth/forget_password/presentation/reset_password_otp_screen.dart","notes":"auth: none. The returned token is the input to /auth/customer/emailpass-verified/update."}},{"featureSlug":"auth","featureTitle":"Authentication","nodeSlug":"forgot-password-notifier","nodeTitle":"Forgot Password Notifier","call":{"method":"POST","endpoint":"/auth/customer/emailpass-verified/update","purpose":"Set a new password using the short-lived reset token.","request":"{ email: string, password: string } + header `Authorization: Bearer `","response":"{ success: true }","codeRef":"lib/src/features/shared/auth/forget_password/presentation/reset_password_screen.dart","notes":"auth: reset-token (NOT the customer bearer). UI surfaces generic 'Something went wrong' on expiry."}},{"featureSlug":"auth","featureTitle":"Authentication","nodeSlug":"change-password-notifier","nodeTitle":"Change Password Notifier","call":{"method":"POST","endpoint":"/store/change-password/emailpass-verified","purpose":"Rotate the authenticated customer's password from the settings screen.","request":"{ old_password: string, new_password: string }","response":"200 (no body)","errors":["401/403 wrong old password — rewritten as 'Current password is incorrect'","HTML 5xx — surfaced as 'Server error. Please try again later.'"],"codeRef":"lib/src/features/shared/auth/change_password/presentation/change_password.dart","notes":"auth: customer bearer (authScope='customer'). Token is NOT invalidated on success — same bearer keeps working."}},{"featureSlug":"auth","featureTitle":"Authentication","nodeSlug":"change-password-notifier","nodeTitle":"Change Password Notifier","call":{"method":"POST","endpoint":"/auth/password-change/","purpose":"Legacy password-change endpoint kept on AuthApiService but no longer wired into any UI.","request":"{ current_password: string, new_password: string, new_password_confirm: string }","response":"200 (no body)","codeRef":"lib/src/core/services/auth_service.dart:270","notes":"auth: customer bearer. Unused in UI today — kept for backwards compatibility."}},{"featureSlug":"auth","featureTitle":"Authentication","nodeSlug":"auth-api-service","nodeTitle":"Auth API Service","call":{"method":"POST","endpoint":"/auth/sign-in/email","purpose":"Legacy single-token email/password sign-in — kept on the old AuthService for AuthRepositoryImpl compatibility, not used by the current Riverpod notifier.","request":"{ email: string, password: string }","response":"{ token: string }","codeRef":"lib/src/features/shared/auth/login/data/auth_service.dart","notes":"auth: none. Unrouted today — superseded by /auth/customer/emailpass-verified."}},{"featureSlug":"auth","featureTitle":"Authentication","nodeSlug":"dio-auth-interceptor","nodeTitle":"Dio Auth Interceptor","call":{"method":"POST","endpoint":"/fcm/token","purpose":"Side-channel: upload the FCM push token for the active auth scope so the backend can target push to this device + role.","request":"{ token: string /* fcmToken */ } + header `Authorization: Bearer `","response":"200 / 201 (no body)","codeRef":"lib/src/core/network/dio_helper.dart:82 // _checkAndSendFcmToken","notes":"auth: bearer (per role). Fired through a separate raw Dio instance to avoid interceptor recursion. Dedup is tracked in SharedPreferences via 'fcm_sent__'."}},{"featureSlug":"home","featureTitle":"Home & App Shell","nodeSlug":"home-tos-bootstrap","nodeTitle":"Home ToS / Pending-Seller Bootstrap","call":{"method":"GET","endpoint":"/store/tos","purpose":"Fetch the latest published ToS document (id, version, content URL).","response":"{ id: string, version: string, contentUrl: string, ... } | null","codeRef":"lib/src/features/shared/home/presentation/home.dart // _checkInitialTos + lib/src/features/shared/tos/presentation/terms_of_service_screen.dart","notes":"auth: customer. Wrapped in TosApiService."}},{"featureSlug":"home","featureTitle":"Home & App Shell","nodeSlug":"home-tos-bootstrap","nodeTitle":"Home ToS / Pending-Seller Bootstrap","call":{"method":"GET","endpoint":"/store/tos/consent?termsVersion=:v","purpose":"Check whether the current user has consented to a given ToS version.","request":"Query: termsVersion=","response":"200 (consented)","errors":["404 — not yet consented"],"codeRef":"lib/src/features/shared/home/presentation/home.dart + lib/src/core/routing/app_router.dart // _verifyTosConsent","notes":"auth: customer. Result is memoized at module scope to avoid redirect spam."}},{"featureSlug":"home","featureTitle":"Home & App Shell","nodeSlug":"home-tos-bootstrap","nodeTitle":"Home ToS / Pending-Seller Bootstrap","call":{"method":"POST","endpoint":"/store/tos/consent","purpose":"Record the user's consent to a ToS version.","request":"{ termsVersion: string }","response":"200 (no body)","codeRef":"lib/src/features/shared/tos/presentation/terms_of_service_screen.dart // Accept button","notes":"auth: customer."}},{"featureSlug":"cart","featureTitle":"Cart","nodeSlug":"cart-service","nodeTitle":"Cart Service (Medusa Store API)","call":{"method":"POST","endpoint":"/store/carts","purpose":"Create a fresh Medusa cart of a given type (provision or physical).","request":"{ metadata: { type: 'provision' | 'physical' }, region_id?: string }","response":"{ cart: { id: string } }","codeRef":"lib/src/features/shared/checkout/views/checkout_screen.dart // initCheckout","notes":"auth: customer. Called once on checkout entry to promote the local cart to a server cart."}},{"featureSlug":"cart","featureTitle":"Cart","nodeSlug":"cart-service","nodeTitle":"Cart Service (Medusa Store API)","call":{"method":"GET","endpoint":"/store/carts/:cartId","purpose":"Fetch the current server-side cart (lines, totals, addresses, promotions).","response":"{ cart: Cart }","codeRef":"lib/src/features/shared/cart/views/cart_screen.dart + checkout_screen.dart","notes":"auth: customer."}},{"featureSlug":"cart","featureTitle":"Cart","nodeSlug":"cart-service","nodeTitle":"Cart Service (Medusa Store API)","call":{"method":"POST","endpoint":"/store/carts/:cartId/line-items","purpose":"Add a line item to the cart.","request":"{ variant_id: string, quantity: number }","response":"{ cart: Cart }","codeRef":"lib/src/features/shared/product_details/views/product_details_screen.dart // add-to-cart","notes":"auth: customer."}},{"featureSlug":"cart","featureTitle":"Cart","nodeSlug":"cart-service","nodeTitle":"Cart Service (Medusa Store API)","call":{"method":"POST","endpoint":"/store/carts/:cartId/line-items/:lineItemId","purpose":"Update or delete (quantity=0) a line item.","request":"{ quantity: number /* 0 deletes */ }","response":"{ cart: Cart }","codeRef":"lib/src/features/shared/cart/views/cart_screen.dart","notes":"auth: customer."}},{"featureSlug":"cart","featureTitle":"Cart","nodeSlug":"cart-service","nodeTitle":"Cart Service (Medusa Store API)","call":{"method":"POST","endpoint":"/store/carts/:cartId","purpose":"Patch arbitrary cart fields (shipping address, email, region…).","request":"Caller-provided map, e.g. { shipping_address, email }","response":"{ cart: Cart }","codeRef":"lib/src/features/shared/checkout/views/checkout_screen.dart","notes":"auth: customer."}},{"featureSlug":"cart","featureTitle":"Cart","nodeSlug":"cart-service","nodeTitle":"Cart Service (Medusa Store API)","call":{"method":"GET","endpoint":"/store/shipping-options?cart_id=:id","purpose":"List shipping options available for the cart's destination + items.","response":"{ shipping_options: ShippingOption[] }","codeRef":"lib/src/features/shared/checkout/views/widgets/checkout_shipping_options.dart","notes":"auth: customer."}},{"featureSlug":"cart","featureTitle":"Cart","nodeSlug":"cart-service","nodeTitle":"Cart Service (Medusa Store API)","call":{"method":"POST","endpoint":"/store/carts/:cartId/shipping-methods","purpose":"Attach a chosen shipping method to the cart.","request":"{ option_id: string }","response":"{ cart: Cart }","codeRef":"lib/src/features/shared/checkout/views/widgets/checkout_shipping_options.dart","notes":"auth: customer."}},{"featureSlug":"cart","featureTitle":"Cart","nodeSlug":"cart-service","nodeTitle":"Cart Service (Medusa Store API)","call":{"method":"POST","endpoint":"/store/carts/:cartId/promotions","purpose":"Apply or clear promo codes on the cart.","request":"{ promo_codes: string[] /* empty array clears */ }","response":"{ cart: Cart }","codeRef":"lib/src/features/shared/cart/views/cart_screen.dart","notes":"auth: customer. Removal currently uses empty-array semantics, not the documented DELETE endpoint."}},{"featureSlug":"cart","featureTitle":"Cart","nodeSlug":"cart-service","nodeTitle":"Cart Service (Medusa Store API)","call":{"method":"GET","endpoint":"/store/payment-providers?region_id=:id","purpose":"List payment providers configured for the cart's region.","response":"{ payment_providers: PaymentProvider[] }","codeRef":"lib/src/features/shared/checkout/views/widgets/checkout_payment_methods.dart","notes":"auth: customer."}},{"featureSlug":"cart","featureTitle":"Cart","nodeSlug":"cart-service","nodeTitle":"Cart Service (Medusa Store API)","call":{"method":"POST","endpoint":"/store/payment-collections","purpose":"Create a payment collection for the cart.","request":"{ cart_id: string }","response":"{ payment_collection: { id: string, amount: number } }","codeRef":"lib/src/features/shared/checkout/views/checkout_screen.dart","notes":"auth: customer."}},{"featureSlug":"cart","featureTitle":"Cart","nodeSlug":"cart-service","nodeTitle":"Cart Service (Medusa Store API)","call":{"method":"POST","endpoint":"/store/payment-collections/:id","purpose":"Resync the amount on an existing payment collection (e.g. after cart change).","request":"{ amount: number }","response":"{ payment_collection: PaymentCollection }","codeRef":"lib/src/features/shared/checkout/views/checkout_screen.dart","notes":"auth: customer."}},{"featureSlug":"cart","featureTitle":"Cart","nodeSlug":"cart-service","nodeTitle":"Cart Service (Medusa Store API)","call":{"method":"POST","endpoint":"/store/payment-collections/:id/payment-sessions","purpose":"Initialize a payment session with a chosen provider; returns the Stripe client_secret.","request":"{ provider_id: string }","response":"{ payment_collection: { payment_sessions: [{ provider_id, data: { client_secret } }] } }","codeRef":"lib/src/features/shared/checkout/views/checkout_screen.dart","notes":"auth: customer."}},{"featureSlug":"cart","featureTitle":"Cart","nodeSlug":"cart-service","nodeTitle":"Cart Service (Medusa Store API)","call":{"method":"POST","endpoint":"/store/payment-collections/:id/partial/payment-session","purpose":"Multi-session partial payment for booking deposits (e.g. deposit + remainder).","request":"{ providers: [{ provider_id: 'pp_partial_stripe-connect' | 'pp_system_default', amount: number }] }","response":"{ payment_collection: PaymentCollection }","codeRef":"lib/src/features/shared/checkout/views/checkout_screen.dart // booking deposits","notes":"auth: customer. Used only on bookings that allow a partial-payment policy."}},{"featureSlug":"cart","featureTitle":"Cart","nodeSlug":"cart-service","nodeTitle":"Cart Service (Medusa Store API)","call":{"method":"POST","endpoint":"/store/carts/:cartId/set-order","purpose":"Complete the cart and convert it into an order.","response":"{ order_set?: OrderSet, data?: any, order?: Order } /* shape varies by Medusa version */","codeRef":"lib/src/features/shared/checkout/views/checkout_screen.dart // Pay → completeCart","notes":"auth: customer. Three response shapes accepted (order_set → data → order) — priority order matters."}},{"featureSlug":"cart","featureTitle":"Cart","nodeSlug":"cart-service","nodeTitle":"Cart Service (Medusa Store API)","call":{"method":"GET","endpoint":"/store/carts/:cartId/line-items/:lineItemId/questions","purpose":"Fetch booking-questions for a provision line item.","response":"{ questions: BookingQuestion[] }","errors":["404 — no questions defined for this line item"],"codeRef":"lib/src/features/shared/cart/views/cart_screen.dart, checkout_booking_questions.dart","notes":"auth: customer."}},{"featureSlug":"cart","featureTitle":"Cart","nodeSlug":"cart-service","nodeTitle":"Cart Service (Medusa Store API)","call":{"method":"POST","endpoint":"/store/carts/:cartId/line-items/:lineItemId/questions/:questionId","purpose":"Persist a customer's answer to a booking question (option / comment / number / image).","request":"{ selected_option_ids?: string[], comment?: string, number?: number, image_file_id?: string }","response":"200 / 201 (no body)","codeRef":"lib/src/features/shared/checkout/views/widgets/checkout_booking_questions.dart","notes":"auth: customer."}},{"featureSlug":"cart","featureTitle":"Cart","nodeSlug":"cart-service","nodeTitle":"Cart Service (Medusa Store API)","call":{"method":"DELETE","endpoint":"/store/carts/:cartId/line-items/:lineItemId/questions/:questionId","purpose":"Clear an answer to a booking question.","response":"200 (no body)","codeRef":"lib/src/features/shared/checkout/views/widgets/checkout_booking_questions.dart","notes":"auth: customer."}},{"featureSlug":"checkout","featureTitle":"Checkout & Payment","nodeSlug":"cart-service-payment","nodeTitle":"Cart Payment Endpoints","call":{"method":"GET","endpoint":"/store/payment-providers?region_id=:id","purpose":"Resolve the payment providers wired for the cart's region.","response":"{ payment_providers: [{ id: string, ... }] }","codeRef":"lib/src/features/shared/checkout/views/widgets/checkout_payment_methods.dart","notes":"auth: customer."}},{"featureSlug":"checkout","featureTitle":"Checkout & Payment","nodeSlug":"cart-service-payment","nodeTitle":"Cart Payment Endpoints","call":{"method":"POST","endpoint":"/store/payment-collections","purpose":"Open a payment collection for the cart.","request":"{ cart_id: string }","response":"{ payment_collection: { id: string, amount: number, payment_sessions: [] } }","codeRef":"lib/src/features/shared/checkout/views/checkout_screen.dart","notes":"auth: customer."}},{"featureSlug":"checkout","featureTitle":"Checkout & Payment","nodeSlug":"cart-service-payment","nodeTitle":"Cart Payment Endpoints","call":{"method":"POST","endpoint":"/store/payment-collections/:id","purpose":"Resync the collection amount after cart mutation.","request":"{ amount: number }","response":"{ payment_collection: PaymentCollection }","codeRef":"lib/src/features/shared/checkout/views/checkout_screen.dart // amount resync","notes":"auth: customer."}},{"featureSlug":"checkout","featureTitle":"Checkout & Payment","nodeSlug":"cart-service-payment","nodeTitle":"Cart Payment Endpoints","call":{"method":"POST","endpoint":"/store/payment-collections/:id/payment-sessions","purpose":"Initialize a payment session for a single provider; returns the Stripe client_secret.","request":"{ provider_id: string }","response":"{ payment_collection: { payment_sessions: [{ provider_id, data: { client_secret } }] } }","codeRef":"lib/src/features/shared/checkout/views/checkout_screen.dart","notes":"auth: customer."}},{"featureSlug":"checkout","featureTitle":"Checkout & Payment","nodeSlug":"cart-service-payment","nodeTitle":"Cart Payment Endpoints","call":{"method":"POST","endpoint":"/store/payment-collections/:id/partial/payment-session","purpose":"Initialize multi-provider partial payments for a booking deposit (deposit + remainder).","request":"{ providers: [{ provider_id: 'pp_partial_stripe-connect' | 'pp_system_default', amount: number }] }","response":"{ payment_collection: PaymentCollection }","codeRef":"lib/src/features/shared/checkout/views/checkout_screen.dart // booking deposit","notes":"auth: customer."}},{"featureSlug":"checkout","featureTitle":"Checkout & Payment","nodeSlug":"cart-service-payment","nodeTitle":"Cart Payment Endpoints","call":{"method":"POST","endpoint":"/store/carts/:cartId/set-order","purpose":"Finalize the cart and convert it into a paid order.","response":"{ order_set?: OrderSet, data?: any, order?: Order } /* shape varies */","codeRef":"lib/src/features/shared/checkout/views/checkout_screen.dart // Pay → completeCart","notes":"auth: customer."}},{"featureSlug":"orders","featureTitle":"Orders","nodeSlug":"order-service","nodeTitle":"Order Service","call":{"method":"GET","endpoint":"/store/orders","purpose":"Customer order list (newest-first).","response":"{ orders: Order[] }","codeRef":"lib/src/features/shared/orders/views/orders_screen.dart","notes":"auth: customer. Service reverses to newest-first client-side."}},{"featureSlug":"orders","featureTitle":"Orders","nodeSlug":"order-service","nodeTitle":"Order Service","call":{"method":"GET","endpoint":"/store/orders/:orderId","purpose":"Customer order detail.","response":"{ order: Order }","codeRef":"lib/src/features/shared/orders/views/order_detail_screen.dart","notes":"auth: customer."}},{"featureSlug":"orders","featureTitle":"Orders","nodeSlug":"order-service","nodeTitle":"Order Service","call":{"method":"GET","endpoint":"/vendor/orders?fields=*customer,+payment_status,*split_order_payment&status=:status","purpose":"Seller order list with embedded customer + split-payment info.","response":"{ orders: Order[] /* with customer + splitOrderPayment */, count, offset, limit }","codeRef":"lib/src/features/shared/orders/views/orders_screen.dart // role=freelancer","notes":"auth: seller."}},{"featureSlug":"orders","featureTitle":"Orders","nodeSlug":"order-service","nodeTitle":"Order Service","call":{"method":"GET","endpoint":"/vendor/orders/:orderId?fields=*customer,+payment_status,*split_order_payment","purpose":"Seller order detail with customer + split-payment.","response":"{ order: Order }","codeRef":"lib/src/features/shared/orders/views/order_detail_screen.dart","notes":"auth: seller."}},{"featureSlug":"orders","featureTitle":"Orders","nodeSlug":"order-service","nodeTitle":"Order Service","call":{"method":"POST","endpoint":"/vendor/orders/:orderId/cancel","purpose":"Seller-initiated order cancellation and refund.","response":"{ order: { status: 'canceled', split_order_payment: { status: 'refunded', refunded_amount: number }, payment_status: 'refunded' } }","codeRef":"lib/src/features/shared/orders/views/order_detail_screen.dart // Cancel button","notes":"auth: seller."}},{"featureSlug":"marketplace","featureTitle":"Marketplace (Physical Products)","nodeSlug":"marketplace-service","nodeTitle":"Marketplace Service","call":{"method":"GET","endpoint":"/store/physical-products","purpose":"Paginated catalog of physical products with combined server-side filter, sort and search.","request":"Query (all optional): limit, offset, q, category_id[], collection_id, tag_id[], type_id, order, is_giftcard, title[$like], variants[options][value], fields=*variants.calculated_price","response":"{ products: Product[] }","codeRef":"lib/src/features/shared/marketplace/views/marketplace_home_screen.dart + widgets/marketplace_product_list.dart","notes":"auth: customer. title[$like] uses Medusa's contains operator (literal $)."}},{"featureSlug":"marketplace","featureTitle":"Marketplace (Physical Products)","nodeSlug":"marketplace-service","nodeTitle":"Marketplace Service","call":{"method":"GET","endpoint":"/store/physical-products/:productId?fields=*variants.calculated_price","purpose":"Fetch a single physical product (fallback when route extra is missing).","response":"{ product: Product }","codeRef":"lib/src/features/shared/product_details/views/product_details_screen.dart // loadProduct","notes":"auth: customer."}},{"featureSlug":"notifications","featureTitle":"Notifications & Push","nodeSlug":"notifications-controller","nodeTitle":"Notifications Controller","call":{"method":"GET","endpoint":"/social/fcm-notifications?limit=50&offset=0","purpose":"Fetch a page of in-app notifications for a specific token (called per role when both customer + seller tokens exist).","request":"Query: limit, offset + header `Authorization: Bearer `","response":"{ notifications: [{ id, template, data: { title, description }, created_at, read }, ...], count, limit, offset }","codeRef":"lib/src/features/shared/notifications/controllers/notifications_controller.dart:114 // _fetchNotifications (raw Dio)","notes":"auth: bearer (per role). Fetched once per token, then merged client-side. Uses a raw Dio to bypass DioHelper's role-based path heuristic."}},{"featureSlug":"notifications","featureTitle":"Notifications & Push","nodeSlug":"fcm-token-sync","nodeTitle":"FCM Token Sync (per-role)","call":{"method":"POST","endpoint":"/fcm/token","purpose":"Register the device's FCM token for a given auth scope so the backend can target push to this device + role.","request":"{ token: string /* fcmToken */ } + header `Authorization: Bearer ` + `x-publishable-api-key`","response":"200 / 201 (no body)","codeRef":"lib/src/core/network/dio_helper.dart:82 // _checkAndSendFcmToken","notes":"auth: bearer (per role). Fired via raw Dio (avoids interceptor recursion). Triggered on first authenticated request post-login and on onTokenRefresh. Deduped via 'fcm_sent__' SharedPreferences keys."}},{"featureSlug":"notifications","featureTitle":"Notifications & Push","nodeSlug":"mark-read-flow","nodeTitle":"Mark-as-Read Pipeline","call":{"method":"POST","endpoint":"/social/fcm-notifications/toggle-read","purpose":"Flip the read state of a single notification — fired optimistically after the UI updates.","request":"{ notification_id: string } + header `Authorization: Bearer `","response":"200 (no body)","codeRef":"lib/src/features/shared/notifications/controllers/notifications_controller.dart:178 // _toggleReadApi (raw Dio)","notes":"auth: bearer (per-notification token, NOT the active role's). Idempotent. Failure is logged but not surfaced; markAllAsRead fires one POST per unread (no batch endpoint yet)."}},{"featureSlug":"profile","featureTitle":"Profile & Profile Setup","nodeSlug":"user-service","nodeTitle":"UserService","call":{"method":"GET","endpoint":"/store/customers/me","purpose":"Fetch the authenticated customer's full profile (identity + addresses + metadata).","response":"CustomerProfileResponse { id, first_name, last_name, email, phone, addresses[], metadata }","codeRef":"lib/src/features/shared/profile/profile_details.dart, profile_tab_page.dart, manage_profile.dart // preload","notes":"auth: customer."}},{"featureSlug":"profile","featureTitle":"Profile & Profile Setup","nodeSlug":"user-service","nodeTitle":"UserService","call":{"method":"POST","endpoint":"/store/customers/me","purpose":"Update the authenticated customer's profile (changed fields only).","request":"CustomerProfileRequest { first_name?, last_name?, phone?, addresses?: Address[], ... }","response":"CustomerProfileResponse","codeRef":"lib/src/features/shared/manage-profile/manage_profile.dart // Save","notes":"auth: customer. Partial-update semantics — only changed fields are sent."}},{"featureSlug":"profile","featureTitle":"Profile & Profile Setup","nodeSlug":"user-service","nodeTitle":"UserService","call":{"method":"GET","endpoint":"/store/customers/me/personal-info","purpose":"Fetch a lighter profile slice used by header widgets (display name, avatar, role badges).","response":"PersonalInfoResponse { displayName: string, photo: string, /* role-specific badges */ ... }","codeRef":"lib/src/features/shared/profile/widgets/seaven_profile_header.dart, instagram_profile_header.dart","notes":"auth: customer."}},{"featureSlug":"search","featureTitle":"Search (Sellers + Places)","nodeSlug":"sellers-data-source","nodeTitle":"Sellers Data Source","call":{"method":"GET","endpoint":"/store/seller?offset=:offset&limit=:limit","purpose":"Paginated list of sellers for the seller-handle search screen.","request":"Query: offset, limit","response":"{ sellers: [{ id, name, handle, photo, store_status, trades: [...] }, ...], count }","codeRef":"lib/src/features/shared/search/search.dart","notes":"auth: customer. Called directly via DioHelper.get from SellersNotifier (no SellersService yet)."}},{"featureSlug":"search","featureTitle":"Search (Sellers + Places)","nodeSlug":"sellers-data-source","nodeTitle":"Sellers Data Source","call":{"method":"GET","endpoint":"/store/seller/:handle","purpose":"Fetch a single seller's public detail page (profile + products + prestations + reviews).","response":"{ seller: { id, name, handle, photo, ..., products, prestations, reviews } }","codeRef":"lib/src/features/shared/search/screens/seller_detail_screen.dart","notes":"auth: customer. Mapping may be by id depending on backend — sellerDetailProvider handles both."}},{"featureSlug":"search","featureTitle":"Search (Sellers + Places)","nodeSlug":"geoapify-service","nodeTitle":"Geoapify Service","call":{"method":"GET","endpoint":"https://api.geoapify.com/v1/geocode/autocomplete","purpose":"Place autocomplete for address fields across search, map picker, checkout, prestation.","request":"Query: text=:q, limit=:n, format=json, apiKey=:GEOAPIFY_API_KEY, bias?=proximity:,","response":"{ results: GeoapifyResult[] } → mapped to MapPlaceSuggestion[]","codeRef":"lib/src/core/services/geoapify_service.dart:20 // autocomplete","notes":"auth: API key in query. Bias uses Geoapify's lon,lat ordering. Default 5s timeout — flaky network surfaces as empty list, not error."}},{"featureSlug":"search","featureTitle":"Search (Sellers + Places)","nodeSlug":"geoapify-service","nodeTitle":"Geoapify Service","call":{"method":"GET","endpoint":"https://api.geoapify.com/v1/geocode/search","purpose":"Forward-geocode a single query string to a place.","request":"Query: text=:q, limit=1, format=json, apiKey=:GEOAPIFY_API_KEY","response":"{ results: [first] } → MapPlaceSuggestion | null","codeRef":"lib/src/core/services/geoapify_service.dart:56 // geocode","notes":"auth: API key in query."}},{"featureSlug":"search","featureTitle":"Search (Sellers + Places)","nodeSlug":"geoapify-service","nodeTitle":"Geoapify Service","call":{"method":"GET","endpoint":"https://api.geoapify.com/v1/geocode/reverse","purpose":"Reverse-geocode a (lat, lon) pair to a place suggestion (map picker, prestation).","request":"Query: lat=:lat, lon=:lon, limit=1, format=json, apiKey=:GEOAPIFY_API_KEY","response":"MapPlaceSuggestion | null","codeRef":"lib/src/core/services/geoapify_service.dart:80 // reverseGeocode","notes":"auth: API key in query."}},{"featureSlug":"seller-services","featureTitle":"Seller Services (Provisions)","nodeSlug":"add-prestation-controller","nodeTitle":"Add Prestation Wizard Controller","call":{"method":"GET","endpoint":"/vendor/categories","purpose":"Top-level seller_services categories for the category picker.","response":"{ seller_services: [{ id, name, ... }, ...] }","codeRef":"lib/src/features/seller/add-prestation/provider/add_product_provider.dart:21 // vendorProductCategoriesProvider","notes":"auth: seller. Direct DioHelper call from the Riverpod provider."}},{"featureSlug":"seller-services","featureTitle":"Seller Services (Provisions)","nodeSlug":"add-prestation-controller","nodeTitle":"Add Prestation Wizard Controller","call":{"method":"GET","endpoint":"/vendor/categories/:parentId","purpose":"Sub-categories of a chosen parent category.","response":"{ categories: Category[] }","codeRef":"lib/src/features/seller/add-prestation/provider/add_product_provider.dart:44 // vendorSubCategoriesProvider","notes":"auth: seller."}},{"featureSlug":"seller-services","featureTitle":"Seller Services (Provisions)","nodeSlug":"add-prestation-controller","nodeTitle":"Add Prestation Wizard Controller","call":{"method":"POST","endpoint":"/vendor/files","purpose":"Multipart upload of the wizard's thumbnail / images before submit.","request":"FormData({ file: File, purpose: 'public' })","response":"{ url: string }","codeRef":"lib/src/features/seller/add-prestation/add-prestation.dart + thumbnail.dart // via VendorService.uploadPublicFile","notes":"auth: seller."}},{"featureSlug":"seller-services","featureTitle":"Seller Services (Provisions)","nodeSlug":"vendor-service","nodeTitle":"VendorService (Provisions Slice)","call":{"method":"GET","endpoint":"/vendor/provisions","purpose":"List the seller's provisions (services), including proposed + published.","response":"{ products: Product[] /* seller-scoped */ }","codeRef":"lib/src/features/seller/services/services.dart // via vendor_service.dart:21","notes":"auth: seller."}},{"featureSlug":"seller-services","featureTitle":"Seller Services (Provisions)","nodeSlug":"vendor-service","nodeTitle":"VendorService (Provisions Slice)","call":{"method":"GET","endpoint":"/vendor/products/:id","purpose":"Provision detail (preload for the service-details screen).","response":"{ product: { id, title, description, options: [...], variants: [...], metadata, status } }","codeRef":"lib/src/features/seller/service_details/service_details.dart","notes":"auth: seller."}},{"featureSlug":"seller-services","featureTitle":"Seller Services (Provisions)","nodeSlug":"vendor-service","nodeTitle":"VendorService (Provisions Slice)","call":{"method":"POST","endpoint":"/vendor/provisions","purpose":"Create a new provision (3-step wizard's main submit).","request":"{ title, subtitle?, description, status: 'proposed', is_giftcard, discountable, handle, thumbnail, images: [{ url }], options: [{ title, values: [...] }], variants: [{ title, sku, prices: [{ currency_code, amount }], options: { : } }] }","response":"{ product: Product }","codeRef":"lib/src/features/seller/add-prestation/add-prestation.dart // CreatePrestationScreen","notes":"auth: seller."}},{"featureSlug":"seller-services","featureTitle":"Seller Services (Provisions)","nodeSlug":"vendor-service","nodeTitle":"VendorService (Provisions Slice)","call":{"method":"POST","endpoint":"/vendor/provisions/:id","purpose":"Update a provision (partial).","request":"Partial product fields","response":"{ product: Product }","codeRef":"lib/src/features/seller/service_details/edit_provision_screen.dart","notes":"auth: seller."}},{"featureSlug":"seller-services","featureTitle":"Seller Services (Provisions)","nodeSlug":"vendor-service","nodeTitle":"VendorService (Provisions Slice)","call":{"method":"POST","endpoint":"/vendor/products/:id/options/:optionId","purpose":"Update a product option (title + values).","request":"{ title: string, values: string[] }","response":"{ option: ProductOption }","codeRef":"lib/src/features/seller/service_details/edit_provision_screen.dart","notes":"auth: seller."}},{"featureSlug":"seller-services","featureTitle":"Seller Services (Provisions)","nodeSlug":"vendor-service","nodeTitle":"VendorService (Provisions Slice)","call":{"method":"POST","endpoint":"/vendor/products/:id/variants/:variantId","purpose":"Update a variant (prices, title, sku).","request":"{ prices: [...], title?: string, sku?: string }","response":"{ variant: Variant }","codeRef":"lib/src/features/seller/service_details/edit_provision_screen.dart","notes":"auth: seller."}},{"featureSlug":"seller-services","featureTitle":"Seller Services (Provisions)","nodeSlug":"vendor-service","nodeTitle":"VendorService (Provisions Slice)","call":{"method":"DELETE","endpoint":"/vendor/provisions/:id","purpose":"Delete a provision (services screen).","response":"200 (no body)","errors":["409 — active future bookings reference this provision"],"codeRef":"lib/src/features/seller/services/services.dart // Delete confirm","notes":"auth: seller."}},{"featureSlug":"seller-services","featureTitle":"Seller Services (Provisions)","nodeSlug":"vendor-service","nodeTitle":"VendorService (Provisions Slice)","call":{"method":"GET","endpoint":"/vendor/members","purpose":"List the seller's members for the member-assignment step.","response":"{ members: [{ id: string, ... }] }","codeRef":"lib/src/features/seller/add-prestation/add-prestation.dart // member assignment step","notes":"auth: seller."}},{"featureSlug":"seller-services","featureTitle":"Seller Services (Provisions)","nodeSlug":"vendor-service","nodeTitle":"VendorService (Provisions Slice)","call":{"method":"POST","endpoint":"/vendor/members/:memberId/provisions","purpose":"Bind selected provisions to a member with their working hours, slot duration, exceptions and location.","request":"{ provision_ids: string[], workingHour: { week: { mon: [{ start, end }], tue: [...], ..., sun: [] } }, slotDuration: number /* minutes */, exceptions: { 'YYYY-MM-DD': [{ start, end }] | [] }, location: { lat, lng } }","response":"{ ... }","codeRef":"lib/src/features/seller/add-prestation/add-prestation.dart // step 3 submit, via vendor_service.dart:292","notes":"auth: seller."}},{"featureSlug":"seller-services","featureTitle":"Seller Services (Provisions)","nodeSlug":"vendor-service","nodeTitle":"VendorService (Provisions Slice)","call":{"method":"POST","endpoint":"/vendor/product-location/:productId","purpose":"Pin a geographic location on the provision (post member-assign).","request":"{ lat: number, lng: number, address?: string }","response":"{ ... }","codeRef":"lib/src/features/seller/add-prestation/add-prestation.dart // post-assign step","notes":"auth: seller."}},{"featureSlug":"seller-services","featureTitle":"Seller Services (Provisions)","nodeSlug":"vendor-service","nodeTitle":"VendorService (Provisions Slice)","call":{"method":"GET","endpoint":"/vendor/bookings/policy/:productId","purpose":"Read the booking policy attached to a provision (deposit %, cancellation window, refund rules).","response":"{ policy: { id, deposit_percentage, max_cancellation_delay_hours, rules: [{ hours_before, refund_percentage }, ...] } }","errors":["404 — no policy set yet"],"codeRef":"lib/src/features/seller/service_details/service_details.dart (read), edit_provision_screen.dart (preload)","notes":"auth: seller."}},{"featureSlug":"seller-services","featureTitle":"Seller Services (Provisions)","nodeSlug":"vendor-service","nodeTitle":"VendorService (Provisions Slice)","call":{"method":"POST","endpoint":"/vendor/bookings/policy","purpose":"Create or update the booking policy for a provision.","request":"{ product_id: string, deposit_percentage: number, max_cancellation_delay_hours: number, rules: [{ hours_before, refund_percentage }, ...] }","response":"{ policy: BookingPolicy }","codeRef":"lib/src/features/seller/add-prestation/add-prestation.dart (final step), edit_provision_screen.dart (policy editor)","notes":"auth: seller."}},{"featureSlug":"seller-services","featureTitle":"Seller Services (Provisions)","nodeSlug":"provision-service-customer","nodeTitle":"ProvisionService (Customer-side)","call":{"method":"GET","endpoint":"/store/provisions","purpose":"Customer view of published provisions for the marketplace home / client grid tile.","request":"Query: limit, offset, q?, category_id[i], collection_id[]?, tag_id[i]?, type_id[]?, order?, fields=*variants.calculated_price,*reviews,*reviews.customer","response":"{ products: Product[] }","codeRef":"lib/src/features/shared/provision_marketplace/views/provision_marketplace_home_screen.dart, lib/src/features/shared/home/presentation/widgets/first_page.dart","notes":"auth: customer."}},{"featureSlug":"seller-services","featureTitle":"Seller Services (Provisions)","nodeSlug":"provision-service-customer","nodeTitle":"ProvisionService (Customer-side)","call":{"method":"GET","endpoint":"/store/product-location","purpose":"Map-driven nearby provisions search (lat/lng/radius).","request":"Query: lat, lng, radius, q?, type_id[]?, category_id[i]","response":"{ locations: Product[] /* location-shaped */ }","codeRef":"lib/src/features/shared/map/*","notes":"auth: customer."}},{"featureSlug":"seller-services","featureTitle":"Seller Services (Provisions)","nodeSlug":"provision-service-customer","nodeTitle":"ProvisionService (Customer-side)","call":{"method":"GET","endpoint":"/store/provisions/:id?fields=*variants.calculated_price,+variants.inventory_quantity,*seller,*reviews,*reviews.customer","purpose":"Provision detail (full payload with seller + reviews + per-variant pricing).","response":"{ product: Product /* with seller + reviews */ }","codeRef":"lib/src/features/shared/provision_details/views/provision_details_screen.dart","notes":"auth: customer."}},{"featureSlug":"seller-services","featureTitle":"Seller Services (Provisions)","nodeSlug":"provision-service-customer","nodeTitle":"ProvisionService (Customer-side)","call":{"method":"GET","endpoint":"/store/provisions/:id?fields=metadata","purpose":"Metadata-only slice used by the booking screen.","response":"{ product: Product /* metadata only */ }","codeRef":"lib/src/features/shared/provision_details/views/provision_booking_screen.dart","notes":"auth: customer."}},{"featureSlug":"seller-services","featureTitle":"Seller Services (Provisions)","nodeSlug":"provision-service-customer","nodeTitle":"ProvisionService (Customer-side)","call":{"method":"GET","endpoint":"/store/provisions/:productId/slots","purpose":"Available booking slots used by the calendar.","response":"{ slots: ProvisionSlot[] }","codeRef":"lib/src/features/shared/provision_details/views/provision_booking_screen.dart","notes":"auth: customer."}},{"featureSlug":"seller-services","featureTitle":"Seller Services (Provisions)","nodeSlug":"provision-service-customer","nodeTitle":"ProvisionService (Customer-side)","call":{"method":"GET","endpoint":"/store/provisions/:productId/policy","purpose":"Customer view of the provision's booking policy (deposit %, cancellation window, refund rules).","response":"{ policy: { deposit_percentage, max_cancellation_delay_hours, rules: [...] } }","codeRef":"lib/src/features/shared/provision_details/views/provision_booking_screen.dart, lib/src/features/shared/checkout/views/widgets/checkout_booking_policy.dart","notes":"auth: customer."}},{"featureSlug":"seller-services","featureTitle":"Seller Services (Provisions)","nodeSlug":"provision-service-customer","nodeTitle":"ProvisionService (Customer-side)","call":{"method":"GET","endpoint":"/store/provisions/:productId/booking-questions","purpose":"Booking questions the customer must answer before checkout.","response":"{ booking_questions: [{ id, question_text, type, is_required, options? }, ...] }","errors":["404 — no questions defined for this provision"],"codeRef":"lib/src/features/shared/provision_details/views/provision_booking_screen.dart, lib/src/features/shared/checkout/views/widgets/checkout_booking_questions.dart","notes":"auth: customer."}},{"featureSlug":"seller-products","featureTitle":"Seller Products (Physical)","nodeSlug":"vendor-service-products","nodeTitle":"VendorService — Physical Products Slice","call":{"method":"GET","endpoint":"/vendor/products?type=physical","purpose":"Typed list of the seller's physical products (Product[]).","response":"{ products: Product[] } /* typed */","codeRef":"lib/src/core/services/vendor_service.dart:176 // getPhysicalProducts","notes":"auth: seller. Consumed by seller_products_screen.dart."}},{"featureSlug":"seller-products","featureTitle":"Seller Products (Physical)","nodeSlug":"vendor-service-products","nodeTitle":"VendorService — Physical Products Slice","call":{"method":"GET","endpoint":"/vendor/products?type=physical","purpose":"Raw-map variant used to skip Product.fromJson when the screen only needs a subset.","response":"List> raw","codeRef":"lib/src/core/services/vendor_service.dart // getPhysicalProductsRaw","notes":"auth: seller. Same URL as the typed version, different parsing path."}},{"featureSlug":"seller-products","featureTitle":"Seller Products (Physical)","nodeSlug":"vendor-service-products","nodeTitle":"VendorService — Physical Products Slice","call":{"method":"GET","endpoint":"/vendor/products/:id","purpose":"Preload a single product for the edit screen.","response":"{ product: Product }","codeRef":"lib/src/features/seller/products/edit_product_screen.dart","notes":"auth: seller."}},{"featureSlug":"seller-products","featureTitle":"Seller Products (Physical)","nodeSlug":"vendor-service-products","nodeTitle":"VendorService — Physical Products Slice","call":{"method":"POST","endpoint":"/vendor/products","purpose":"Create a new physical product with options + variants + images.","request":"{ title, description, status, options: [{ title, values }], variants: [{ title, sku, prices: [{ currency_code, amount }], options: { : <value> } }], images: [{ url }], thumbnail, ... }","response":"{ product: { id: string, variants: [{ id, inventory_item_id }, ...] } }","codeRef":"lib/src/features/seller/products/create_product_screen.dart // via vendor_service.dart:230","notes":"auth: seller. Returned inventory_item_ids are needed for the subsequent location-levels calls."}},{"featureSlug":"seller-products","featureTitle":"Seller Products (Physical)","nodeSlug":"vendor-service-products","nodeTitle":"VendorService — Physical Products Slice","call":{"method":"POST","endpoint":"/vendor/products/:id","purpose":"Update product fields (partial).","request":"Partial product fields","response":"{ product: Product }","codeRef":"lib/src/features/seller/products/edit_product_screen.dart // via vendor_service.dart:250","notes":"auth: seller."}},{"featureSlug":"seller-products","featureTitle":"Seller Products (Physical)","nodeSlug":"vendor-service-products","nodeTitle":"VendorService — Physical Products Slice","call":{"method":"DELETE","endpoint":"/vendor/products/:id","purpose":"Delete a physical product.","response":"200 (no body)","codeRef":"lib/src/features/seller/products/seller_products_screen.dart // Delete confirm","notes":"auth: seller."}},{"featureSlug":"seller-products","featureTitle":"Seller Products (Physical)","nodeSlug":"vendor-service-products","nodeTitle":"VendorService — Physical Products Slice","call":{"method":"GET","endpoint":"/vendor/stock-locations","purpose":"Bootstrap the list of stock locations (warehouse / store).","response":"{ stock_locations: [{ id, name, ... }] }","codeRef":"lib/src/features/seller/products/create_product_screen.dart // location bootstrap","notes":"auth: seller."}},{"featureSlug":"seller-products","featureTitle":"Seller Products (Physical)","nodeSlug":"vendor-service-products","nodeTitle":"VendorService — Physical Products Slice","call":{"method":"POST","endpoint":"/vendor/stock-locations","purpose":"Create a first-time stock location.","request":"{ name: string, address?: any }","response":"{ stock_location: StockLocation }","codeRef":"lib/src/features/seller/products/create_product_screen.dart // first-time creation","notes":"auth: seller."}},{"featureSlug":"seller-products","featureTitle":"Seller Products (Physical)","nodeSlug":"vendor-service-products","nodeTitle":"VendorService — Physical Products Slice","call":{"method":"POST","endpoint":"/vendor/inventory-items/:id/location-levels","purpose":"Set initial stocked_quantity for a variant at a stock location.","request":"{ location_id: string, stocked_quantity: number }","response":"{ ... }","codeRef":"lib/src/features/seller/products/create_product_screen.dart","notes":"auth: seller. Called per variant post product-create."}},{"featureSlug":"seller-products","featureTitle":"Seller Products (Physical)","nodeSlug":"vendor-service-products","nodeTitle":"VendorService — Physical Products Slice","call":{"method":"POST","endpoint":"/vendor/inventory-items/:id/location-levels/:levelId","purpose":"Update a variant's stocked_quantity at an existing location level.","request":"{ stocked_quantity: number }","response":"{ ... }","codeRef":"lib/src/features/seller/products/edit_product_screen.dart // variant stock change","notes":"auth: seller."}},{"featureSlug":"seller-products","featureTitle":"Seller Products (Physical)","nodeSlug":"vendor-service-products","nodeTitle":"VendorService — Physical Products Slice","call":{"method":"POST","endpoint":"/vendor/product-location/:productId","purpose":"Attach a geographic location (lat/lng/address) to a product.","request":"{ lat: number, lng: number, address?: string }","response":"{ ... }","codeRef":"lib/src/features/seller/products/create_product_screen.dart // post-create","notes":"auth: seller."}},{"featureSlug":"seller-products","featureTitle":"Seller Products (Physical)","nodeSlug":"vendor-service-products","nodeTitle":"VendorService — Physical Products Slice","call":{"method":"POST","endpoint":"/vendor/files","purpose":"Multipart upload of a product image to the vendor files endpoint.","request":"FormData({ file: File, purpose: 'public' })","response":"{ url: string }","codeRef":"lib/src/core/services/vendor_service.dart:650 // uploadPublicFile","notes":"auth: seller. Used by both create + edit product screens for image upload."}},{"featureSlug":"seller-products","featureTitle":"Seller Products (Physical)","nodeSlug":"marketplace-service-detail","nodeTitle":"MarketplaceService.getProductById (customer detail)","call":{"method":"GET","endpoint":"/store/physical-products/:productId?fields=*variants.calculated_price","purpose":"Customer-side single product fetch (fallback when ProductDetailScreen has no route extra).","response":"{ product: Product }","errors":["product not found → thrown as 'Product not found', surfaced as state.error"],"codeRef":"lib/src/features/shared/product_details/views/product_details_screen.dart // loadProduct","notes":"auth: customer. calculated_price requires the explicit fields query."}},{"featureSlug":"seller-balance","featureTitle":"Seller Balance & Payouts","nodeSlug":"stripe-service","nodeTitle":"StripeService","call":{"method":"GET","endpoint":"/vendor/stripe/payout-account","purpose":"Read the current Stripe Connect payout account state.","response":"PayoutAccountModel | null","errors":["404 / 400 / 403 / 401 are swallowed as null (treated as 'no account yet')"],"codeRef":"lib/src/features/seller/bank_account/views/bank_account_screen.dart // initial load","notes":"auth: seller bearer."}},{"featureSlug":"seller-balance","featureTitle":"Seller Balance & Payouts","nodeSlug":"stripe-service","nodeTitle":"StripeService","call":{"method":"POST","endpoint":"/vendor/stripe/payout-account","purpose":"Submit Step 1 of onboarding: account_token from Stripe → backend creates the Connect account.","request":"{ account_token: string /* ct_... */ }","response":"PayoutAccountModel","codeRef":"lib/src/features/seller/bank_account/views/bank_account_screen.dart // Step 1 submit","notes":"auth: seller bearer."}},{"featureSlug":"seller-balance","featureTitle":"Seller Balance & Payouts","nodeSlug":"stripe-service","nodeTitle":"StripeService","call":{"method":"POST","endpoint":"/vendor/stripe/bank_account","purpose":"Submit Step 2 of onboarding: bank_token from Stripe → backend attaches the bank account.","request":"{ bank_token: string /* btok_... */ }","response":"{ ... }","codeRef":"lib/src/features/seller/bank_account/views/bank_account_screen.dart // Step 2 submit","notes":"auth: seller bearer."}},{"featureSlug":"seller-balance","featureTitle":"Seller Balance & Payouts","nodeSlug":"stripe-service","nodeTitle":"StripeService","call":{"method":"POST","endpoint":"/vendor/stripe/verify-identity","purpose":"Submit Step 3 of onboarding: front-of-document file id → backend submits identity to Stripe.","request":"{ front_file_id: string /* file_... */ }","response":"{ ... }","codeRef":"lib/src/features/seller/bank_account/views/bank_account_screen.dart // Step 3 submit","notes":"auth: seller bearer."}},{"featureSlug":"seller-balance","featureTitle":"Seller Balance & Payouts","nodeSlug":"stripe-service","nodeTitle":"StripeService","call":{"method":"GET","endpoint":"/vendor/stripe/account","purpose":"Refresh the full Stripe account JSON after onboarding completes.","response":"Stripe account JSON | null","codeRef":"lib/src/features/seller/bank_account/views/bank_account_screen.dart // refresh after step 3","notes":"auth: seller bearer."}},{"featureSlug":"seller-balance","featureTitle":"Seller Balance & Payouts","nodeSlug":"stripe-service","nodeTitle":"StripeService","call":{"method":"GET","endpoint":"/vendor/stripe/balance","purpose":"Available + pending balance in cents.","response":"BalanceModel { available, pending /* cents */ } | null","codeRef":"lib/src/features/seller/balance/views/balance_screen.dart","notes":"auth: seller bearer."}},{"featureSlug":"seller-balance","featureTitle":"Seller Balance & Payouts","nodeSlug":"stripe-service","nodeTitle":"StripeService","call":{"method":"GET","endpoint":"/vendor/stripe/transactions","purpose":"Paginated list of seller transactions.","response":"{ transactions: TransactionModel[] }","codeRef":"lib/src/features/seller/balance/views/balance_screen.dart","notes":"auth: seller bearer."}},{"featureSlug":"seller-balance","featureTitle":"Seller Balance & Payouts","nodeSlug":"stripe-service","nodeTitle":"StripeService","call":{"method":"GET","endpoint":"/vendor/stripe/transactions/:id","purpose":"Transaction detail (rendered in a bottom sheet).","response":"TransactionDetailModel | null","codeRef":"lib/src/features/seller/balance/widgets/transaction_detail_sheet.dart","notes":"auth: seller bearer."}},{"featureSlug":"seller-balance","featureTitle":"Seller Balance & Payouts","nodeSlug":"stripe-service","nodeTitle":"StripeService","call":{"method":"POST","endpoint":"https://api.stripe.com/v1/tokens","purpose":"Direct Stripe call (Step 1): tokenize personal account details into an account token (ct_...).","request":"form-urlencoded: account[individual][first_name|last_name|email|phone|dob[day|month|year]], account[individual][address][line1|city|state|postal_code|country], account[business_type], account[tos_shown_and_accepted]='true'","response":"{ id: 'ct_...' }","codeRef":"lib/src/features/seller/bank_account/views/bank_account_screen.dart // Step 1, via stripe_service.dart:127","notes":"auth: Bearer = STRIPE_PUBLISHABLE_KEY. Hits api.stripe.com directly."}},{"featureSlug":"seller-balance","featureTitle":"Seller Balance & Payouts","nodeSlug":"stripe-service","nodeTitle":"StripeService","call":{"method":"POST","endpoint":"https://api.stripe.com/v1/tokens","purpose":"Direct Stripe call (Step 2): tokenize bank account details into a bank token (btok_...).","request":"form-urlencoded: bank_account[country|currency|account_holder_name|account_holder_type|account_number]","response":"{ id: 'btok_...' }","codeRef":"lib/src/features/seller/bank_account/views/bank_account_screen.dart // Step 2, via stripe_service.dart:152","notes":"auth: Bearer = STRIPE_PUBLISHABLE_KEY."}},{"featureSlug":"seller-balance","featureTitle":"Seller Balance & Payouts","nodeSlug":"stripe-service","nodeTitle":"StripeService","call":{"method":"POST","endpoint":"https://files.stripe.com/v1/files","purpose":"Direct Stripe call (Step 3): upload identity document and receive a file_id.","request":"FormData({ file: File, purpose: 'identity_document' })","response":"{ id: 'file_...' }","codeRef":"lib/src/features/seller/bank_account/views/bank_account_screen.dart // Step 3, via stripe_service.dart:210 // uploadFileToStripe","notes":"auth: Bearer = STRIPE_PUBLISHABLE_KEY. Hits files.stripe.com."}}],"environments":"$undefined"}]]}]] </article></body></html>

API Catalog

/auth11

/fcm2

/https:6

/social2

/store44

/vendor38

`/auth`11

`/fcm`2

`/https:`6

`/social`2

`/store`44

`/vendor`38