Skip to content
Help Center Guide · Agencies & Partners
3 min readVerified 2026-11-16

Partner & Reseller Programs

Explore Technology, Solution, Referral (up to 15% commission), and Wholesale Reseller tracks for ISVs and consultancies.

In This Guide

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 TrackIdeal Partner ProfileCore Capabilities & Commercial Model
TECHNOLOGYPOS, ticketing, CRM, booking & ERP platformsNative webhook/API co-engineering, sandbox provisioning, public directory listing (partner visibility: `DRAFTPRIVATEPUBLIC`).
SOLUTIONDigital agencies & retail/hospitality consultanciesMulti-client workspace management, deal registration (request payload), priority onboarding.
REFERRALConsultants, creators & industry advisorsAttribution tracking (SAAS_REFERRAL_COMMISSION) with up to 15% recurring referral commission (default: 15.00, 12 months).
RESELLERBundled retail hardware & software resellersReseller margins (RESELLER_MARGIN), white-label add-ons, NFC hardware enablement (partner order status).
SYSTEM ARCHITECTURE FLOW
INTERACTIVE ARCHITECTURE
PARTNER DEAL & COMMISSION LIFECYCLE
STAGE 01
1
APPLICATION & AGREEMENT (Partner Portal API /api/v1/partners/*)
Submit application: POST/api/v1/partners/apply (request payload)
Execute agreement: POST/api/v1/partners/:id/agreements/:agreementId/sign
STAGE 02
2
DEAL REGISTRATION & REFERRAL ATTRIBUTION
Register opportunity: POST/api/v1/partners/:id/deals (request payload)
Track conversions: GET/api/v1/partners/:id/referrals
STAGE 03
3
COMMISSION ACCRUAL, APPROVAL & PAYOUT (commission status)
Invoice paid triggers accrualACCRUED / PENDING_APPROVAL
Finance verificationAPPROVED
Payout settlement executedPAID (GET/partners/:id/commissions)

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 PathMethodAuthDescription
/api/v1/partners/directoryGETPublicLists verified partners in the public directory with region and specialty filters.
/api/v1/partners/public/:slugGETPublicRetrieves the public profile, certifications, and case studies for a partner slug.
/api/v1/partners/applyPOSTPublicSubmits a new partnership application (request payload).
/api/v1/partners/:idGETBearerRetrieves authenticated partner record details.
/api/v1/partners/:id/dealsGET / POSTBearerLists or registers client opportunities (request payload) to lock in attribution.
/api/v1/partners/:id/referralsGETBearerLists self-serve referral conversions (referral status: `PENDINGACTIVECHURNEDDISQUALIFIED`).
/api/v1/partners/:id/agreementsGETBearerLists partner commercial agreements (agreement status).
/api/v1/partners/:id/agreements/:agreementId/signPOSTBearerCryptographically records partner acceptance and signature on an agreement.
/api/v1/partners/:id/commercial-termsGETBearerReturns active commission rates (revenue type) and payout terms.
/api/v1/partners/:id/commissionsGETBearerRetrieves 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):

JSON
{
  "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):

JSON
{
  "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. 1
    Accrual (POST /api/v1/admin/partners/:id/commissions/accrue): Calculates the commission share (ACCRUED) based on the partner's active commercial-terms when a customer invoice transitions to PAID.
  2. 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. 3
    Payout Settlement (POST /api/v1/admin/partners/:id/commissions/:commissionId/settle): Records the payout transfer reference and transitions the commission ledger entry to PAID.

Important: To guarantee attribution protection on enterprise or agency-assisted sales, always register the prospect via POST /api/v1/partners/:id/deals before the client creates their production workspace.

Explore the partner ecosystem at /partners or submit your application directly at /become-a-partner.

Related Product & Developer Documentation

Ready to launch your first pass program?

Create your workspace, configure your pass template, and test a real pass in Apple Wallet and Google Wallet before you scale.