Migration des abonnements vers Frisbii Billing

Lorsque vous passez à Frisbii Billing à partir de votre plateforme d'abonnement existante, il est possible d'importer tous les composants clés : les méthodes de paiement enregistrées, les clients et les abonnements. Cela garantit une transition en douceur pour vos utilisateurs finaux, sans qu'ils soient obligés de saisir à nouveau les détails du paiement.

Ce guide vous explique comment importer :

Jetons de carte de crédit (via Frisbii et votre PSP)
Accords Vipps/MobilePay
Mandats de prélèvement SEPA
PayPal vault ou billing agreement

Et comment créer des clients et des abonnements liés à ces méthodes de paiement.

Avant de commencer : Acheminer toutes les nouvelles inscriptions par l'intermédiaire de Frisbii

Avant de migrer les abonnements et les modes de paiement existants, assurez-vous que toutes les nouvelles inscriptions et tous les nouveaux abonnements sont traités via Frisbii.

Cela permet de s'assurer que vous n'avez qu'un ensemble fixe de données existantes à migrer, ce qui évite d'avoir à procéder à plusieurs séries d'importations par la suite. Si vous utilisez encore votre ancienne plateforme d'abonnement ou passerelle de paiement pour les nouvelles inscriptions, vous générerez continuellement de nouvelles données qui devront également être migrées.

Nous vous recommandons de passer entièrement à Frisbii pour tous les nouveaux abonnements avant de commencer la migration.
Vous pouvez intégrer de nouveaux utilisateurs par le biais de :

Pages hébergées Frisbii
Nos plugins officiels
Directement via l'API Frisbii

Une fois cette étape franchie, vous pouvez commencer la migration des données existantes en toute sécurité, sans risque de chevauchement.

Importation de méthodes de paiement

Importation de cartes de crédit

Si votre PSP actuel stocke les détails des cartes enregistrées de vos clients, Frisbii peut importer ces jetons en toute sécurité pour assurer une facturation ininterrompue pendant la migration.

⚠️ Seules les entreprises certifiées PCI niveau 1, comme Frisbii, peuvent traiter et échanger des données de cartes.

Etapes de l'importation des méthodes de paiement par carte de crédit

1. Basculer toutes les nouvelles transactions vers Frisbii
Veiller à ce que tous les nouveaux abonnements et enregistrements de cartes soient traités via Frisbii. Il ne vous reste donc plus que les abonnements existants

2. Demande d'exportation à partir de votre PSP actuel

Envoyez un courriel à votre PSP actuel pour demander l'exportation de toutes les données de cartes stockées vers Frisbii.
CC support@frisbii.com dans le courriel
🛑 Demander au PSP de conserver les données des cartes existantes jusqu'à ce que la migration soit terminée. Cela permet de continuer à charger l'ancienne PSP en cas de problème lors des tests ou de la transition.

3. Frisbii et le PSP coordonnent le transfert
Frisbii se chargera de l'échange de clés sécurisé, du cryptage et de la programmation avec votre PSP.

4. Recevoir le fichier de correspondance des jetons
Frisbii fournira un fichier .csv au format suivant :

Le fichier de sortie contient toutes les cartes importées.
Le fichier de sortie utilise le point-virgule comme délimiteur. 
Il se compose des colonnes suivantes :

<id1>;<id2>;<frisbii_temporary_token>
"Id1" est l'identifiant de la carte de l'ancien PSP 
"Id2" est le deuxième identifiant de la carte de l'ancien PSP. 

Cette colonne sera omise si l'ancien PSP ne fournit qu'un seul identifiant.
"frisbii_temporary_token" est le jeton à usage unique faisant référence à une carte importée.

Exemple :
12345677;42441;ct_ca7b393ebb0ab1b59ea075b55adae344
12345671;42442;ct_c6e16fd3f3c01cd1e92137ca0bb5b0e8
12345672;42443;ct_4940286230dbda172c391153034bd6c2
12345673;42444;ct_b38c72778b97986f19fbda396c31c231
12345674;42445;ct_b75e50c5bcd6a41f19f20f36d19367e1
123456715;42446;ct_3563d85177e2389af67e979ba2fbe7b1
123456718;412447;ct_34a4191f637f9b97b7f05cecbb911ec6
123456719;987448;ct_105d4994a19350b7924291e24c11ee5e

id1: Référence de la carte primaire du PSP
id2: deuxième identifiant facultatif (peut être omis)
frisbii_temporary_token: Jeton de carte à usage unique émis par Frisbii

5. Attacher la carte à l'aide de l'API Add Payment Method

Point de terminaison : POST /v1/méthode_de_paiement
Documentation : https://docs.frisbii.com/reference/addpaymentmethodv2

Vous pouvez soit attacher le jeton de carte importé à un client existant, soit créer le client en ligne dans la même requête.

Option A : Attacher au client existant

Champs obligatoires :

source: Le jeton de la carte Frisbii à usage unique
→ Exemple : "ct_ca7b393ebb0ab1b59ea075b55adae344"
customer_handle : Le handle du client déjà créé
→ Exemple : « cust_0022"

Exemple de demande :

{
  "source" : "ct_ca7b393ebb0ab1b59ea075b55adae344",
  "customer_handle" : "cust_0022"
}

Option B : Créer un client en ligne

Champs obligatoires :

source: Le jeton de la carte Frisbii
customer: Objet contenant des données sur les clients :
- handle: Identifiant unique du client → "customer_001"
- email: Adresse électronique du client → "jane.doe@example.com"
- first_name: Prénom → "Jane"
- last_name: Nom de famille → "Doe"

Exemple de demande :

{
  "source" : "ct_ca7b393ebb0ab1b59ea075b55adae344",
  "customer" : {
    "handle" : "customer_001",
    "email" : "jane.doe@example.com",
    "first_name" : "Jane",
    "last_name" : "Doe"
  }
}

✅ En cas de succès, vous recevrez un identifiant de méthode de paiement Frisbii (par exemple ca_fcfac2016614418f969fa5697383e47c).
Enregistrez cet identifiant et utilisez-le comme source lors de la création d'abonnements.

Utilisez la référence du mode de paiement Frisbii lors de la création de nouveaux abonnements.

6. Fermez votre ancien compte PSP (facultatif)
Une fois que vous avez vérifié que tout fonctionne :

Vous pouvez demander au PSP de supprimer les données de l'ancienne carte et de résilier votre contrat.
⏳ Nous recommandons de maintenir le compte actif pendant une courte période afin de permettre le remboursement d'anciennes transactions.

Vipps / MobilePay Recurring

Frisbii permet d'importer des abonnements Vipps ou MobilePay existants dans le système VippsMobilePay Recurring, qui fait partie de la plateforme nordique unifiée de VippsMobilePay. Cela vous permet de conserver les mandats des clients (également appelés accords ou méthodes de paiement) sans avoir à les réautoriser.

📘 Il faut que votre accord commercial VippsMobilePay soit configuré dans Frisbii et qu'il soit correctement lié à votre numéro de série du commerçant (MSN).

Étapes de l'importation des méthodes de paiement de VippsMobilePay Recurring

Obtenez des références de mandat de votre ancien fournisseur
- Récupérer une liste d'identifiants d'accords récurrents (mandats) de votre PSP actuel
- Contactez le PSP si vous n'êtes pas sûr de savoir comment exporter ces documents.
Créer le client dans Frisbii
Vous avez deux options :
- Option A : Créer le client à l'avance en utilisant :
  POST /v1/customer
- Option B : Créer le client en ligne lors de l'appel d'importation en utilisant l'objet customer
Importer le mandat Vipps/MobilePay
- Point de terminaison : POST /v1/payment_method/import_vipps_recurring
- Documentation : https://docs.frisbii.com/reference/importvippsrecurringpaymentmethod
- Champs obligatoires :
  - vipps_agreement_id
  - currency (par exemple NOK, DKK)
  - Soit customer_handle, soit objet customer
Exemple :
```
{
  "vipps_agreement_id" : "vipps-789123",
  "currency" : "NOK",
  "customer" : {
    "handle" : "cust_001",
    "email" : "mail@example.com",
    "first_name" : "Olav",
    "last_name" : "Nordmann"
  }
}
```

✅ En cas de succès, vous recevrez une référence de mode de paiement Frisbii.

Utilisez la référence du mode de paiement Frisbii lors de la création de nouveaux abonnements.

Considérations importantes

Liaison MSN : Vous devez importer sous le bon numéro de série du commerçant (MSN). Si vous utilisez un nouveau MSN, le support de VippsMobilePay doit y transférer les mandats existants avant l'importation.
Exclusivité du partenaire : Un seul partenaire d'intégration peut être actif. Lorsque Frisbii est enregistré, votre ancienne PSP en perd immédiatement l'accès.
Compatibilité avec MobilePay : Les abonnements MobilePay suivent le même flux et le même point de terminaison que Vipps.
Configuration du portail : Veillez à sélectionner Frisbii comme partenaire d'intégration dans le portail VippsMobilePay.

SEPA Direct Debit

Frisbii vous permet d'importer des mandats de prélèvement SEPA existants afin de continuer à débiter des IBAN sans nouvelle autorisation du client.

📘 Ce flux concerne les mandats déjà signés par votre ancien fournisseur. Frisbii génère et stocke automatiquement les PDF signés pour les nouveaux mandats créés via notre plateforme.

Étapes de l'importation de mandats SEPA

Recueillir des données sur les clients et les mandats
- Collecter : creditor_country, debtor_iban, et debtor_name à partir de votre plateforme existante
Créer le client dans Frisbii
Vous pouvez :
- Option A : Créer le client à l'avance en utilisant :
  POST /v1/customer
- Option B : Créer le client en ligne à l'aide de l'objet customer dans la demande d'importation
Importer le mandat SEPA
- Point de terminaison : POST /v1/methode_de_paiement/import_sepa
- Documentation : https://docs.frisbii.com/reference/importsepapaymentmethod
- Champs obligatoires :
  - creditor_country (par exemple DE)
  - debtor_iban
  - debtor_name
  - Soit customer_handle, soit objet customer
Exemple :
```
{
  "creditor_country" : "DE",
  "debtor_iban" : "DE60680512070012345678",
  "debtor_name" : "Anna Schmidt",
  "client" : {
    "handle" : "cust_001",
    "email" : "anna@example.com",
    "first_name" : "Anna",
    "last_name" : "Schmidt"
  }
}
```

✅ En cas de succès, vous recevrez une référence de mode de paiement Frisbii.

Utilisez la référence du mode de paiement Frisbii lors de la création de nouveaux abonnements.

Limites importantes

🛑 Frisbii ne peut pas importer les PDF originaux du mandat
✅ Vous êtes responsable du stockage sécurisé des documents de mandat SEPA originaux des fournisseurs précédents, car ils peuvent être requis à des fins d'audit ou de conformité. Pour les nouveaux mandats SEPA créés dans Frisbii, un mandat signé numériquement est automatiquement généré, stocké en toute sécurité et peut être récupéré à tout moment via l'API ou l'interface d'administration.

PayPal (Vault or Billing Agreement)

Frisbii prend en charge l'importation des jetons PayPal Vault stockés et Billing Agreements afin que vous puissiez continuer à facturer vos clients de manière transparente.

Etapes de l'importation des méthodes de paiement PayPal

Collecte des informations sur le jeton PayPal
- Identifier le token_id (Vault ID ou Billing Agreement ID)
- Déterminer le token_type: VAULT ou BILLING_AGREEMENT
Créer le client dans Frisbii
Choisissez l'une des deux options :
- Option A : Utiliser POST /v1/customer pour précréer le client
- Option B : Inclure l'objet customer en ligne dans l'appel d'importation
Importer l'accord PayPal
- Point de terminaison : POST /v1/payment_method/import_paypal
- Documentation : https://docs.frisbii.com/reference/importpaypalpaymentmethod
- Champs obligatoires :
  - token_id
  - token_type
  - Soit customer_handle, soit objet customer
Exemple :
```
{
  "token_id" : "EC-1ABC234DEF567890G",
  "token_type" : "BILLING_AGREEMENT",
  "customer" : {
    "handle" : "paypal_cust_001",
    "email" : "paypal@example.com",
    "first_name" : "Maria",
    "last_name" : "Anders"
  }
}
```

✅ En cas de succès, vous recevrez une référence de mode de paiement Frisbii.

Utilisez la référence du mode de paiement Frisbii lors de la création de nouveaux abonnements.

Créer d'abonnements

Une fois que tous les clients et toutes les méthodes de paiement sont en place, la dernière étape consiste à créer des abonnements dans Frisbii pour chaque client.

1. Désactiver temporairement les notifications par courrier électronique

Avant de créer des abonnements en masse :

Allez dans Paramètres → Modèles d'e-mail
Désactiver les modèles d'inscription et autres courriels pertinents.
Fixez un rappel pour les réactiver à la fin du processus.

Cela permet d'éviter toute communication accidentelle avec les clients pendant la migration.

2. Créer des abonnements

Utilisez l'API Create Subscription pour configurer chaque abonnement dans Frisbii.

Champs obligatoires :

customer_handle: L'identifiant unique du client dans Frisbii
plan: L'identifiant unique du plan
source: La référence du mode de paiement Frisbii (par exemple ca_xxx).
start_date: Date à laquelle l'abonnement doit générer sa prochaine facture, généralement la date de renouvellement de l'abonnement.

Exemple :

{
  "customer_handle" : "customer_001",
  "plan" : "monthly_plan_001",
  "start_date" : "2025-07-01",
  "source" : "ca_fcfac2016614418f969fa5697383e47c"
}

Veillez à ce que chaque client soit associé au plan et au mode de paiement appropriés en utilisant le mapping de votre ancien système.

Conclusion

En suivant ce guide, vous pouvez migrer avec succès les méthodes de paiement et les abonnements dans Frisbii Billing avec un minimum de perturbations. Qu'il s'agisse d'importer des cartes de crédit, des mandats PayPal, SEPA ou Vipps MobilePay, Frisbii prend en charge un flux de migration structuré et sécurisé.

Pour obtenir de l'aide en matière de coordination ou de dépannage, contactez support@frisbii.com.