Skip to content
Helpcentrum-gids · Bureaus & partners
3 min leestijdGecontroleerd 2026-11-16

Partner- & resellerprogramma's

Ontdek Technologie-, Oplossings-, Verwijzings- (tot 15% commissie) en Reseller-trajecten.

In deze gids

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-trajectIdeaal partnerprofielKernmogelijkheden & commercieel model
TECHNOLOGYPOS-, ticketing-, CRM-, boekings- & ERP-platformenNative webhook-/API-koppeling, sandboxinrichting, openbare partnergidsvermelding (partner visibility: `DRAFTPRIVATEPUBLIC`).
SOLUTIONDigitale bureaus & retail-/hospitality-adviesbureausBeheer van meerdere klantwerkruimtes, dealregistratie (request payload), versnelde onboarding.
REFERRALConsultants, creators & branche-adviseursAttributietracering (SAAS_REFERRAL_COMMISSION) met tot 15% terugkerende verwijzingscommissie (default: 15.00, 12 maanden).
RESELLERGebundelde retailhardware- & softwareresellersResellermarges (RESELLER_MARGIN), white-label add-ons, NFC-hardwareactivatie (partner order status).
SYSTEEMARCHITECTUUR
INTERACTIEVE ARCHITECTUUR
PARTNERDEAL & COMMISSIELEVENCYCLUS
FASE 01
1
AANMELDING & OVEREENKOMST (Partner Portal API /api/v1/partners/*)
Aanvraag indienen: POST/api/v1/partners/apply (request payload)
Overeenkomst ondertek.: POST/api/v1/partners/:id/agreements/:agreementId/sign
FASE 02
2
DEALREGISTRATIE & VERWIJZINGSATTRIBUTIE
Kans registreren: POST/api/v1/partners/:id/deals (request payload)
Conversies volgen: GET/api/v1/partners/:id/referrals
FASE 03
3
COMMISSIEOPBOUW, GOEDKEURING & UITBETALING (commission status)
Betaalde factuur start opbouwACCRUED / PENDING_APPROVAL
Financiële goedkeuringAPPROVED
Uitbetaling afgerondPAID (GET/partners/:id/commissions)

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):

EndpointpadMethodeAuthBeschrijving
/api/v1/partners/directoryGETOpenbaarToont geverifieerde partners in de openbare gids met regio- en specialisatiefilters.
/api/v1/partners/public/:slugGETOpenbaarHaalt het openbare profiel, certificeringen en praktijkcases op voor een partnerslug.
/api/v1/partners/applyPOSTOpenbaarDient een nieuwe partneraanvraag in (request payload).
/api/v1/partners/:idGETBearerHaalt geauthenticeerde partnergegevens op.
/api/v1/partners/:id/dealsGET / POSTBearerToont of registreert klantkansen (request payload) om attributie vast te leggen.
/api/v1/partners/:id/referralsGETBearerToont selfservice verwijzingsconversies (referral status: `PENDINGACTIVECHURNEDDISQUALIFIED`).
/api/v1/partners/:id/agreementsGETBearerLijst commerciële partnerovereenkomsten op (agreement status).
/api/v1/partners/:id/agreements/:agreementId/signPOSTBearerLegt de acceptatie en cryptografische handtekening van de partner op een overeenkomst vast.
/api/v1/partners/:id/commercial-termsGETBearerRetourneert actieve commissiepercentages (revenue type) en uitbetalingsvoorwaarden.
/api/v1/partners/:id/commissionsGETBearerHaalt 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):

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
}

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):

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
}

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. 1
    Opbouw (POST /api/v1/admin/partners/:id/commissions/accrue): Berekent het commissieaandeel (ACCRUED) op basis van de geldende commercial-terms zodra een klantfactuur op PAID komt.
  2. 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. 3
    Uitbetaling (POST /api/v1/admin/partners/:id/commissions/:commissionId/settle): Registreert de betalingsreferentie van de uitkering en zet de commissieregel om naar PAID.

Belangrijk: Om attributiebescherming bij enterprise- of agentschapstrajecten te waarborgen, dient u de prospect altijd via POST /api/v1/partners/:id/deals te registreren voordat de klant zijn productiewerkruimte aanmaakt.

Verken het partnerecosysteem op /partners of dien rechtstreeks uw aanvraag in via /become-a-partner.

Gerelateerde product- en ontwikkelaarsdocs

Klaar om uw eerste kaartprogramma te lanceren?

Maak uw workspace aan, configureer uw sjabloon en test een echte kaart in Apple Wallet en Google Wallet voordat u opschaalt.