Migration der Abonnements zu Frisbii Billing

  • Aktualisiert am Jun 17, 2025
  • Veröffentlicht am May 2, 2025
Prev Next

Wenn Du von Deiner bestehenden Abonnement-Plattform zu Frisbii Billing wechselst, ist es möglich, alle wichtigen Komponenten zu importieren: gespeicherte Zahlungsarten, Kunden und Abonnements. Dies gewährleistet einen nahtlosen Übergang für Deine Endnutzer, ohne dass diese gezwungen sind, ihre Zahlungsdaten erneut einzugeben.

Dieser Leitfaden zeigt Dir, wie Du diese importieren kannst:

  • Kreditkarten-Token (über Frisbii und Deinen PSP)

  • Vipps/MobilePay-Verträge

  • SEPA-Lastschriftmandate

  • PayPal-Vault oder Billing Agreements

Und wie man Kunden und Abonnements erstellt, die mit diesen Zahlungsmethoden verbunden sind.

Bevor Du beginnst: Leite alle neuen Anmeldungen über Frisbii

Bevor Du bestehende Abonnements und Zahlungsmethoden migrierst, stelle sicher, dass alle neuen Kundenanmeldungen und Abonnements über Frisbii abgewickelt werden.

Auf diese Weise wird sichergestellt, dass nur eine feste Menge vorhandener Daten migriert werden muss, sodass später nicht mehrere Importrunden erforderlich sind. Wenn Du noch Deine alte Abonnementplattform oder Dein altes Zahlungsgateway für Neuanmeldungen verwendest, generiere kontinuierlich neue Daten, die ebenfalls migriert werden müssen.

Wir empfehlen, für alle neuen Abonnements vollständig auf Frisbii umzustellen , bevor Du mit der Migration beginnst.
Du kannst neue Nutzer wie folgt einbinden:

  • über Frisbii Gehostete Seiten

  • über unsere offiziellen Plugins

  • direkt über die Frisbii API

Sobald dies der Fall ist, kannst Du mit der Migration der vorhandenen Daten beginnen, ohne dass es zu Überschneidungen kommt.

Import von Zahlungsmethoden

Import von Kreditkarten

Wenn Dein derzeitiger PSP die gespeicherten Kartendaten Deiner Kunden speichert, kann Frisbii diese Token sicher importieren, um eine unterbrechungsfreie Abrechnung während der Migration zu gewährleisten.

⚠️ Nur PCI Level 1 zertifizierte Unternehmen wie Frisbii dürfen Kartendaten verarbeiten und austauschen.

Schritte zum Importieren von Kreditkarten

1. Stelle alle neuen Transaktionen auf Frisbii
um. Stelle sicher, dass alle neuen Abonnements und Kartenregistrierungen über Frisbii abgewickelt werden. Damit nur noch bestehende Abonnements übrig sind.

2. Export von Deinem aktuellen PSP anfordern

  • Sende eine E-Mail an Deinen derzeitigen PSP und fordere den Export aller gespeicherten Kartendaten zu Frisbii an

  • CC support@frisbii.com in der E-Mail

  • Bitte den PSP, die vorhandenen Kartendaten bis zum Abschluss der Migration beizubehalten. Dadurch wird sichergestellt, dass Du den Ladevorgang über das alte PSP-System fortsetzen kannst, falls während der Tests oder der Umstellung etwas schiefgeht.

3. Frisbii und PSP koordinieren die Übertragung
Frisbii übernimmt den sicheren Schlüsselaustausch, die Verschlüsselung und die Terminierung mit Deinem PSP.

4. Du erhältst die Token-Mapping-Datei
Frisbii stellt eine .csv-Datei mit folgendem Format zur Verfügung:

Die Ausgabedatei enthält alle importierten Karten.
In der Ausgabedatei wird das Semikolon als Trennzeichen verwendet. 
Sie besteht aus den folgenden Spalten:

<id1>;<id2>;<frisbii_temporary_token>
"Id1" ist die Kartenkennung des alten PSP 
"Id2" ist die zweite Kartenkennung des alten PSP. 

Diese Spalte entfällt, wenn der alte PSP nur einen einzigen Identifikator liefert.
"frisbii_temporary_token" ist der einmalige Token, der auf eine importierte Karte verweist.

Beispiel:
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: primäre Kartenreferenz des PSP

  • id2: optionale zweite ID (kann weggelassen werden)

  • frisbii_temporary_token: Von Frisbii ausgestelltes Karten-Token für den einmaligen Gebrauch

5. Füge die Karte mit Add Payment Method API hinzu

Du kannst das importierte Kartentoken entweder an einen bestehenden Kunden anhängen oder den Kunden direkt in der gleichen Anfrage erstellen.

Option A: An einen bestehenden Kunden anhängen

Erforderliche Felder:

  • source: das einmalig verwendbare Frisbii-Karten-Token
    → Beispiel: "ct_ca7b393ebb0ab1b59ea075b55adae344"

  • customer_handle: Das Handle des bereits angelegten Kunden
    → Beispiel: "cust_0022"

Beispiel für eine Anfrage:

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

Option B: Kunden direkt anlegen

Erforderliche Felder:

  • source: das Frisbii-Karten-Token

  • customer: Objekt mit Kundendaten:

    • handle: eindeutige Kundenkennung → "customer_001"

    • email: E-Mail-Adresse des Kunden → "jane.doe@example.com"

    • first_name: Vorname → "Jane"

    • last_name: Nachname → "Doe"

Beispiel für eine Anfrage:

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

✅ Bei Erfolg wird eine Frisbii-Zahlungsmethoden-ID erstellt (z. B. ca_fcfac2016614418f969fa5697383e47c).
Speicher diese ID und verwende sie als source bei der Erstellung von Abonnements.

Verwende die Frisbii-Zahlungsart-Referenz, wenn Du neue Abonnements erstellst.

6. Schließe Dein altes PSP-Konto (optional)
Wenn Du Dich vergewissert hast, dass alles funktioniert:

  • ✅ Du kannst den PSP auffordern, alte Kartendaten zu löschen und Deinen Vertrag zu beenden

  • ⏳ Wir empfehlen, das Konto für eine kurze Zeit aktiv zu halten, damit alte Transaktionen erstattet werden können.

Vipps/MobilePay Recurring

Frisbii unterstützt den Import bestehender Vipps- oder MobilePay-Abonnements in das VippsMobilePay Recurring-System, das Teil der einheitlichen nordischen Plattform von VippsMobilePay ist. So können Kundenmandate (auch Vereinbarungen oder Zahlungsmethoden genannt) beibehalten werden, ohne dass eine erneute Autorisierung erforderlich ist.

📘 Erfordert, dass Dein VippsMobilePay-Händlervertrag in Frisbii eingerichtet und ordnungsgemäß über Deine Händlerseriennummer (MSN) verknüpft ist.

Schritte zum Importieren von VippsMobilePay Recurring Zahlungsmethoden

  1. Hole Mandatsreferenzen von Deinem alten Anbieter ein

    • Rufe eine Liste von IDs für wiederkehrende Vereinbarungen (Mandate) von Deinem aktuellen PSP ab

    • Kontaktiere den PSP, wenn Du nicht sicher bist, wie Du diese Daten exportieren kannst

  2. Erstelle den Kunden in Frisbii
    Es gibt zwei Möglichkeiten:

    • Option A: Erstelle den Kunden im Voraus mit:
      POST /v1/customer

    • Option B: Erstelle den Kunden inline während des Importaufrufs unter Verwendung des Objekts customer

  3. Importiere das Vipps/MobilePay-Mandat

    Beispiel:

    {
  "vipps_agreement_id": "vipps-789123",
  "currency": "NOK",
  "customer": {
    "handle": "cust_001",
    "email": "mail@example.com",
    "first_name": "Olav",
    "last_name": "Nordmann"
  }
}

✅ Bei Erfolg wird eine Frisbii-Zahlungsmethode-Referenz erstellt.

Verwende die Frisbii-Zahlungsmethode-Referenz bei der Erstellung neuer Abonnements.

Wichtige Überlegungen

  • MSN binding: Es muss unter der richtigen Merchant Serial Number (MSN) importiert werden. Wenn Du eine neue MSN verwendest, muss der VippsMobilePay-Support bestehende Mandate vor dem Import auf diese übertragen.

  • Exklusivität der Partner: Es kann nur ein Integrationspartner aktiv sein. Wenn Frisbii registriert wird, verliert Dein bisheriger PSP sofort den Zugriff.

  • MobilePay-Kompatibilität: MobilePay Subscriptions folgen demselben Ablauf und Endpunkt wie Vipps.

  • Portal einrichten: Stelle sicher, dass Du Frisbii als Deinen Integrationspartner im VippsMobilePay-Portal auswählst.

SEPA-Lastschriftverfahren

Frisbii ermöglicht es Dir, bestehende SEPA-Lastschriftmandate zu importieren, um IBANs ohne erneute Autorisierung durch den Kunden weiter zu belasten.

📘 Dieser Flow ist für bereits unterzeichnete Mandate von Deinem alten Anbieter. Frisbii generiert und speichert automatisch signierte PDFs für neue Mandate, die über unsere Plattform erstellt werden.

Schritte für den Import von SEPA-Mandaten

  1. Erfassen von Kunden- und Mandatsdaten

    • Sammel: creditor_country, debtor_iban und debtor_name von Deiner bestehenden Plattform

  2. Den Kunden in Frisbii erstellen
    Wie folgt:

    • Option A:Den Kunden im Voraus erstellen mit:
      POST /v1/customer

    • Option B: Inline-Erstellung des Kunden unter Verwendung des Objekts customer im Import-Request

  3. Importieren des SEPA-Mandats

    Beispiel:

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

✅ Bei Erfolg wird eine Frisbii-Zahlungsmethode-Referenz erstellt.

Verwende die Frisbii-Zahlungsart-Referenz, wenn Du neue Abonnements erstellst.

Wichtige Einschränkungen

  • 🛑 Frisbii kann keine Original-Mandats-PDFs importieren

  • Du bist für die sichere Aufbewahrung der Original-SEPA-Mandatsdokumente von früheren Anbietern verantwortlich, da diese zu Prüfungs- oder Compliance-Zwecken benötigt werden können. Für neue SEPA-Mandate, die in Frisbii erstellt werden, wird automatisch ein digital signiertes Mandat generiert, das sicher gespeichert wird und jederzeit über die API oder über die Adminoberfläche abgerufen werden kann.

PayPal (Vault oder Billing Agreement)

Frisbii unterstützt den Import von gespeicherten PayPal-Vault-Tokens und Billing Agreements, sodass Kunden weiterhin nahtlos belastet werden können.

Schritte zum Importieren von PayPal-Zahlungsmethoden

  1. Sammeln von PayPal-Token-Informationen

    • Identifiziere die token_id (Vault ID oder Billing-Agreement-ID)

    • token_type bestimmen: VAULT oder BILLING_AGREEMENT

  2. Erstelle den Kunden in Frisbii
    Wähle eine der beiden Möglichkeiten:

    • Option A: POST /v1/customer verwenden, um den Kunden vorab zu erstellen

    • Option B: Das Objekt customer inline in den Importaufruf einbinden

  3. Importieren der PayPal-Vereinbarung

    Beispiel:

    {
  "token_id": "EC-1ABC234DEF567890G",
  "token_type": "BILLING_AGREEMENT",
  "customer": {
    "handle": "paypal_cust_001",
    "email": "paypal@example.com",
    "first_name": "Maria",
    "last_name": "Anders"
  }
}

✅ Bei Erfolg wird eine Frisbii-Zahlungsmethode-Referenz erstellt.

Verwende die Frisbii-Zahlungsart-Referenz, wenn Du neue Abonnements erstellst.

Erstellen von Abonnements

Sobald alle Kunden und Zahlungsmethoden eingerichtet sind, besteht der letzte Schritt darin, für jeden Kunden ein Abonnement in Frisbii zu erstellen.

1. E-Mail-Benachrichtigungen vorübergehend deaktivieren

Bevor Abonnements in großen Mengen erstellt werden:

  • Einstellungen → E-Mail-Vorlagen öffnen.

  • Registrierungsvorlagen und andere relevante E-Mails deaktivieren.

  • Eine Erinnerung einstellen, um sie am Ende des Prozesses wieder zu aktivieren.

Auf diese Weise wird eine versehentliche Kommunikation mit dem Kunden während der Migration vermieden.

2. Abonnements erstellen

Verwende die Create Subscription API, um jedes Abonnement in Frisbii einzurichten.

Erforderliche Felder:

  • customer_handle: der eindeutige Bezeichner des Kunden in Frisbii

  • plan: das Plan-Handle

  • source: die Frisbii-Zahlungsmethode-Referenz (z. B. ca_xxx)

  • start_date: Das Datum, an dem die nächste Rechnung für das Abonnement erstellt werden soll, in der Regel das nächste Verlängerungsdatum des Abonnements.

Beispiel:

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

Stelle sicher, dass jeder Kunde dem richtigen Plan und der richtigen Zahlungsmethode zugeordnet wird, indem Du die Zuordnung aus Deinem vorherigen System verwendest.

Fazit

Wenn Du diese Anleitung befolgst, kannst Du Zahlungsmethoden und Abonnements erfolgreich und mit minimalen Unterbrechungen in Frisbii Billing migrieren. Ob Kreditkarten, PayPal, SEPA oder Vipps MobilePay Mandate importiert werden, Frisbii unterstützt einen strukturierten und sicheren Migrationsfluss.

Wenn Du Unterstützung bei der Koordinierung oder Fehlerbehebung benötigst, wende Dich an support@frisbii.com.

Verwandte Artikel