Skip to content
Guide du centre d'aide · Agences & partenaires
4 min de lectureVérifié 2026-11-16

Programmes partenaires & revendeurs

Découvrez nos parcours Technologie, Solution, Recommandation (jusqu'à 15 % de commission) et Revendeur.

Dans ce guide

Parcours de l'écosystème partenaire (partner track)

Passinstance collabore avec des éditeurs de logiciels de caisse (ISV), des agences digitales, des cabinets de conseil marketing et des revendeurs matériels à travers les quatre parcours Passinstance database partner track (TECHNOLOGY, SOLUTION, REFERRAL, RESELLER), régis par partner status (APPLIED | UNDER_REVIEW | ACCEPTED | INTEGRATING | VERIFIED | ACTIVE | SUSPENDED | TERMINATED | REJECTED) :

Parcours partner trackProfil partenaire idéalCapacités clés et modèle commercial
TECHNOLOGYPlateformes de caisse, billetterie, CRM, réservation et ERPCo-ingénierie native webhook/API, provisionnement de sandbox, référencement dans l'annuaire public (partner visibility : `DRAFT \PRIVATE \PUBLIC`).
SOLUTIONAgences digitales et cabinets de conseil retail/hôtellerieGestion d'espaces de travail multi-clients, enregistrement d'opportunités (request payload), accompagnement prioritaire.
REFERRALConsultants, créateurs et conseillers sectorielsSuivi d'attribution (SAAS_REFERRAL_COMMISSION) avec jusqu'à 15 % de commission récurrente (default: 15.00, 12 mois).
RESELLERRevendeurs d'ensembles matériel + logiciel pour le commerceMarges revendeur (RESELLER_MARGIN), options marque blanche, activation de matériel NFC (partner order status).
FLUX ARCHITECTURE SYSTÈME
ARCHITECTURE INTERACTIVE
CYCLE DE VIE DES OPPORTUNITÉS & COMMISSIONS PARTENAIRES
ÉTAPE 01
1
CANDIDATURE & ACCORD (Partner Portal API /api/v1/partners/*)
Soumettre une candidature : POST/api/v1/partners/apply (request payload)
Signer l'accord : POST/api/v1/partners/:id/agreements/:agreementId/sign
ÉTAPE 02
2
ENREGISTREMENT D'OPPORTUNITÉ & ATTRIBUTION DE RECOMMANDATION
Enregistrer une opportunité : POST/api/v1/partners/:id/deals (request payload)
Suivre les conversions : GET/api/v1/partners/:id/referrals
ÉTAPE 03
3
ACCUMULATION, APPROBATION & VERSEMENT (commission status)
Facture payée déclenche l'accumulationACCRUED / PENDING_APPROVAL
Validation financièreAPPROVED
Règlement effectuéPAID (GET/partners/:id/commissions)

Référence API du portail et de l'annuaire partenaires

L'API partenaire Passinstance gère la découverte dans l'annuaire public, l'intégration des partenaires, l'enregistrement d'opportunités (opportunity status), la signature d'accords juridiques (agreement status) et la comptabilité des commissions (commission type : PERCENTAGE | FIXED_PER_CUSTOMER | CUSTOM) :

Chemin du point de terminaisonMéthodeAuthDescription
/api/v1/partners/directoryGETPublicListe les partenaires vérifiés dans l'annuaire public avec filtres par région et spécialité.
/api/v1/partners/public/:slugGETPublicRécupère le profil public, les certifications et les études de cas d'un partenaire par son slug.
/api/v1/partners/applyPOSTPublicSoumet une nouvelle candidature au programme partenaire (request payload).
/api/v1/partners/:idGETBearerRécupère les informations détaillées du dossier partenaire authentifié.
/api/v1/partners/:id/dealsGET / POSTBearerListe ou enregistre des opportunités clients (request payload) afin de verrouiller l'attribution.
/api/v1/partners/:id/referralsGETBearerListe les conversions de recommandation en libre-service (referral status : `PENDING \ACTIVE \CHURNED \DISQUALIFIED`).
/api/v1/partners/:id/agreementsGETBearerListe les accords commerciaux du partenaire (agreement status).
/api/v1/partners/:id/agreements/:agreementId/signPOSTBearerEnregistre par voie cryptographique l'acceptation et la signature du partenaire sur un accord.
/api/v1/partners/:id/commercial-termsGETBearerRenvoie les taux de commission actifs (revenue type) et les conditions de versement.
/api/v1/partners/:id/commissionsGETBearerRécupère les écritures du grand livre des commissions (ACCRUED, PENDING_APPROVAL, APPROVED, PAID, CANCELLED).

Soumettre une candidature partenaire et enregistrer une opportunité

Les futurs partenaires peuvent postuler par programme ou via /become-a-partner au moyen de 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
}

Une fois approuvés et après signature de l'accord partenaire (POST /api/v1/partners/:id/agreements/:agreementId/sign), les partenaires déclarent leurs opportunités clients 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
}

Cycle d'accumulation, d'approbation et de versement des commissions

Lorsqu'un client recommandé ou issu d'une opportunité déclarée règle une facture d'abonnement, le moteur de facturation suit les gains du partenaire à travers des étapes auditables commission status :

  1. 1
    Accumulation (POST /api/v1/admin/partners/:id/commissions/accrue) : Calcule la part de commission (ACCRUED) selon les commercial-terms actifs du partenaire dès qu'une facture client passe au statut PAID.
  2. 2
    Approbation (POST /api/v1/admin/partners/:id/commissions/:commissionId/approve) : Verrouille l'écriture accumulée (APPROVED) une fois le délai de rétractation ou de remboursement écoulé (commission refund status : NONE | PARTIAL_REFUND | FULL_REFUND).
  3. 3
    Règlement du versement (POST /api/v1/admin/partners/:id/commissions/:commissionId/settle) : Enregistre la référence de virement et fait passer l'écriture de commission à PAID.

Important : Pour garantir la protection d'attribution sur les ventes entreprises ou accompagnées par une agence, enregistrez toujours le prospect via POST /api/v1/partners/:id/deals avant que le client ne crée son espace de travail de production.

Découvrez l'écosystème partenaire sur /partners ou déposez votre candidature directement sur /become-a-partner.

Documentation produit et développeur associée

Prêt à lancer votre premier programme de cartes Wallet ?

Créez votre espace de travail, configurez votre modèle et testez une vraie carte dans Apple Wallet et Google Wallet avant de déployer à grande échelle.