Skip to content
Hilfecenter-Anleitung · Agenturen & Partner
3 Min. LesezeitGeprüft 2026-11-16

Partner- & Reseller-Programme

Entdecken Sie Technologie-, Lösungs-, Empfehlungs- (bis 15 % Provision) und Großhandels-Partnerprogramme.

In dieser Anleitung

Partner-Ökosystem-Profile (partner track)

Passinstance arbeitet mit Point-of-Sale-ISVs, Digitalagenturen, Marketingberatungen und Hardware-Resellern in den vier Passinstance database-partner track-Profilen (TECHNOLOGY, SOLUTION, REFERRAL, RESELLER) zusammen, die über das partner status (APPLIED | UNDER_REVIEW | ACCEPTED | INTEGRATING | VERIFIED | ACTIVE | SUSPENDED | TERMINATED | REJECTED) gesteuert werden:

partner track-ProfilIdeales PartnerprofilKernfunktionen & Geschäftsmodell
TECHNOLOGYPOS-, Ticketing-, CRM-, Buchungs- & ERP-PlattformenGemeinsame Entwicklung nativer Webhook-/API-Integrationen, Sandbox-Bereitstellung, Eintrag im öffentlichen Partnerverzeichnis (partner visibility: `DRAFT \PRIVATE \PUBLIC`).
SOLUTIONDigitalagenturen & Beratungen für Einzelhandel/GastronomieVerwaltung mehrerer Kunden-Workspaces, Deal-Registrierung (request payload), bevorzugtes Onboarding.
REFERRALBerater, Content-Creator & BranchenexpertenAttributions-Tracking (SAAS_REFERRAL_COMMISSION) mit bis zu 15 % wiederkehrender Empfehlungsprovision (default: 15.00, 12 Monate).
RESELLERAnbieter gebündelter Einzelhandels-Hardware & -SoftwareReseller-Margen (RESELLER_MARGIN), White-Label-Add-ons, Bereitstellung von NFC-Hardware (partner order status).
SYSTEMARCHITEKTUR-ABLAUF
INTERAKTIVE ARCHITEKTUR
LEBENSZYKLUS FÜR PARTNER-DEALS & PROVISIONEN
STUFE 01
1
BEWERBUNG & VEREINBARUNG (Partner Portal API /api/v1/partners/*)
Bewerbung einreichen: POST/api/v1/partners/apply (request payload)
Vereinbarung unterzeichnen:POST/api/v1/partners/:id/agreements/:agreementId/sign
STUFE 02
2
DEAL-REGISTRIERUNG & EMPFEHLUNGS-ATTRIBUTION
Verkaufschance melden: POST/api/v1/partners/:id/deals (request payload)
Konversionen verfolgen:GET/api/v1/partners/:id/referrals
STUFE 03
3
PROVISIONALGRENZUNG, FREIGABE & AUSZAHLUNG (commission status)
Bezahlte Rechnung löst Abgrenzung ausACCRUED / PENDING_APPROVAL
Prüfung durch FinanzabteilungAPPROVED
Auszahlung durchgeführtPAID (GET/partners/:id/commissions)

API-Referenz für Partnerportal & Partnerverzeichnis

Die Passinstance Partner-API verwaltet die Suche im öffentlichen Partnerverzeichnis, das Partner-Onboarding, die Deal-Registrierung (opportunity status), den Abschluss rechtlicher Vereinbarungen (agreement status) und die Provisionsabrechnung (commission type: PERCENTAGE | FIXED_PER_CUSTOMER | CUSTOM):

EndpunktpfadMethodeAuthentifizierungBeschreibung
/api/v1/partners/directoryGETÖffentlichListet verifizierte Partner im öffentlichen Verzeichnis mit Filterung nach Region und Fachgebiet auf.
/api/v1/partners/public/:slugGETÖffentlichRuft das öffentliche Profil, Zertifizierungen und Fallstudien für einen Partner-Slug ab.
/api/v1/partners/applyPOSTÖffentlichÜbermittelt eine neue Partnerschaftsbewerbung (request payload).
/api/v1/partners/:idGETBearerRuft die Datensatzdetails des authentifizierten Partners ab.
/api/v1/partners/:id/dealsGET / POSTBearerListet Verkaufschancen bei Kunden auf oder registriert neue (request payload), um die Attribution zu sichern.
/api/v1/partners/:id/referralsGETBearerListet Self-Service-Empfehlungskonversionen auf (referral status: `PENDING \ACTIVE \CHURNED \DISQUALIFIED`).
/api/v1/partners/:id/agreementsGETBearerListet kaufmännische Partnervereinbarungen auf (agreement status).
/api/v1/partners/:id/agreements/:agreementId/signPOSTBearerErfasst kryptografisch die Annahme und Unterzeichnung einer Vereinbarung durch den Partner.
/api/v1/partners/:id/commercial-termsGETBearerGibt aktive Provisionssätze (revenue type) und Auszahlungsbedingungen zurück.
/api/v1/partners/:id/commissionsGETBearerRuft Buchungseinträge im Provisions-Ledger ab (ACCRUED, PENDING_APPROVAL, APPROVED, PAID, CANCELLED).

Einreichen einer Partnerbewerbung & Registrieren eines Deals

Potenzielle Partner können sich programmatisch oder über /become-a-partner mittels POST /api/v1/partners/apply (request payload) bewerben:

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
}

Nach der Genehmigung und der Unterzeichnung der Partnervereinbarung (POST /api/v1/partners/:id/agreements/:agreementId/sign) registrieren Partner Verkaufschancen bei Kunden über 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
}

Lebenszyklus für Provisionsanspruch, Freigabe & Auszahlung

Wenn ein empfohlener oder über einen registrierten Deal gewonnener Kunde eine Abonnementrechnung bezahlt, verfolgt die Abrechnungs-Engine die Partnereinnahmen über revisionssichere commission status-Phasen:

  1. 1
    Entstehung des Anspruchs (POST /api/v1/admin/partners/:id/commissions/accrue): Berechnet den Provisionsanteil (ACCRUED) auf Grundlage der aktiven commercial-terms des Partners, sobald eine Kundenrechnung in den Status PAID wechselt.
  2. 2
    Freigabe (POST /api/v1/admin/partners/:id/commissions/:commissionId/approve): Schreibt den vorgemerkten Eintrag nach Ablauf etwaiger Rückerstattungs- oder Rückbuchungsfristen (commission refund status: NONE | PARTIAL_REFUND | FULL_REFUND) verbindlich fest (APPROVED).
  3. 3
    Auszahlungsabrechnung (POST /api/v1/admin/partners/:id/commissions/:commissionId/settle): Erfasst die Überweisungsreferenz der Auszahlung und setzt den Eintrag im Provisions-Ledger auf PAID.

Wichtig: Um den Attributionsschutz bei Enterprise- oder agenturbegleiteten Abschlüssen zu gewährleisten, registrieren Sie den Interessenten immer über POST /api/v1/partners/:id/deals, bevor der Kunde seinen Produktions-Workspace erstellt.

Entdecken Sie das Partner-Ökosystem unter /partners oder reichen Sie Ihre Bewerbung direkt unter /become-a-partner ein.

Weiterführende Produkt- & Entwicklerdoku

Bereit für Ihr erstes Wallet-Kartenprogramm?

Erstellen Sie Ihren Workspace, konfigurieren Sie Ihre Vorlage und testen Sie eine echte Karte in Apple Wallet und Google Wallet, bevor Sie skalieren.