Migration des modes de paiement vers Frisbii Pay

  • Mis à jour le Nov 3, 2025
  • Publié le May 2, 2025
Prev Next

Migration vers Frisbii Pay (passerelle de paiement uniquement)

Si vous passez à Frisbii Pay comme passerelle de paiement (sans utiliser Frisbii Billing), vous pouvez importer en toute sécurité les méthodes de paiement existantes telles que les cartes de crédit, les mandats SEPA, les accords Vipps/MobilePay et les accords de facturation PayPal. Cela vous permet d'initier des MIT (Merchant-Initiated Transactions) via l'API Frisbii sans que vos clients n'aient à saisir à nouveau leurs coordonnées.

Avant de commencer : Acheminer tous les nouveaux frais par Frisbii Pay

Avant d'importer des données, assurez-vous que tous les nouveaux frais et enregistrements de clients sont acheminés par Frisbii Pay. Cela permet de s'assurer que vous n'avez qu'un nombre fixe de modes de paiement à migrer.

Vous pouvez gérer les nouvelles inscriptions via :

  • Nos plugins officiels

  • Intégrations API directes

Évitez d'utiliser deux systèmes pendant la migration. Cela permet d'éviter les importations multiples.

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

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.

6. Stockez la référence du mode de paiement Frisbii renvoyé dans votre propre système
Stockez la référence du mode de paiement Frisbii renvoyé dans votre propre système, afin d'être prêt à initier des frais à l'aide de l'API Create Charge. (par exemple ca_..., se_..., pp_...)

7. 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 Merchant Serial Number (MSN).

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

  1. 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.

  2. 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

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

  1. Stockez la référence du mode de paiement Frisbii renvoyé dans votre propre système
    Stockez la référence du mode de paiement Frisbii renvoyé dans votre propre système, afin d'être prêt à initier des frais à l'aide de l'API Create Charge. (par exemple, ca_..., se_..., pp_...)

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

  1. Recueillir des données sur les clients et les mandats

    • Collecter : creditor_country, debtor_iban, et debtor_name à partir de votre plateforme existante

  2. 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

  3. Importer le mandat SEPA

    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.

  1. Stockez la référence du mode de paiement Frisbii renvoyé dans votre propre système
    Stockez la référence du mode de paiement Frisbii renvoyé dans votre propre système, afin d'être prêt à initier des frais à l'aide de l'API Create Charge. (par exemple, ca_..., se_..., pp_...)

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

  1. 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

  2. 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

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

  1. Stockez la référence du mode de paiement Frisbii renvoyé dans votre propre système
    Stockez la référence du mode de paiement Frisbii renvoyé dans votre propre système, afin d'être prêt à initier des frais à l'aide de l'API Create Charge. (par exemple ca_..., se_..., pp_...)

Charger les modes de paiement enregistrés

Après avoir importé des modes de paiement, vous pouvez commencer à initier des frais de MIT en utilisant Frisbii Pay.

Créer une charge

  • Point de terminaison <0> : POST /v1/charge

  • Documentation : https://docs.frisbii.com/reference/createcharge

  • Champs obligatoires :

    • source: ID du mode de paiement Frisbii

    • client_handle : Identifiant du client

    • handle : Référence unique de commande ou de facturation

    • amount : Montant en unités mineures (par exemple 20000 = 200.00)

    • currency : Code ISO (par exemple EUR, DKK)

Exemple :

{
  "source" : "ca_f96004cae4308473c92bea0638b5b688",
  "handle" : "order-0000213",
  "amount" : 20000,
  "currency" : "EUR",
  "customer_handle" : "cust-0022"
}

Le résultat de la charge est indiqué :

  • settled: Success

  • authorized: Authorized, not captured

  • failed: Card or PSP error

  • pending: Awaiting external confirmation (e.g. Vipps)

ℹ️ Les frais de carte sont synchronisés. Pour les modes asynchrones comme Vipps, écoutez les événements de type webhook.

Conclusion

En suivant ce guide, vous pouvez migrer les modes de paiement sauvegardés vers Frisbii Pay avec un minimum de perturbations et sans que les clients n'aient à se réinscrire. Une fois importées, toutes les méthodes de paiement sont prêtes à être facturées par MIT à l'aide de l'API Create Charge de Frisbii. Qu'il s'agisse d'une migration à partir d'un autre PSP ou d'une consolidation des flux de facturation, Frisbii Pay offre un processus de migration sécurisé et contrôlé.

Besoin d'aide pour planifier ou valider votre installation ? Contactez-nous à l'adresse suivante support@frisbii.com.

Articles Liés