Partner-ecosysteemtrajecten (partner track)
Passinstance werkt samen met kassa-ISV's, digitale bureaus, marketingadviesbureaus en hardware-resellers via vier Passinstance database partner track-trajecten (TECHNOLOGY, SOLUTION, REFERRAL, RESELLER), bestuurd door partner status (APPLIED | UNDER_REVIEW | ACCEPTED | INTEGRATING | VERIFIED | ACTIVE | SUSPENDED | TERMINATED | REJECTED):
| partner track-traject | Ideaal partnerprofiel | Kernmogelijkheden & commercieel model | ||
|---|---|---|---|---|
TECHNOLOGY | POS-, ticketing-, CRM-, boekings- & ERP-platformen | Native webhook-/API-koppeling, sandboxinrichting, openbare partnergidsvermelding (partner visibility: `DRAFT | PRIVATE | PUBLIC`). |
SOLUTION | Digitale bureaus & retail-/hospitality-adviesbureaus | Beheer van meerdere klantwerkruimtes, dealregistratie (request payload), versnelde onboarding. | ||
REFERRAL | Consultants, creators & branche-adviseurs | Attributietracering (SAAS_REFERRAL_COMMISSION) met tot 15% terugkerende verwijzingscommissie (default: 15.00, 12 maanden). | ||
RESELLER | Gebundelde retailhardware- & softwareresellers | Resellermarges (RESELLER_MARGIN), white-label add-ons, NFC-hardwareactivatie (partner order status). |
API-referentie Partnerportaal & Directory
De Passinstance Partner API beheert vindbaarheid in de openbare partnergids, partner-onboarding, dealregistratie (opportunity status), ondertekening van overeenkomsten (agreement status) en commissieboekhouding (commission type: PERCENTAGE | FIXED_PER_CUSTOMER | CUSTOM):
| Endpointpad | Methode | Auth | Beschrijving | |||
|---|---|---|---|---|---|---|
/api/v1/partners/directory | GET | Openbaar | Toont geverifieerde partners in de openbare gids met regio- en specialisatiefilters. | |||
/api/v1/partners/public/:slug | GET | Openbaar | Haalt het openbare profiel, certificeringen en praktijkcases op voor een partnerslug. | |||
/api/v1/partners/apply | POST | Openbaar | Dient een nieuwe partneraanvraag in (request payload). | |||
/api/v1/partners/:id | GET | Bearer | Haalt geauthenticeerde partnergegevens op. | |||
/api/v1/partners/:id/deals | GET / POST | Bearer | Toont of registreert klantkansen (request payload) om attributie vast te leggen. | |||
/api/v1/partners/:id/referrals | GET | Bearer | Toont selfservice verwijzingsconversies (referral status: `PENDING | ACTIVE | CHURNED | DISQUALIFIED`). |
/api/v1/partners/:id/agreements | GET | Bearer | Lijst commerciële partnerovereenkomsten op (agreement status). | |||
/api/v1/partners/:id/agreements/:agreementId/sign | POST | Bearer | Legt de acceptatie en cryptografische handtekening van de partner op een overeenkomst vast. | |||
/api/v1/partners/:id/commercial-terms | GET | Bearer | Retourneert actieve commissiepercentages (revenue type) en uitbetalingsvoorwaarden. | |||
/api/v1/partners/:id/commissions | GET | Bearer | Haalt commissiegrootboekregels op (ACCRUED, PENDING_APPROVAL, APPROVED, PAID, CANCELLED). |
Een partneraanvraag indienen & een deal registreren
Potentiële partners kunnen programmatisch of via /become-a-partner een aanvraag indienen 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
}
Na goedkeuring en ondertekening van de partnerovereenkomst (POST /api/v1/partners/:id/agreements/:agreementId/sign) registreren partners klantkansen 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
}
Levenscyclus van commissieopbouw, goedkeuring & uitbetaling
Wanneer een verwezen of via dealregistratie binnengebrachte klant een abonnementsfactuur voldoet, volgt de facturatie-engine de partneropbrengsten via controleerbare commission status-stappen:
-
1
Opbouw (
POST /api/v1/admin/partners/:id/commissions/accrue): Berekent het commissieaandeel (ACCRUED) op basis van de geldendecommercial-termszodra een klantfactuur opPAIDkomt. -
2
Goedkeuring (
POST /api/v1/admin/partners/:id/commissions/:commissionId/approve): Vergrendelt de opgebouwde regel (APPROVED) nadat de termijn voor terugbetaling/terugboeking is verstreken (commission refund status:NONE | PARTIAL_REFUND | FULL_REFUND). -
3
Uitbetaling (
POST /api/v1/admin/partners/:id/commissions/:commissionId/settle): Registreert de betalingsreferentie van de uitkering en zet de commissieregel om naarPAID.
Belangrijk: Om attributiebescherming bij enterprise- of agentschapstrajecten te waarborgen, dient u de prospect altijd via
POST /api/v1/partners/:id/dealste registreren voordat de klant zijn productiewerkruimte aanmaakt.
Verken het partnerecosysteem op /partners of dien rechtstreeks uw aanvraag in via /become-a-partner.
