Facturation MSP

Cette page explique en détail comment fonctionne la facturation pour les partenaires Scanyze.

Vue d'ensemble des modèles

Source : msp_accounts.billing_model peut être reseller ou direct. Le toggle msp_managed_tenants.billing_delegated peut surcharger ce comportement par client.

Mode Reseller — facturation consolidée

Principe

Vous (le MSP) prenez en charge la facturation de tous vos clients :

• Vous fixez votre propre prix de revente (avec votre propre marge sur le wholesale Scanyze)
• Vous émettez des factures à vos clients selon votre cycle (mensuel, annuel, sur facturation)
• Vous gérez les relances, les contentieux

De son côté, Scanyze vous émet une seule facture consolidée mensuelle regroupant tous vos tenants gérés :

• Date d'émission : 1er de chaque mois pour la consommation du mois précédent
• Délai de paiement : 30 jours net (pour les MSP en mode payment_mode=invoice)
• Méthode : virement bancaire SWIFT/Wire, ou prélèvement automatique sur carte

Structure de la facture

Facture wholesale Scanyze — partenaire « MaBoite Sécurité Inc. »
Période : avril 2026
Numéro : SCAN-WS-2026-04-0042

Tenants gérés actifs : 12

DÉTAIL PAR TENANT

| Client final          | Plan      | Coût wholesale | Crédits IA | Total CAD |
|-----------------------|-----------|-----------------|-------------|-----------|
| Cabinet juridique X   | Pro       | 239.40 $       | (inclus)    | 239.40 $  |
| Comptable Y           | Starter   | 17.40 $        | (inclus)    | 17.40 $   |
| Notaire Z             | Pro       | 239.40 $       | 50 top-up   | 244.40 $  |
| ... (9 autres)         |           |                 |             |           |

SOUS-TOTAL                                            : 4 287.50 $
RABAIS partenaire MSP (-40%)                          : -1 715.00 $
                                                       ---------
SOUS-TOTAL APRÈS RABAIS                               : 2 572.50 $

TPS (5%)                                              : 128.63 $
TVQ (9.975%)                                          : 256.61 $
                                                       ---------
TOTAL CAD                                             : 2 957.74 $

Discount partenaire

Source : partner_tiers.discount_percent.

Le discount s'applique au prix retail des plans listés dans la documentation publique. Vous décidez à quel prix vous re-vendez ensuite à vos clients.

Engagement minimum

Source : partner_tiers.min_monthly_wholesale_cents.

Si votre consommation mensuelle wholesale (après discount) est inférieure à l'engagement minimum, la différence vous est facturée comme un fixed fee. Cela compense les coûts de support, certification et infrastructure dédiée.

Mode Direct — cashback récurrent

Principe

• Le client final paye Scanyze directement, comme un tenant régulier (carte de crédit ou facture).
• Vous (MSP) n'avez aucune charge financière sur ce client.
• À chaque paiement du client, vous touchez un cashback sur la base d'un pourcentage configuré (msp_accounts.rebate_pct, typiquement 20%).
• Le cashback est versé mensuellement par virement bancaire ou crédité sur votre prochaine facture wholesale.

Calcul du cashback

cashback = paiement_client × rebate_pct

Exemple : un client paye 399 $ pour le plan Pro mensuel. Avec rebate_pct=20%, vous touchez 79.80 $/mois tant que ce client reste actif.

Le cashback s'accumule dans reseller_signups.cashback_accrued_cents et est payé via le job cron cashback_cron.go (mensuel, début de mois M+1 pour la consommation du mois M).

Durée du cashback

• Reseller : 12 mois max par tenant attribué (premier paiement à mois 12 inclus)
• MSP / WL en mode direct : illimité (récurrent tant que le client est actif)

Code reseller

Pour le tier Reseller, l'attribution se fait par code unique (reseller_codes.code, format REV-XXXXXX). Quand un nouveau tenant s'inscrit avec ?ref=REV-XXXXXX en query string, il est lié à votre reseller_signups.tenant_id.

Vous pouvez :

• Partager le lien app.scanyze.com/register?ref=REV-XXXXXX à vos prospects
• Mettre un widget Scanyze sur votre site web pointant vers ce lien
• L'inclure dans vos signatures email

Pour les MSP / WL, l'attribution se fait à la création du tenant via l'API /partner/clients (champ attributed_msp_id).

Mode mixte — par client

Sur chaque tenant, vous pouvez choisir individuellement le mode :

• msp_managed_tenants.billing_delegated = true : vous payez pour ce client (mode reseller pour ce client)
• msp_managed_tenants.billing_delegated = false : le client paye directement (mode direct pour ce client)

Cas typique : vous offrez le premier mois ou un période de grâce à un client (delegated=true puis bascule en delegated=false après 30 jours).

Crédits IA hérités (ai_premium_inheritance)

Source : msp_accounts.ai_premium_inheritance (boolean).

Si activé, vos crédits IA Premium achetés au niveau MSP sont partagés avec tous vos tenants gérés. Cas d'usage :

• Vous achetez un gros pack 50 000 crédits IA en bulk (avec discount volume)
• Vous activez ai_premium_inheritance
• Tous vos clients peuvent utiliser ces crédits au même titre que leurs propres allocations
• Vous facturez ce service comme une option à vos clients

Sans ai_premium_inheritance, chaque client a ses propres crédits (alloués selon son plan) et n'a pas accès aux vôtres.

L'admin SecuAAS active ce flag à la demande (action admin.update_partner_ai_premium_inheritance dans audit_logs) — ce n'est pas auto-activable côté MSP.

Carte de crédit MSP enregistrée

Pour gérer efficacement la création de nouveaux clients en mode billing_delegated=true, enregistrez une carte de crédit dans /partner/billing → onglet Méthode de paiement.

À chaque création de client en mode delegated, la subscription est immédiatement activée sur cette carte. Vous évitez ainsi de devoir saisir une carte à chaque nouveau client.

La carte est tokenisée par Stripe via SecuCFO — Scanyze ne stocke jamais le PAN en clair.

Mode invoice (paiement par virement bancaire)

Disponible sur demande pour MSP / White-Label.

• Délai net 30 jours
• Virement SWIFT/Wire ou TEF
• Coordonnées bancaires fournies sur la facture
• Relance auto à J+15, J+30, J+45
• Suspension auto à J+60 si non-paiement

À demander à partners@scanyze.com. Crédit ouvert après évaluation financière.

Factures et exports

/partner/invoices :

• Toutes vos factures wholesale (PDF téléchargeable)
• Filtres : par mois, par statut (open, paid, void)
• Export CSV pour intégration dans votre comptabilité (compatible QuickBooks, Sage, Xero)
• API : GET /v1/partner/invoices pour récupérer programmatiquement

Calcul des taxes

Identique au flow standard (voir Plans et facturation) :

• TPS 5% (711449140 RT0001) — clients QC
• TVQ 9.975% (1230449518 TQ0001) — clients QC uniquement
• HST selon province (ON 13%, NB/NS/PEI/NL 15%)
• Hors Canada : pas de taxes canadiennes facturées

Les taxes sont calculées sur la facture finale au MSP (mode reseller) ou sur chaque facture client (mode direct).

Sources de cette page

• Backend : secuscan-api/internal/api/handlers/partner.go (GetMSPDashboardStats, billing endpoints), admin_partners.go (UpdatePartner), secuscan-api/internal/services/billing/, secuscan-api/internal/services/reseller/cashback_cron.go
• Migrations : 000099_partner_tiers, 000100_partner_accounts, 000101_partner_billing, 000127_partner_tiers_rename, 000152_reseller_tier, 000153_partner_msp_extensions, 000169_split_msp_from_tenant
• Modèle : secuscan-api/internal/domain/models/partner_account.go, reseller_code.go

À jour pour Scanyze v0.130.x.