Migrer des modes de paiement vers Frisbii Pay

Prev Next

Migrer 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é vos moyens de paiement existants, tels que les cartes de crédit, les mandats SEPA, les accords Vipps/MobilePay et les Billing Agreements PayPal. Vous pouvez ainsi initier des MIT (Merchant-Initiated Transactions, transactions initiées par le commerçant) via l'API Frisbii sans que vos clients aient à saisir à nouveau leurs données.

Avant de commencer : faites passer tous les nouveaux paiements par Frisbii Pay

Avant d'importer des données, assurez-vous que tous les nouveaux paiements et toutes les nouvelles inscriptions de clients passent par Frisbii Pay. Vous n'avez ainsi qu'un lot fixe d'anciens moyens de paiement à migrer.

Vous pouvez gérer les nouvelles inscriptions via :

  • nos plugins officiels

  • des intégrations API directes

Évitez d'utiliser deux systèmes en parallèle pendant la migration. Vous éviterez ainsi plusieurs vagues d'import.

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.

6. Enregistrez la référence du mode de paiement Frisbii renvoyée dans votre propre système
Enregistrez la référence du mode de paiement Frisbii renvoyée dans votre propre système, afin de pouvoir initier des paiements avec l'API Create Charge (par ex. ca_..., se_..., pp_...).

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

  1. Enregistrez la référence du mode de paiement Frisbii renvoyée dans votre propre système
    Enregistrez la référence du mode de paiement Frisbii renvoyée dans votre propre système, afin de pouvoir initier des paiements avec l'API Create Charge (par ex. ca_..., se_..., pp_...).

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.

  1. Enregistrez la référence du mode de paiement Frisbii renvoyée dans votre propre système
    Enregistrez la référence du mode de paiement Frisbii renvoyée dans votre propre système, afin de pouvoir initier des paiements avec l'API Create Charge (par ex. ca_..., se_..., pp_...).

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.

  1. Enregistrez la référence du mode de paiement Frisbii renvoyée dans votre propre système
    Enregistrez la référence du mode de paiement Frisbii renvoyée dans votre propre système, afin de pouvoir initier des paiements avec l'API Create Charge (par ex. ca_..., se_..., pp_...).

Prélever les modes de paiement enregistrés

Une fois les modes de paiement importés, vous pouvez commencer à initier des paiements MIT avec Frisbii Pay.

Create Charge

  • Endpoint : POST /v1/charge

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

  • Champs obligatoires :

    • source : ID du mode de paiement Frisbii

    • customer_handle : identifiant du client

    • handle : référence unique de la commande ou du paiement

    • amount : montant en unités mineures (par ex. 20000 = 200,00)

    • currency : code ISO (par ex. EUR, DKK)

Exemple :

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

États possibles du paiement :

  • settled : réussi

  • authorized : autorisé, non capturé

  • failed : erreur de carte ou du PSP

  • pending : en attente de confirmation externe (par ex. Vipps)

ℹ️ Les paiements par carte sont synchrones. Pour les modes de paiement asynchrones comme Vipps, écoutez les événements webhook.

Conclusion

En suivant ce guide, vous pouvez migrer les modes de paiement enregistrés vers Frisbii Pay avec un minimum de perturbations et sans que vos clients aient à saisir à nouveau leurs données. Une fois importés, tous les modes de paiement sont prêts pour des paiements MIT via l'API Create Charge de Frisbii. Que vous migriez depuis un autre PSP ou que vous consolidiez vos flux de facturation, Frisbii Pay vous offre un processus de migration sécurisé et maîtrisé.

Besoin d'aide pour planifier ou valider votre configuration ? Contactez-nous à support@frisbii.com.

Articles Liés

© Frisbii 2025. All Rights Reserved