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 PSPid2
: 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
Endpunkt:
POST /v1/payment_method
Dokumentation: https://docs.frisbii.com/reference/addpaymentmethodv2
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-Tokencustomer
: 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
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
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
Importiere das Vipps/MobilePay-Mandat
Endpunkt:
POST /v1/payment_method/import_vipps_recurring
Dokumentation: https://docs.frisbii.com/reference/importvippsrecurringpaymentmethod
Erforderliche Felder:
vipps_agreement_id
currency
(z. B.NOK
,DKK
)Entweder
customer_handle
odercustomer
Objekt
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
Erfassen von Kunden- und Mandatsdaten
Sammel:
creditor_country
,debtor_iban
unddebtor_name
von Deiner bestehenden Plattform
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
Importieren des SEPA-Mandats
Endpunkt:
POST /v1/payment_method/import_sepa
Dokumentation: https://docs.frisbii.com/reference/importsepapaymentmethod
Erforderliche Felder:
creditor_country
(z.B.DE
)debtor_iban
debtor_name
Entweder
customer_handle
odercustomer
Objekt
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
Sammeln von PayPal-Token-Informationen
Identifiziere die
token_id
(Vault ID oder Billing-Agreement-ID)token_type
bestimmen:VAULT
oderBILLING_AGREEMENT
Erstelle den Kunden in Frisbii
Wähle eine der beiden Möglichkeiten:Option A:
POST /v1/customer
verwenden, um den Kunden vorab zu erstellenOption B: Das Objekt
customer
inline in den Importaufruf einbinden
Importieren der PayPal-Vereinbarung
Endpunkt:
POST /v1/payment_method/import_paypal
Dokumentation: https://docs.frisbii.com/reference/importpaypalpaymentmethod
Erforderliche Felder:
token_id
token_type
Entweder
customer_handle
odercustomer
Objekt
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 Frisbiiplan
: das Plan-Handlesource
: 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.