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

# Adyen - Zugriff auf Connect & Raw Card API

> Erzeugen Sie den API-Schlüssel, das Händlerkonto und den HMAC-signierten Webhook, die Sie benötigen, um Adyen als Ihren eigenen Prozessor mit Bring Your Own Processor (BYOP) zu verbinden.

<Note>
  Dieser Leitfaden gilt, wenn Sie **Adyen** als Ihren eigenen Prozessor über [Bring Your Own Processor (BYOP)](/features/byop) verbinden. [Kontaktieren Sie uns](mailto:founders@dodopayments.com), wenn Sie Hilfe benötigen.
</Note>

## Zugriff auf Rohkartendaten aktivieren

Bevor Dodo Zahlungen über Adyen leiten kann, muss für Ihr Adyen-Konto der **Zugriff auf Rohkartendaten** aktiviert sein. Adyen schränkt dies hinter PCI DSS-Konformität ein. Da **Dodo Payments die Rohkartendaten in Ihrem Namen verarbeitet** und **PCI DSS Level 1 konform** ist, liefern Sie Adyen **Dodo Payments' Attestation of Compliance (AOC)** — Sie benötigen keine eigene Zertifizierung.

<Card title="Dodo Payments PCI DSS Attestation of Compliance (AOC)" icon="file-shield" href="https://pub-2a89184e4c954b599464449d23f506bb.r2.dev/dodo-payments-pci-dss-aoc.pdf">
  Laden Sie die aktuelle AOC von Dodo Payments herunter und reichen Sie sie bei Adyen-Support ein, um den Zugriff auf Rohkartendaten zu aktivieren.
</Card>

Kontaktieren Sie den Adyen-Support, um den Zugriff auf Rohkartendaten für Ihr Händlerkonto anzufordern, und fügen Sie die oben genannte AOC hinzu.

## Was Sie benötigen

Um Adyen in **Einstellungen → BYOP** zu verbinden, sammeln Sie drei Werte aus Ihrem Adyen-Kundenbereich:

| Wert               | Herkunft                             |
| ------------------ | ------------------------------------ |
| **API-Schlüssel**  | Entwickler → API-Zugangsdaten        |
| **Händlerkonto**   | Ihr Adyen-Händlerkonten-Identifier   |
| **HMAC-Schlüssel** | Erzeugt beim Einrichten des Webhooks |

<Info>
  Adyen trennt **Test** (`ca-test.adyen.com`) und **Live** (`ca-live.adyen.com`) Zugangsdaten. Erzeugen Sie Zugangsdaten in der Umgebung, die dem Modus entspricht, den Sie in Dodo konfigurieren.
</Info>

## Schritt 1: API-Schlüssel erzeugen

<Steps>
  <Step title="Open API credentials">
    Gehen Sie im Adyen-Kundenbereich zu **Entwickler → API-Zugangsdaten**. Sie benötigen die Rolle **API-Zugangsdaten verwalten** oder **Händleradministrator**.
  </Step>

  <Step title="Select your credential">
    Wählen Sie die **Zahlungen** Registerkarte und wählen Sie Ihren Berechtigungsnachweis-Benutzernamen (sieht aus wie `ws_123456@Company.YourCompanyAccount`).
  </Step>

  <Step title="Generate the key">
    Gehen Sie zu **Servereinstellungen → Authentifizierung**, öffnen Sie den **API-Schlüssel** Reiter und wählen Sie **API-Schlüssel erzeugen**.
  </Step>

  <Step title="Copy it immediately">
    Kopieren und speichern Sie den Schlüssel sicher; Sie können ihn nicht erneut kopieren, nachdem Sie die Seite verlassen haben. Ein neu erzeugter Schlüssel ist sofort aktiv, und der vorherige Schlüssel bleibt 24 Stunden lang gültig.
  </Step>
</Steps>

## Schritt 2: Ihr Händlerkonto finden

Ihr **Händlerkonto** ist der Kontobezeichner, den Adyen zur Verarbeitung Ihrer Transaktionen verwendet. Es wird im Kontowähler oben im Kundenbereich angezeigt (zum Beispiel `YourCompany_ECOM`). Sie fügen dies in das **Händlerkonto**-Feld in Dodo ein.

## Schritt 3: Webhook und HMAC-Schlüssel einrichten

Dodo generiert eine **Webhook-Endpunkt** URL, wenn Sie die Adyen-Verbindung speichern. Fügen Sie diese als Webhook in Adyen hinzu und erzeugen Sie einen HMAC-Schlüssel. Sie benötigen die Rolle **Händleradministrator** oder **Händlertechnischer Integrator**.

<Steps>
  <Step title="Create a webhook">
    Gehen Sie im Kundenbereich zu **Entwickler → Webhooks** und wählen Sie **Neuen Webhook erstellen**. Wählen Sie aus der Liste **Hinzufügen** für den Typ **Standardwebhook** aus.
  </Step>

  <Step title="Configure the webhook">
    * Geben Sie eine **Beschreibung** ein.
    * Aktivieren Sie **Aktiviert**, um es zu aktivieren.
    * Unter **Serverkonfiguration** fügen Sie die von Dodo generierte **Webhook-Endpunkt** URL in das **URL** Feld ein (sie muss HTTPS sein und öffentlich zugänglich sein).
  </Step>

  <Step title="Generate the HMAC key">
    Unter **Sicherheit** im Abschnitt **HMAC-Schlüssel**, wählen Sie **Erzeugen**, um einen neuen HMAC-Schlüssel zu erstellen. Kopieren Sie ihn und speichern Sie ihn sicher; Sie können ihn später nicht erneut kopieren. Wählen Sie dann **Konfiguration speichern**.
  </Step>

  <Step title="Paste the HMAC key into Dodo">
    Zurück in **Einstellungen → BYOP**, fügen Sie den HMAC-Schlüssel in das **Webhook-Signaturgeheimnis**-Feld ein, um die Verbindung abzuschließen.

    <Card title="Set up BYOP" icon="shuffle" href="/features/byop">
      Folgen Sie dem vollständigen Setup-Prozess von Bring Your Own Processor.
    </Card>
  </Step>
</Steps>

<Tip>
  Nach dem Speichern verwenden Sie **Verbindung überprüfen** in Dodo, um einen Testanruf gegen Adyen durchzuführen und zu bestätigen, dass Ihr API-Schlüssel, Händlerkonto und Ihr HMAC-Schlüssel gültig sind, bevor Sie live gehen.
</Tip>

## Häufig gestellte Fragen

<AccordionGroup>
  <Accordion title="What is the HMAC key for?">
    Adyen signiert jeden Webhook mit einer HMAC-Signatur, damit der Empfänger die Integrität und Herkunft der Benachrichtigung überprüfen kann. Dodo verwendet den von Ihnen bereitgestellten HMAC-Schlüssel, um Webhooks von Ihrem Adyen-Konto zu validieren.
  </Accordion>

  <Accordion title="I lost my API key or HMAC key, what now?">
    Keiner von beiden kann nach der Erstellung abgerufen werden. Erzeugen Sie einen neuen API-Schlüssel unter **Entwickler → API-Zugangsdaten**, oder einen neuen HMAC-Schlüssel in den Webhook-Einstellungen, und aktualisieren Sie dann den Wert in **Einstellungen → BYOP**.
  </Accordion>

  <Accordion title="Do test and live use the same credentials?">
    Nein. Erzeugen Sie Zugangsdaten in der passenden Umgebung, entweder Test (`ca-test.adyen.com`) oder Live (`ca-live.adyen.com`), und konfigurieren Sie sie im entsprechenden Modus in Dodo.
  </Accordion>
</AccordionGroup>

## Referenzen

* [Adyen: API-Zugangsdaten](https://docs.adyen.com/development-resources/api-credentials/)
* [Adyen: Webhooks konfigurieren und verwalten](https://docs.adyen.com/development-resources/webhooks/configure-and-manage)