Partner Ecosystem Tracks (partner track)
Passinstance collaborates with point-of-sale ISVs, digital agencies, marketing consultancies, and hardware resellers across the four Passinstance database partner track tracks (TECHNOLOGY, SOLUTION, REFERRAL, RESELLER), governed by partner status (APPLIED | UNDER_REVIEW | ACCEPTED | INTEGRATING | VERIFIED | ACTIVE | SUSPENDED | TERMINATED | REJECTED):
| partner track Track | Ideal Partner Profile | Core Capabilities & Commercial Model | ||
|---|---|---|---|---|
TECHNOLOGY | POS, ticketing, CRM, booking & ERP platforms | Native webhook/API co-engineering, sandbox provisioning, public directory listing (partner visibility: `DRAFT | PRIVATE | PUBLIC`). |
SOLUTION | Digital agencies & retail/hospitality consultancies | Multi-client workspace management, deal registration (request payload), priority onboarding. | ||
REFERRAL | Consultants, creators & industry advisors | Attribution tracking (SAAS_REFERRAL_COMMISSION) with up to 15% recurring referral commission (default: 15.00, 12 months). | ||
RESELLER | Bundled retail hardware & software resellers | Reseller margins (RESELLER_MARGIN), white-label add-ons, NFC hardware enablement (partner order status). |
Partner Portal & Directory API Reference
The Passinstance Partner API manages public directory discovery, partner onboarding, deal registration (opportunity status), legal agreement execution (agreement status), and commission accounting (commission type: PERCENTAGE | FIXED_PER_CUSTOMER | CUSTOM):
| Endpoint Path | Method | Auth | Description | |||
|---|---|---|---|---|---|---|
/api/v1/partners/directory | GET | Public | Lists verified partners in the public directory with region and specialty filters. | |||
/api/v1/partners/public/:slug | GET | Public | Retrieves the public profile, certifications, and case studies for a partner slug. | |||
/api/v1/partners/apply | POST | Public | Submits a new partnership application (request payload). | |||
/api/v1/partners/:id | GET | Bearer | Retrieves authenticated partner record details. | |||
/api/v1/partners/:id/deals | GET / POST | Bearer | Lists or registers client opportunities (request payload) to lock in attribution. | |||
/api/v1/partners/:id/referrals | GET | Bearer | Lists self-serve referral conversions (referral status: `PENDING | ACTIVE | CHURNED | DISQUALIFIED`). |
/api/v1/partners/:id/agreements | GET | Bearer | Lists partner commercial agreements (agreement status). | |||
/api/v1/partners/:id/agreements/:agreementId/sign | POST | Bearer | Cryptographically records partner acceptance and signature on an agreement. | |||
/api/v1/partners/:id/commercial-terms | GET | Bearer | Returns active commission rates (revenue type) and payout terms. | |||
/api/v1/partners/:id/commissions | GET | Bearer | Retrieves commission ledger entries (ACCRUED, PENDING_APPROVAL, APPROVED, PAID, CANCELLED). |
Submitting a Partner Application & Registering a Deal
Prospective partners can apply programmatically or through /become-a-partner via POST /api/v1/partners/apply (request payload):
{
"name": "Nordic Retail Systems AB",
"slug": "nordic-retail-systems",
"partnerType": "SOLUTION",
"websiteUrl": "https://nordicretailsystems.example.com",
"contactName": "Astrid Lindholm",
"contactEmail": "astrid@nordicretailsystems.example.com",
"description": "Multi-location loyalty and POS integrations across the Nordics.",
"commissionRatePercent": 15,
"commissionType": "PERCENTAGE",
"recurringPayoutMonths": 12
}
Once approved and after signing the partner agreement (POST /api/v1/partners/:id/agreements/:agreementId/sign), partners register client opportunities via POST /api/v1/partners/:id/deals (request payload):
{
"prospectName": "Erik Lindqvist",
"prospectCompany": "Stockholm Roastery Group",
"prospectDomain": "stockholmroastery.example.se",
"prospectEmail": "erik@stockholmroastery.example.se",
"estimatedValue": 12000.0,
"currency": "EUR",
"notes": "Multi-location loyalty + NFC NFC counter integration",
"protectionDays": 90
}
Commission Accrual, Approval & Payout Lifecycle
When a referred or deal-registered customer pays a subscription invoice, the billing engine tracks partner earnings through auditable commission status stages:
-
1
Accrual (
POST /api/v1/admin/partners/:id/commissions/accrue): Calculates the commission share (ACCRUED) based on the partner's activecommercial-termswhen a customer invoice transitions toPAID. -
2
Approval (
POST /api/v1/admin/partners/:id/commissions/:commissionId/approve): Locks the accrued entry (APPROVED) after any refund/chargeback window clears (commission refund status:NONE | PARTIAL_REFUND | FULL_REFUND). -
3
Payout Settlement (
POST /api/v1/admin/partners/:id/commissions/:commissionId/settle): Records the payout transfer reference and transitions the commission ledger entry toPAID.
Important: To guarantee attribution protection on enterprise or agency-assisted sales, always register the prospect via
POST /api/v1/partners/:id/dealsbefore the client creates their production workspace.
Explore the partner ecosystem at /partners or submit your application directly at /become-a-partner.
