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-Profil | Ideales Partnerprofil | Kernfunktionen & Geschäftsmodell | ||
|---|---|---|---|---|
TECHNOLOGY | POS-, Ticketing-, CRM-, Buchungs- & ERP-Plattformen | Gemeinsame Entwicklung nativer Webhook-/API-Integrationen, Sandbox-Bereitstellung, Eintrag im öffentlichen Partnerverzeichnis (partner visibility: `DRAFT \ | PRIVATE \ | PUBLIC`). |
SOLUTION | Digitalagenturen & Beratungen für Einzelhandel/Gastronomie | Verwaltung mehrerer Kunden-Workspaces, Deal-Registrierung (request payload), bevorzugtes Onboarding. | ||
REFERRAL | Berater, Content-Creator & Branchenexperten | Attributions-Tracking (SAAS_REFERRAL_COMMISSION) mit bis zu 15 % wiederkehrender Empfehlungsprovision (default: 15.00, 12 Monate). | ||
RESELLER | Anbieter gebündelter Einzelhandels-Hardware & -Software | Reseller-Margen (RESELLER_MARGIN), White-Label-Add-ons, Bereitstellung von NFC-Hardware (partner order status). |
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):
| Endpunktpfad | Methode | Authentifizierung | Beschreibung | |||
|---|---|---|---|---|---|---|
/api/v1/partners/directory | GET | Öffentlich | Listet verifizierte Partner im öffentlichen Verzeichnis mit Filterung nach Region und Fachgebiet auf. | |||
/api/v1/partners/public/:slug | GET | Öffentlich | Ruft das öffentliche Profil, Zertifizierungen und Fallstudien für einen Partner-Slug ab. | |||
/api/v1/partners/apply | POST | Öffentlich | Übermittelt eine neue Partnerschaftsbewerbung (request payload). | |||
/api/v1/partners/:id | GET | Bearer | Ruft die Datensatzdetails des authentifizierten Partners ab. | |||
/api/v1/partners/:id/deals | GET / POST | Bearer | Listet Verkaufschancen bei Kunden auf oder registriert neue (request payload), um die Attribution zu sichern. | |||
/api/v1/partners/:id/referrals | GET | Bearer | Listet Self-Service-Empfehlungskonversionen auf (referral status: `PENDING \ | ACTIVE \ | CHURNED \ | DISQUALIFIED`). |
/api/v1/partners/:id/agreements | GET | Bearer | Listet kaufmännische Partnervereinbarungen auf (agreement status). | |||
/api/v1/partners/:id/agreements/:agreementId/sign | POST | Bearer | Erfasst kryptografisch die Annahme und Unterzeichnung einer Vereinbarung durch den Partner. | |||
/api/v1/partners/:id/commercial-terms | GET | Bearer | Gibt aktive Provisionssätze (revenue type) und Auszahlungsbedingungen zurück. | |||
/api/v1/partners/:id/commissions | GET | Bearer | Ruft 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:
{
"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):
{
"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
Entstehung des Anspruchs (
POST /api/v1/admin/partners/:id/commissions/accrue): Berechnet den Provisionsanteil (ACCRUED) auf Grundlage der aktivencommercial-termsdes Partners, sobald eine Kundenrechnung in den StatusPAIDwechselt. -
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
Auszahlungsabrechnung (
POST /api/v1/admin/partners/:id/commissions/:commissionId/settle): Erfasst die Überweisungsreferenz der Auszahlung und setzt den Eintrag im Provisions-Ledger aufPAID.
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.
