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
ownerof 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_payoutsas 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
/resellerwith 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
/supportand 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
| Severity | Example | Route | First response |
|---|---|---|---|
| P0 — Critical | Data loss, total outage, payment failure | /support tag P0 + WhatsApp pager | 15 min · 24×7 |
| P1 — High | Module down for one tenant, customs blocking | /support tag P1 | 1 business hour |
| P2 — Normal | Functional bug with workaround | /support tag P2 | 1 business day |
| P3 — Request | Feature ask, docs gap | Quarterly partner roadmap call | Reviewed 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.