Migration von Zahlungsmethoden zu Frisbii Pay

  • Aktualisiert am Sep 30, 2025
Prev Next

Migration zu Frisbii Pay (nur Zahlungsgateway)

Wenn Du zu Frisbii Pay als Zahlungsgateway wechselst (ohne Frisbii Billing zu verwenden), kannst Du bestehende Zahlungsmethoden wie Kreditkarten, SEPA-Mandate, Vipps/MobilePay-Vereinbarungen und PayPal-Abrechnungsvereinbarungen sicher importieren. Dies ermöglicht Dir, MIT (Merchant-Initiated Transactions) über die Frisbii API zu initiieren, ohne dass Deine Kunden ihre Daten erneut eingeben müssen.

Bevor Du beginnst: Leite alle neuen Gebühren über Frisbii Pay

Bevor Du Daten importierst, stelle sicher, dass alle neuen Gebühren und Kundenregistrierungen über Frisbii Pay geleitet werden. Auf diese Weise wird sichergestellt, dass nur eine bestimmte Anzahl von älteren Zahlungsmethoden migriert werden müssen.

Neue Anmeldungen können verarbeitet werden über:

  • unsere offiziellen Plugins

  • direkte API-Integrationen

Vermeide den Betrieb von zwei Systemen während der Migration. Dadurch werden mehrere Importrunden verhindert.

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.

6. Speichere die zurückgegebene Frisbii-Zahlungsmethode-Referenz in Deinem eigenen System
Speichere die zurückgegebene Frisbii-Zahlungsmethode-Referenz in Deinem eigenen System, sodass Du bereit bist, Gebühren mit der Create Charge API zu initiieren. (z.B. ca_..., se_..., pp_...)

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

  1. Speichere die zurückgegebene Frisbii-Zahlungsmethode-Referenz in Deinem eigenen System
    Speichere die zurückgegebene Frisbii-Zahlungsmethode-Referenz in Deinem eigenen System, sodass Du bereit bist, Gebühren mit der Create Charge API zu initiieren. (z.B. ca_..., se_..., pp_...)

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 Direct Debit

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: Erstelle den Kunden im Voraus 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.

  1. Speichere die zurückgegebene Frisbii-Zahlungsmethode-Referenz in Deinem eigenen System
    Speichere die zurückgegebene Frisbii-Zahlungsmethode-Referenz in Deinem eigenen System, sodass Du bereit bist, Gebühren mit der Create Charge API zu initiieren. (z.B. ca_..., se_..., pp_...)

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.

  1. Speichere die zurückgegebene Frisbii-Zahlungsmethode-Referenz in Deinem eigenen System
    Speichere die zurückgegebene Frisbii-Zahlungsmethode-Referenz in Deinem eigenen System, sodass Du bereit bist, Gebühren mit der Create Charge API zu initiieren. (z.B. ca_..., se_..., pp_...)

Gespeicherte Zahlungsmethoden belasten

Nach dem Importieren von Zahlungsmethoden kann die MIT-Gebühren mit Frisbii Pay begonnen werden.

Gebühren erheben

  • Endpunkt: POST /v1/charge

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

  • Erforderliche Felder:

    • source: Frisbii Zahlungsmethoden-ID

    • customer_handle: Kennung des Kunden

    • handle: Eindeutige Bestell- oder Gebührenreferenz

    • amount: Betrag in kleinen Einheiten (z. B. 20000 = 200.00)

    • currency: ISO-Code (z. B. EUR, DKK)

Beispiel:

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

Das Ergebnis lautet:

  • settled: Erfolg

  • authorized: Autorisiert, nicht erfasst

  • failed: Karten- oder PSP-Fehler

  • pending: Warten auf externe Bestätigung (z.B. Vipps)

ℹ️ Kartengebühren sind synchron. Bei asynchronen Methoden wie Vipps solltest Du auf Webhook-Ereignisse warten.

Fazit

Wenn Du diese Anleitung befolgst, kannst Du Deine gespeicherten Zahlungsmethoden mit minimaler Unterbrechung und ohne erneute Kundeneingabe zu Frisbii Pay migrieren. Nach dem Import sind alle Zahlungsmethoden bereit für MIT-Gebühren mit Frisbii's Create Charge API. Ob Du von einem anderen PSP migrierst oder Abrechnungsabläufe konsolidierst, Frisbii Pay bietet einen sicheren und kontrollierten Migrationsprozess.

Benötigst Du Hilfe bei der Planung oder Validierung Deiner Einrichtung? Kontaktiere uns unter support@frisbii.com.

Verwandte Artikel