Migrer des abonnements vers Frisbii Billing

Prev Next

Lorsque vous passez de votre plateforme d'abonnement actuelle à Frisbii Billing, vous pouvez importer tous les éléments clés : modes de paiement enregistrés, clients et abonnements. La transition se fait ainsi en douceur pour vos clients finaux, sans qu'ils aient à saisir à nouveau leurs données de paiement.

Ce guide vous explique comment importer :

  • les tokens de carte de crédit (via Frisbii et votre PSP)

  • les accords Vipps/MobilePay

  • les mandats de prélèvement SEPA

  • les tokens PayPal Vault ou Billing Agreements

Il explique également comment créer les clients et les abonnements associés à ces modes de paiement.

Avant de commencer : faites passer toutes les nouvelles inscriptions par Frisbii

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

Vous n'avez ainsi qu'un ensemble fixe de données existantes à migrer, sans devoir effectuer plusieurs importations par la suite. Si vous utilisez encore votre ancienne plateforme d'abonnement ou votre ancienne passerelle de paiement pour les nouvelles inscriptions, vous générez en permanence de nouvelles données qui devront elles aussi être migrées.

✅ Nous vous recommandons de passer entièrement à Frisbii pour tous les nouveaux abonnements avant de commencer la migration.
Vous pouvez accueillir les nouveaux utilisateurs via :

  • les Hosted Pages Frisbii

  • nos plugins officiels

  • directement l'API Frisbii

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

Import des modes de paiement

Import des cartes de crédit

Si votre PSP actuel stocke les données de carte enregistrées de vos clients, Frisbii peut importer ces tokens en toute sécurité afin de garantir une facturation sans interruption pendant la migration.

⚠️ Seules les entreprises certifiées PCI niveau 1, comme Frisbii, sont autorisées à traiter et à échanger des données de carte.

Étapes d'import des cartes de crédit

1. Faites passer toutes les nouvelles transactions par Frisbii
Assurez-vous que tous les nouveaux abonnements et enregistrements de cartes sont traités via Frisbii, afin qu'il ne reste plus que les abonnements existants.

2. Demandez un export à votre PSP actuel

  • Envoyez un e-mail à votre PSP actuel pour demander l'export de toutes les données de carte stockées vers Frisbii.

  • Mettez support@frisbii.com en copie de l'e-mail.

  • 🛑 Demandez au PSP de conserver les données de carte existantes jusqu'à la fin de la migration. Vous pourrez ainsi continuer à prélever via l'ancien PSP en cas de problème pendant les tests ou la bascule.

3. Frisbii et le PSP coordonnent le transfert
Frisbii se charge de l'échange sécurisé des clés, du chiffrement et de la planification avec votre PSP.

4. Recevez le fichier de correspondance des tokens
Frisbii vous fournit 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 séparateur.
Il se compose des colonnes suivantes :

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

Cette colonne est omise si l'ancien PSP ne fournit qu'un seul identifiant.
"frisbii_temporary_token" est le token à 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 principale de la carte chez le PSP

  • id2 : second identifiant facultatif (peut être omis)

  • frisbii_temporary_token : token de carte à usage unique émis par Frisbii

5. Associez la carte via l'API Add Payment Method

Vous pouvez associer le token de carte importé à un client existant ou créer le client directement dans la même requête.

Option A : associer à un client existant

Champs obligatoires :

  • source : le token de carte Frisbii à usage unique
    → Exemple : "ct_ca7b393ebb0ab1b59ea075b55adae344"

  • customer_handle : le handle du client déjà créé
    → Exemple : "cust_0022"

Exemple de requête :

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

Option B : créer le client dans la requête

Champs obligatoires :

  • source : le token de carte Frisbii

  • customer : objet contenant les données du client :

    • handle : identifiant unique du client → "customer_001"

    • email : adresse e-mail du client → "jane.doe@example.com"

    • first_name : prénom → "Jane"

    • last_name : nom → "Doe"

Exemple de requête :

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

✅ En cas de succès, vous recevez un ID de mode de paiement Frisbii (par ex. ca_fcfac2016614418f969fa5697383e47c).
Conservez cet ID et utilisez-le comme source lors de la création des abonnements.

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

6. Clôturez votre compte auprès de l'ancien PSP (facultatif)
Une fois que vous avez vérifié que tout fonctionne :

  • ✅ Vous pouvez demander au PSP de supprimer les anciennes données de carte et de résilier votre contrat.

  • ⏳ Nous vous recommandons de garder le compte actif pendant un certain temps afin de pouvoir effectuer des remboursements sur 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. Vous conservez ainsi les mandats clients (également appelés accords ou mode de paiement) sans nouvelle autorisation.

📘 Votre contrat marchand VippsMobilePay doit être configuré dans Frisbii et correctement associé via votre Merchant Serial Number (MSN).

Étapes d'import des modes de paiement VippsMobilePay Recurring

  1. Récupérez les références des mandats auprès de votre ancien prestataire

    • Récupérez la liste des ID d'accords récurrents (mandats) auprès de votre PSP actuel.

    • Contactez le PSP si vous ne savez pas comment les exporter.

  2. Créez le client dans Frisbii
    Deux options s'offrent à vous :

    • Option A : créer le client au préalable avec :
      POST /v1/customer

    • Option B : créer le client directement lors de l'appel d'import, à l'aide de l'objet customer

  3. Importez le mandat Vipps/MobilePay

    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 recevez une référence de mode de paiement Frisbii.

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

Points importants

  • Rattachement au MSN : l'import doit se faire sous le bon Merchant Serial Number (MSN). Si vous utilisez un nouveau MSN, le support VippsMobilePay doit y transférer les mandats existants avant l'import.

  • Exclusivité du partenaire : un seul partenaire d'intégration peut être actif. Dès que Frisbii est enregistré, votre ancien PSP perd immédiatement l'accès.

  • Compatibilité MobilePay : les abonnements MobilePay suivent le même flux et le même endpoint que Vipps.

  • Configuration du portail : veillez à sélectionner Frisbii comme partenaire d'intégration dans le portail VippsMobilePay.

Prélèvement SEPA

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

📘 Ce flux concerne les mandats déjà signés auprès de votre ancien prestataire. Pour les nouveaux mandats créés via notre plateforme, Frisbii génère et stocke automatiquement les PDF signés.

Étapes d'import des mandats SEPA

  1. Rassemblez les données des clients et des mandats

    • Récupérez creditor_country, debtor_iban et debtor_name depuis votre plateforme actuelle.

  2. Créez le client dans Frisbii
    Vous pouvez :

    • Option A : créer le client au préalable avec :
      POST /v1/customer

    • Option B : créer le client directement à l'aide de l'objet customer dans la requête d'import

  3. Importez le mandat SEPA

    Exemple :

    {
  "creditor_country": "DE",
  "debtor_iban": "DE60680512070012345678",
  "debtor_name": "Anna Schmidt",
  "customer": {
    "handle": "cust_001",
    "email": "anna@example.com",
    "first_name": "Anna",
    "last_name": "Schmidt"
  }
}

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

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

Limites importantes

  • 🛑 Frisbii ne peut pas importer les PDF des mandats d'origine.

  • ✅ Il vous incombe de conserver en lieu sûr les mandats SEPA d'origine de vos anciens prestataires, car ils peuvent être exigés à des fins d'audit ou de conformité. Pour les nouveaux mandats SEPA créés dans Frisbii, un mandat signé électroniquement est généré automatiquement, stocké en toute sécurité et peut être récupéré à tout moment via l'API ou l'interface d'administration.

PayPal (Vault ou Billing Agreement)

Frisbii permet d'importer les tokens PayPal Vault et les Billing Agreements enregistrés, afin que vous puissiez continuer à prélever vos clients sans interruption.

Étapes d'import des modes de paiement PayPal

  1. Rassemblez les informations sur les tokens PayPal

    • Identifiez le token_id (ID Vault ou ID Billing Agreement).

    • Déterminez le token_type : VAULT ou BILLING_AGREEMENT.

  2. Créez le client dans Frisbii
    Choisissez l'une des deux options :

    • Option A : utiliser POST /v1/customer pour créer le client au préalable

    • Option B : inclure l'objet customer directement dans l'appel d'import

  3. Importez l'accord PayPal

    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 recevez une référence de mode de paiement Frisbii.

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

Création des abonnements

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

1. Désactivez temporairement les notifications par e-mail

Avant de créer des abonnements en masse :

  • Accédez à Paramètres → Modèles d'e-mail.

  • Désactivez les e-mails d'inscription et les autres e-mails concernés.

  • Prévoyez un rappel pour les réactiver à la fin du processus.

Vous évitez ainsi toute communication involontaire avec vos clients pendant la migration.

2. Créez les abonnements

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

Champs obligatoires :

  • customer_handle : l'identifiant unique du client dans Frisbii

  • plan : le handle du plan

  • source : la référence du mode de paiement Frisbii (par ex. ca_xxx)

  • start_date : la date à laquelle l'abonnement doit générer sa prochaine facture, généralement la prochaine date de renouvellement de l'abonnement.

Exemple :

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

Veillez à associer chaque client au bon plan et au bon mode de paiement à l'aide de la correspondance issue de votre ancien système.

Conclusion

En suivant ce guide, vous pouvez migrer vos modes de paiement et vos abonnements vers Frisbii Billing avec un minimum de perturbations. Qu'il s'agisse de cartes de crédit, de PayPal, de mandats SEPA ou de Vipps MobilePay, Frisbii prend en charge un processus de migration structuré et sécurisé.

Pour toute aide à la coordination ou au dépannage, contactez support@frisbii.com.

Articles Liés

© Frisbii 2025. All Rights Reserved