Avidan Partner Portal
Collaborator workspace
Programs
0
Visible after approval
Customers
0
Lifetime attributed
Revenue
€0
Partner-scoped ledger
Pending
€0
Commission and margin due
Agent access
Partner-scoped workspace for approved affiliates, dropshippers, agents, and API collaborators. Normal B2B customers are separate and do not appear here.
Affiliate
Traffic, content, and publicity to our websites
Affiliates use friendly URLs for approved sites. When a new customer is first accepted through that link, OF2 creates lifetime attribution for that customer on that site. Commission stays connected to the customer forever, with no cookie-window tricks and no cache reset problem.
Retail starting model: 25% partner pool from retail price, split between customer discount and affiliate commission as approved per program.
Dropshipper
Their sale, our warehouse fulfillment
Dropshippers are closer to B2B operators, but they are still not normal B2B customers. They sell on their own website or channel, submit the customer delivery address to OF2, and we ship the order. Their margin/discount is governed by a dropship tariff, shipping rules, MOQ, taxes, and market restrictions.
B2B placeholder until Adam finalizes site tariffs: wholesale base price plus approved uplift/margin, plus shipping. Retail dropship can use the 25% partner pool.
Affiliate rule
A referred customer belongs to the approved affiliate for life on that website after first accepted attribution. The system is not based on short cookie expiry, browser cache, or resettable sessions.
Allowed sites
Agent-ready service layer
Partner API v1 manual
This is the public-facing contract for collaborator automation: affiliates, dropshippers, and approved buyer agents get scoped access to OF2 services without touching private admin data or storefront internals.
Auth
Bearer partner API keys
Per collaborator, per program, per site scope.
Writes
Idempotency-Key required
Prevents duplicate links, quotes, imports, and orders.
Security
Audit log on every request
No cross-collaborator data, no B2B leak into retail.
Commercial rules
These rules sit above every endpoint: links, quotes, dropship orders, commissions, payouts, and content.
IBAN bank-transfer payouts only
iban_only_payoutsCollaborator payouts are paid by bank transfer to a verified IBAN account. No PayPal, card payout, crypto, wallet, or informal payment method is part of the production model.
Collect payout account holder, IBAN country, IBAN last4, verification status, and encrypted IBAN payload before any payout batch can be approved.
Retail programs use a 25% partner pool
retail_25_poolRetail affiliate/dropship programs start from a 25% partner pool against retail price. The collaborator can keep it as commission or pass part of it forward as a customer discount.
Link and quote creation must carry collaborator_discount_percent and collaborator_commission_percent, with their sum capped at the approved retail partner pool.
Website MOQ and shipping rules always apply
website_rules_always_applyEvery collaborator order respects the minimum order, shipping cost, taxes, market restrictions, and checkout rules of the website that owns the order.
Quote and dropship-order validation must evaluate site MOQ and shipping policy before the order can become payable or fulfillable.
Lifetime customer attribution
lifetime_attributionA customer first brought by an affiliate is tagged to that affiliate for life. OF2 does not play 30/60/90-day cookie games for payable attribution.
The first accepted affiliate attribution creates a durable customer-site-collaborator record. Later cookie/session data can enrich source analytics but cannot silently steal the customer.
B2B/wholesale needs a separate margin policy
b2b_margin_policyWholesale and B2B websites cannot use the same retail 25% rule because tier pricing, tariff discounts, MOQ, and shipping economics are different.
For B2B dropship orders below normal MOQ, quote from wholesale base plus an approved uplift/margin policy, plus shipping. The first working placeholder is wholesale price + 30% until Adam finalizes per-site rules.
Read-only client and order transparency
partner_client_transparencyCollaborators can see the customers attributed to them, those customers' order history, products ordered, repeat orders, and commission generated per order. They cannot see unrelated customers.
Partner client/order endpoints are read-only, scoped to lifetime attribution records, and do not allow collaborator-to-customer messaging or customer data edits.
Service endpoints
The contract is intentionally service-based so collaborator AIs can automate one job at a time.
Identity and access
Collaborator agents authenticate with scoped API keys, idempotency keys, and full audit trails.
/api/partner/v1/me
Return the collaborator, programs, scopes, allowed sites, and current limits.
/api/partner/v1/api-keys
Create or rotate keys from the Partner PWA after human approval.
/api/partner/v1/payout-account
Submit or update the collaborator's verified IBAN payout account for bank-transfer payouts only.
Catalog and quote
Agents can search approved catalogs and build compliant quotes without seeing private OF2 data.
/api/partner/v1/catalog
Search products by site, locale, market, price tier, availability, and compliance flags.
/api/partner/v1/quotes
Create a priced quote with retail/B2B commission rules, VAT checks, website MOQ, shipping, and B2B uplift policy.
Affiliate links and attribution
Affiliates and their agents can create campaigns, friendly URLs, and monitor conversion.
/api/partner/v1/links
Create friendly URLs and campaign links for approved sites/projects.
/api/partner/v1/attribution
Read clicks, sessions, lifetime-tagged customers, orders, conversion rate, commission status, and content source.
/api/partner/v1/clients
List only the customers lifetime-attributed to the authenticated collaborator, with revenue and commission rollups.
/api/partner/v1/clients/{customer_id}
Read one attributed customer profile, repeat-order history, order totals, product summary, and commission summary.
/api/partner/v1/clients/{customer_id}/orders
Read the attributed customer's order history, ordered products, order value, and collaborator commission per order.
/api/partner/v1/links/{link_id}/discount
Allocate part of the approved retail 25% partner pool as a customer-facing discount and keep the rest as commission.
Dropship orders
Dropshippers can place customer orders, upload CSV batches, and track fulfillment from one API.
/api/partner/v1/dropship/orders
Create one dropship order with shipping address, products, customer reference, site MOQ/shipping validation, and retail/B2B margin policy.
/api/partner/v1/dropship/imports
Upload or submit batch orders with validation results before commit.
/api/partner/v1/orders/{order_id}
Read status, tracking, invoices, incidents, payments, and collaborator-visible notes.
Commissions and payouts
Collaborators can reconcile money without asking ops for screenshots or manual exports.
/api/partner/v1/commissions
Read pending, approved, disputed, and paid commission ledger entries.
/api/partner/v1/payouts
Read IBAN bank-transfer payout batches, status, tax/VAT notes, and remittance documents.
Messages, notifications, and webhooks
Agents can react to changes in real time instead of polling the Partner PWA.
/api/partner/v1/messages
Read collaborator-visible OF2 messages and system notices.
/api/partner/v1/messages
Send a collaborator dashboard/API message into OF2 Ops.
/api/partner/v1/webhooks
Register webhook targets for order, tracking, payout, link, approval, and API-key events.
/api/partner/v1/notifications/subscribe
Register PWA push subscriptions for collaborator users and approved agent owners.
Content and SEO distribution
Approved partners can request campaign assets and publish useful content without brand drift.
/api/partner/v1/content/briefs
Read campaign briefs, allowed claims, blocked claims, keywords, image rules, target URLs, and lifetime-attribution SEO messaging.
/api/partner/v1/content/drafts
Submit partner/agent content drafts for review, tracking, and SEO attribution.
Machine-readable API manual
Collaborator AIs can discover the contract, schemas, scopes, and future endpoints programmatically.
/api/partner/v1/openapi
Return the current Partner API v1 OpenAPI contract.
Scopes
Rollout flow
Foundation
Publish the PWA manual, OpenAPI contract, scopes, auth model, idempotency rules, and endpoint map.
Read-only data
Ship me, catalog, links, lifetime attribution, attributed clients, client order history, commissions, IBAN payout status, and messages as safe read endpoints.
Controlled writes
Enable quote creation, link creation, collaborator discount allocation, IBAN payout account submission, dropship order drafts, content draft submission, and webhook registration.
Automation
Enable agent API keys, rate limits, webhooks, PWA push events, audit logs, and partner-facing incident states.
Public growth
Publish SEO pages for affiliate program, dropship program, and agent API partnership without exposing private OF2.