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 track | Profil partenaire idéal | Capacités clés et modèle commercial | ||
|---|---|---|---|---|
TECHNOLOGY | Plateformes de caisse, billetterie, CRM, réservation et ERP | Co-ingénierie native webhook/API, provisionnement de sandbox, référencement dans l'annuaire public (partner visibility : `DRAFT \ | PRIVATE \ | PUBLIC`). |
SOLUTION | Agences digitales et cabinets de conseil retail/hôtellerie | Gestion d'espaces de travail multi-clients, enregistrement d'opportunités (request payload), accompagnement prioritaire. | ||
REFERRAL | Consultants, créateurs et conseillers sectoriels | Suivi d'attribution (SAAS_REFERRAL_COMMISSION) avec jusqu'à 15 % de commission récurrente (default: 15.00, 12 mois). | ||
RESELLER | Revendeurs d'ensembles matériel + logiciel pour le commerce | Marges revendeur (RESELLER_MARGIN), options marque blanche, activation de matériel NFC (partner order status). |
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 terminaison | Méthode | Auth | Description | |||
|---|---|---|---|---|---|---|
/api/v1/partners/directory | GET | Public | Liste les partenaires vérifiés dans l'annuaire public avec filtres par région et spécialité. | |||
/api/v1/partners/public/:slug | GET | Public | Récupère le profil public, les certifications et les études de cas d'un partenaire par son slug. | |||
/api/v1/partners/apply | POST | Public | Soumet une nouvelle candidature au programme partenaire (request payload). | |||
/api/v1/partners/:id | GET | Bearer | Récupère les informations détaillées du dossier partenaire authentifié. | |||
/api/v1/partners/:id/deals | GET / POST | Bearer | Liste ou enregistre des opportunités clients (request payload) afin de verrouiller l'attribution. | |||
/api/v1/partners/:id/referrals | GET | Bearer | Liste les conversions de recommandation en libre-service (referral status : `PENDING \ | ACTIVE \ | CHURNED \ | DISQUALIFIED`). |
/api/v1/partners/:id/agreements | GET | Bearer | Liste les accords commerciaux du partenaire (agreement status). | |||
/api/v1/partners/:id/agreements/:agreementId/sign | POST | Bearer | Enregistre par voie cryptographique l'acceptation et la signature du partenaire sur un accord. | |||
/api/v1/partners/:id/commercial-terms | GET | Bearer | Renvoie les taux de commission actifs (revenue type) et les conditions de versement. | |||
/api/v1/partners/:id/commissions | GET | Bearer | Ré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) :
{
"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) :
{
"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
Accumulation (
POST /api/v1/admin/partners/:id/commissions/accrue) : Calcule la part de commission (ACCRUED) selon lescommercial-termsactifs du partenaire dès qu'une facture client passe au statutPAID. -
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
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/dealsavant 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.
