Partner playbook

Sign agreement → first paid pilot, in 14 days.

The operational manual for resellers and implementation partners. Every section below mirrors a control inside the product so the playbook never drifts from the platform.

1. Invite & provisioning flow

Every reseller is provisioned as a parent tenant with is_reseller = true. From /reseller you mint per-customer magic-link invitations: each invite carries the child tenant name, plan code, and your branding. When the prospect accepts, we atomically:

  • create the child tenant with parent_tenant_id = your tenant;
  • seed the chosen plan + Pilot trial subscription;
  • assign the accepting user as owner of the child;
  • fire a partner.activation notification into your reseller workspace.

Pilot tenants auto-expire after 30 days unless upgraded; expired pilots are blocked from new POs/SOs/shipments by database trigger, which protects your funnel-quality numbers.

2. Pricing autonomy

You set the list price your customers see. The contract is:

  • Wholesale floor: wholesale price published per plan in your reseller agreement. Markup is yours.
  • Currency: charge in any currency our PSP registry supports (Paystack, Flutterwave, M-Pesa, Paddle). The platform reconciles to USD nightly via fx_rates.
  • Custom domain: point a CNAME at your verified domain; we issue the TLS cert.

3. Commission & payout cadence

Commission defaults to 20% of MRR on every paying child tenant (editable per partner on /reseller by the SCM·Edge ops team).

  • Snapshot: on the 1st of every month a cron snapshots prior-month MRR per partner into reseller_commission_payouts as pending.
  • Approval: ops reviews + flips to approved within 5 business days.
  • Payout: bank transfer or PSP wallet within 10 business days of approval, with reference stamped on the payout row.
  • Self-serve ledger: partners see status + history on /reseller with CSV export.

4. Support tier

  • L1 (you): first response to your customers within your own SLA. You have full owner access into each child tenant for diagnosis.
  • L2 (platform): when the cause is platform — API outage, data integrity, billing — open a ticket from /support and we acknowledge in 1 business hour on the Partner tier.
  • L3 (engineering): escalations flagged critical page on-call within 15 minutes (24×7 for partners with ≥10 paying tenants).
  • Status: public health page + RSS at /status; subscribe your ops channel.

5. Enablement & marketing kit

Bundled assets every partner receives on activation:

  • Product one-pagers per module (Sourcing, Customs RAG, WMS, QC, Logistics, Margin) in EN / FR / PT / AR / SW;
  • 30-minute demo recording + slide deck (white-labelable);
  • 5 wow-moment scripts (CBAM 2-minute pack, voice stock intake, anomaly reroute, AI margin defence, factoring quote);
  • Co-branded landing-page template + Open Graph image generator;
  • Quarterly partner webinar with the product team.

6. Compliance & data handling

Resellers act as independent controllers of their customer data; the platform is processor. You must:

  • execute our DPA (annex II SCCs already included for EU customers);
  • forward our sub-processor list and changelog to your customers at onboarding;
  • respect 30-day prior notice on new sub-processors (auto-published to the changelog feed);
  • not store our customer secrets (API keys, tokens) outside the platform.

7. Escalation matrix

SeverityExampleRouteFirst response
P0 — CriticalData loss, total outage, payment failure/support tag P0 + WhatsApp pager15 min · 24×7
P1 — HighModule down for one tenant, customs blocking/support tag P11 business hour
P2 — NormalFunctional bug with workaround/support tag P21 business day
P3 — RequestFeature ask, docs gapQuarterly partner roadmap callReviewed quarterly

Ready to onboard?

Send us a short discovery and we'll provision your reseller workspace within 1 business day with your branding, plan catalogue, and commission rate pre-loaded.