> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Abonnement-Migration zu Dodo Payments

> Erfahren Sie, wie Sie Ihre bestehenden Abonnenten und Zahlungsmethoden von Ihrem aktuellen Zahlungsanbieter zu Dodo Payments migrieren.

## Was ist eine Abonnement-Migration?

Eine Abonnement-Migration überträgt Ihre bestehenden Abonnenten von Ihrem alten Zahlungsanbieter zu Dodo Payments und bietet Ihnen eine einzige Quelle der Wahrheit für alle Ihre Kundendaten. Ohne eine Migration bleiben die Kunden, die Sie bis heute gewonnen haben, in Ihrem alten System, und nur neue Kunden wären in Dodo Payments sichtbar.

Der Migrationsprozess sorgt für ein nahtloses Abrechnungserlebnis für Ihre Kunden – sie müssen ihre Zahlungsdaten nicht erneut eingeben und erleben keine Unterbrechung ihrer Abonnements.

<Warning>
  Derzeit unterstützen wir nur die Migration von **Kartentoken**. Apple Pay, Google Pay und andere Wallet-Zahlungsmethoden können aufgrund der von diesen Anbietern auferlegten Tokenisierungsbeschränkungen nicht zwischen Zahlungsdienstleistern übertragen werden.
</Warning>

## Übersicht des Migrationsprozesses

Der Abonnement-Migrationsprozess besteht aus drei Hauptteilen:

1. **Übertragung der Zahlungsmethode** — Sicherer Transfer sensibler Kartendaten von Ihrem aktuellen Anbieter
2. **Übertragung der Abonnentendaten** — Export von Kundendaten, Abonnementplänen und Abrechnungsplänen
3. **Import und Validierung** — Vereinheitlichung der Zahlungsmethoden und Abonnentendaten in Dodo Payments

<Note>
  Um eine Abonnementmigration zu starten, kontaktiere unser [Support-Team](mailto:support@dodopayments.com). Sie verbinden dich mit einem dedizierten Solutions Engineer, der dich durch den gesamten Prozess führt.
</Note>

## Anforderungen

Bevor Sie eine Migration einleiten, stellen Sie sicher, dass Sie die folgenden Anforderungen erfüllen:

<AccordionGroup>
  <Accordion title="PCI DSS compliance verification">
    Dodo Payments ist PCI-DSS-Level-1-konform. Um den Compliance-Anforderungen gerecht zu werden, dürfen wir Kartendaten nur von einem anderen PCI-DSS-Level-1-konformen Zahlungsdienstleister empfangen.

    Ihr aktueller Anbieter muss bereitstellen:

    * Ihre aktuelle PCI-Bestätigung der Konformität (AOC) oder deren Eintrag im globalen Register der Dienstanbieter von Visa
    * Bestätigung, dass sie sichere Kartendaten-Exporte unterstützen

    Sieh dir unsere [Attestation of Compliance (AOC)](https://pub-2a89184e4c954b599464449d23f506bb.r2.dev/dodo-payments-pci-dss-aoc.pdf) an, um sie mit deinem aktuellen Dienstleister zu teilen.
  </Accordion>

  <Accordion title="Dodo Payments integration">
    Schließe deine Dodo Payments-Integration ab und stelle sicher, dass alle neuen Kunden zum Dodo Payments-Checkout weitergeleitet werden, bevor du mit der Migration beginnst. Dies verhindert Dateninkonsistenzen während des Übergangs.
  </Accordion>

  <Accordion title="Data access authorization">
    Stelle sicher, dass du die erforderliche Autorisierung hast, um eine Datenexportanforderung bei deinem aktuellen Dienstleister zu stellen. Dies erfordert in der Regel:

    * Verifizierung des Kontoinhabers
    * Schriftliche Genehmigung für den Zugriff auf sensible Daten
    * Abschluss der Sicherheitsverifizierungsmaßnahmen deines Dienstleisters
  </Accordion>
</AccordionGroup>

## Schritt-für-Schritt-Migrationsanleitung

<Steps>
  <Step title="Request payment method export from your current processor">
    Kontaktiere das Support-Team deines aktuellen Zahlungsdienstleisters und stelle eine formelle Anfrage für einen vollständigen Export deiner Kundenkartentoken.

    Sie müssen:

    * Eine Überprüfung Ihrer Identität und Autorisierung bereitstellen
    * Anfordern, dass sie den Export mit dem PGP-Öffentlichen Schlüssel von Dodo Payments (unten bereitgestellt) verschlüsseln
    * Sie bitten, die verschlüsselte Datei direkt an unseren sicheren SFTP-Server zu übertragen

    <Info>
      Sichere Übertragungen erfolgen direkt von Server zu Server über SFTP. Dein Solutions Engineer wird die SFTP-Zugangsdaten bereitstellen, die du mit deinem aktuellen Dienstleister teilen kannst.
    </Info>

    Im Durchschnitt dauert dieser Prozess etwa **2 Wochen**, wobei die Dauer je nach Politik und Reaktionszeit deines aktuellen Dienstleisters variieren kann.
  </Step>

  <Step title="Prepare subscriber data export">
    Solange die Übertragung der Zahlungsmethode läuft, exportiere deine Abonnentendaten aus deinem Legacy-System. Dein Solutions Engineer stellt dir eine CSV-Vorlage zur Verfügung und führt dich durch die erforderlichen Felder.

    ### Erforderliche Abonnentendaten

    | Field               | Description                                            |
    | ------------------- | ------------------------------------------------------ |
    | `customer_id`       | Deine interne Kundenkennung                            |
    | `email`             | E-Mail-Adresse des Kunden                              |
    | `name`              | Vollständiger Name des Kunden                          |
    | `country`           | Zwei Buchstaben langer Ländercode (ISO 3166-1 alpha-2) |
    | `currency`          | Drei Buchstaben langer Währungscode (ISO 4217)         |
    | `payment_amount`    | Abonnementbetrag in der kleinsten Währungseinheit      |
    | `payment_interval`  | Abrechnungsfrequenz (monatlich, jährlich usw.)         |
    | `next_billing_date` | Nächstes geplantes Abrechnungsdatum (ISO 8601)         |
    | `card_token`        | Eindeutiger Token deines aktuellen Dienstleisters      |

    <Warning>
      Das Feld `card_token` ist entscheidend—es wird verwendet, um Abonnenten mit ihren Zahlungsmethoden beim Import abzugleichen. Stelle sicher, dass es genau mit dem Token im Export der Zahlungsmethode übereinstimmt.
    </Warning>

    ### Beispiel-Datenformat

    ```json theme={null}
    {
      "customers": [
        {
          "customer_id": "cus_abc123",
          "email": "jane.doe@example.com",
          "name": "Jane Doe",
          "country": "US",
          "currency": "USD",
          "payment_amount": 2999,
          "payment_interval": "monthly",
          "next_billing_date": "2025-01-15T00:00:00Z",
          "card_token": "tok_xyz789",
          "metadata": {
            "plan": "pro",
            "signup_source": "website"
          }
        }
      ]
    }
    ```
  </Step>

  <Step title="Validation and testing">
    Vor dem Importtermin wird unser Team:

    * Die Integrität und Verschlüsselung der Zahlungsmethodendaten überprüfen
    * Ihre Abonnenten-CSV auf korrekte Formatierung validieren
    * Einen Testimport in unserer Sandbox-Umgebung durchführen
    * Alle Datenzuordnungsprobleme identifizieren und lösen

    <Check>
      Du erhältst einen Validierungsbericht, der bestätigt, dass alles für den Produktionsimport bereit ist.
    </Check>
  </Step>

  <Step title="Production import">
    Am vereinbarten Importtermin wird unser Engineering-Team:

    1. Die Zahlungsmethodendaten in unseren PCI-konformen Card Vault importieren
    2. Ihre Abonnentendaten importieren
    3. Abonnenten mit ihren Zahlungsmethoden unter Verwendung der Kartentoken abgleichen
    4. Alle migrierten Abonnements aktivieren

    <Info>
      Die typische Bearbeitungsdauer beträgt **2-3 Arbeitstage** für Standardmigrationen, abhängig vom Volumen der Abonnenten.
    </Info>
  </Step>

  <Step title="Post-migration verification">
    Nach Abschluss des Imports erhältst du:

    * Einen umfassenden Migrationsbericht
    * Eine CSV, die Ihre alten Abonnement-IDs mit neuen Dodo Payments-IDs abgleicht
    * Zugriff auf alle migrierten Kunden in Ihrem Dodo Payments-Dashboard

    Wir empfehlen:

    * Eine Stichprobe der migrierten Abonnements in deinem Dashboard zu überprüfen
    * Einige Abonnementverlängerungen im Sandbox-Modus zu testen
    * Deine internen Datenbankverweise mit den neuen IDs zu aktualisieren
    * Für den ersten Abrechnungszeitraum eine parallele Überwachung durchzuführen
  </Step>
</Steps>

## Übertragbare Daten

Die folgenden Daten können während einer Abonnement-Migration übertragen werden:

| Datentyp                   | Unterstützt | Hinweise                                |
| -------------------------- | ----------- | --------------------------------------- |
| Kredit-/Debitkartennummern | ✅           | Verschlüsselt über PGP                  |
| Kartenauslaufdaten         | ✅           |                                         |
| Karteninhabernamen         | ✅           |                                         |
| Rechnungsadressen          | ✅           |                                         |
| E-Mail-Adressen der Kunden | ✅           |                                         |
| Kundenmetadaten            | ✅           | Benutzerdefinierte Schlüssel-Wert-Paare |
| Abonnementdetails          | ✅           | Plan, Betrag, Intervall                 |
| Apple Pay-Token            | ❌           | Können nicht übertragen werden          |
| Google Pay-Token           | ❌           | Können nicht übertragen werden          |
| Andere Wallet-Token        | ❌           | Können nicht übertragen werden          |
| Zahlungshistorie           | ❌           | Export von Ihrem aktuellen Anbieter     |

<Note>
  Zahlungshistorie und Transaktionsaufzeichnungen können nicht migriert werden. Wir empfehlen, diese Daten vor dem Abschluss der Umstellung von deinem aktuellen Dienstleister zu exportieren und für deine Unterlagen aufzubewahren.
</Note>

## PGP-Verschlüsselung

Für maximale Sicherheit beim Transfer sensibler Kartendaten müssen alle Dateien **verschlüsselt** werden, indem unser PGP-Öffentlicher Schlüssel verwendet wird. Dies bietet eine zusätzliche Schutzebene über die Transportverschlüsselung hinaus.

Teilen Sie diesen Schlüssel mit Ihrem aktuellen Zahlungsanbieter zur Verschlüsselung des Exports der Kartendaten:

<Accordion title="Dodo Payments PGP Public Key">
  ```
  -----BEGIN PGP PUBLIC KEY BLOCK-----

  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
  1OSDhXaPYtJnVApUzaCrC5PJCXU=
  =nHcw
  -----END PGP PUBLIC KEY BLOCK-----

  ```
</Accordion>

## Zeitrahmen-Erwartungen

| Phase                            | Dauer               |
| -------------------------------- | ------------------- |
| Erste Einrichtung und Planung    | 1-2 Tage            |
| Übertragung der Zahlungsmethode  | \~2 Wochen          |
| Vorbereitung der Abonnentendaten | 3-5 Tage (parallel) |
| Validierung und Test             | 2-3 Tage            |
| Produktionsimport                | 2-3 Werktage        |
| Nach-Migration-Verifizierung     | 1-2 Tage            |

<Tip>
  Die Gesamtmigration dauert in der Regel **3-4 Wochen** von Anfang bis Ende. Wenn du mit der Vorbereitung deiner Abonnentendaten beginnst, während die Übertragung der Zahlungsmethode läuft, verkürzt das den gesamten Zeitrahmen.
</Tip>

## Loslegen

Bereit, Ihre Abonnements zu Dodo Payments zu migrieren? Kontaktieren Sie unser Team, um den Prozess zu beginnen:

<CardGroup cols={2}>
  <Card title="Contact Support" icon="envelope" href="mailto:support@dodopayments.com">
    Kontaktiere uns, um deine Migration zu starten und dich mit einem Solutions Engineer zu verbinden.
  </Card>

  <Card title="API Documentation" icon="code" href="/api-reference/introduction">
    Erkunden Sie unsere API, um zu verstehen, wie Abonnements in Dodo Payments funktionieren.
  </Card>
</CardGroup>
