> ## Documentation Index
> Fetch the complete documentation index at: https://docs.armin.cx/llms.txt
> Use this file to discover all available pages before exploring further.
# PayPal
> PayPal-Streitfälle im Kundenpanel des Posteingangs ansehen und bearbeiten — auch mit KI-Agenten.
Die PayPal-Integration lässt dein Team PayPal-Streitfälle bearbeiten, ohne Chatarmin CX zu verlassen. Wenn die E-Mail des Ticket-Kontakts zur Käufer-E-Mail eines verbundenen PayPal-Kontos passt, erscheinen Streitfälle im Kundenpanel — Agenten sehen den Fall im Ticket-Kontext und können antworten.
PayPal-Streitfälle erscheinen im **Kundenpanel** eines Tickets. Sie erzeugen keine eigenen Posteingang-Tickets und keine E-Mail-Benachrichtigungen von PayPal.
## Wann du es brauchst
Nutze PayPal, wenn du Zahlungen über PayPal annimmst und dein Support-Team regelmäßig Folgendes bearbeitet:
* Chargebacks und Zahlungsstreitigkeiten
* Käuferansprüche wegen nicht erhaltenen oder abweichenden Artikeln
* Fristen für Nachweise und Angebote, bevor ein Fall eskaliert
Die Integration hält Ticket-Kontext, Kundenhistorie und Streitfalldetails an einem Ort — statt in einem zweiten Tab im [PayPal Resolution Center](https://www.paypal.com/disputes/).
## PayPal einrichten
Du brauchst eine PayPal-REST-App mit aktivierten **Disputes**. Lege die App im [PayPal Developer Dashboard](https://developer.paypal.com/dashboard/) an oder öffne sie dort.
[Öffne Integrationen](https://armin.cx/app/_/settings/integrations) in den Workspace-Einstellungen und wähle **PayPal**.
Wenn PayPal nicht in der Liste steht, wende dich an dein Chatarmin-CX-Team, um die Funktion für deinen Workspace freizuschalten.
Klick auf **Verbinden**, gib optional einen Anzeigenamen ein (sinnvoll bei mehreren Händlerkonten), und füge **Client ID** und **Client Secret** deiner REST-App ein.
Wiederhole **Verbinden** für jedes PayPal-Händlerkonto, das dein Team betreut. Jedes Konto synchronisiert eigene Streitfälle.
Nutze einen klaren Anzeigenamen wie `EU-Shop PayPal`, wenn du mehrere Konten verbindest — so erkennen Agenten, zu welchem Händlerkonto ein Streitfall gehört.
## PayPal im Posteingang nutzen
Wenn PayPal verbunden ist und der Ticket-Kontakt eine E-Mail-Adresse hat, gleicht cx diese E-Mail mit indexierten PayPal-Streitfällen deiner Organisation ab.
1. Öffne ein Ticket mit einem Kontakt, der eine E-Mail-Adresse hat.
2. Im **Kundenpanel** findest du den Bereich **Streitfälle**, sobald passende Fälle für diesen Kontakt existieren.
3. Klick auf einen Streitfall, um Details zu öffnen: Status, Betrag, Zeitverlauf, Nachrichten und Nachweisanfragen.
4. Unter **Auf Streitfall antworten** führst du die Aktionen aus, die PayPal für diesen Fall erlaubt — z. B. Nachricht senden, Angebot machen, Nachweise einreichen, eskalieren, Anspruch akzeptieren, Berufung einlegen oder Rücksendung bestätigen.
5. **Im PayPal Resolution Center öffnen** nutzt du, wenn du die volle PayPal-Oberfläche brauchst.
Abgeschlossene Streitfälle bleiben in der Liste sichtbar, damit Agenten frühere Fälle desselben Kunden sehen.
### Wie Streitfälle aktuell bleiben
cx indexiert Streitfälle aus PayPal, wenn sie angelegt oder aktualisiert werden. Ein Hintergrund-Sync läuft zusätzlich alle paar Stunden und holt Fälle nach, die außerhalb von cx geändert wurden. Nach einer Aktion in cx aktualisiert sich der Fall automatisch.
### Streitfälle Kontakten zuordnen
Die Zuordnung läuft über die **Käufer-E-Mail**. Primäre E-Mail und weitere E-Mail-Identifikatoren des Kontakts werden berücksichtigt.
| Situation | Was du siehst |
| ------------------------------------------ | ---------------------------------------------------- |
| PayPal nicht verbunden | Kein Bereich Streitfälle |
| Kontakt ohne E-Mail | E-Mail am Kontakt ergänzen, um Streitfälle zu suchen |
| E-Mail vorhanden, keine Treffer | Bereich Streitfälle bleibt ausgeblendet |
| E-Mail passt zu einem oder mehreren Fällen | Liste mit offenen und abgeschlossenen Fällen |
## Streitfall-Aktionen im Posteingang
Verfügbare Aktionen hängen vom aktuellen Fallstatus ab. PayPal steuert, welche Antworten in welcher Phase erlaubt sind.
| Aktion | Typischer Einsatz |
| ------------------------ | ------------------------------------------------------------- |
| Nachricht senden | Dem Käufer im Streitfall-Thread antworten |
| Angebot machen | Erstattung, Ersatz oder andere Lösung vorschlagen |
| Nachweise einreichen | Angeforderte Notizen und Dateien an PayPal senden |
| Zur Forderung eskalieren | Fall voranbringen, wenn keine Einigung möglich ist |
| Anspruch akzeptieren | Verlust akzeptieren, wenn du nicht weiter kämpfst |
| Berufung | Entscheidung nach Prüfung anfechten |
| Rücksendung bestätigen | Bestätigen, dass die vom Käufer gesendete Ware angekommen ist |
**Anspruch akzeptieren** und manche Angebote können Geldbewegungen auslösen. cx fragt vor destruktiven Aktionen im Posteingang nach. Prüfe Betrag und Angebotstyp vor dem Absenden.
### Nachweisdateien
Wenn PayPal Nachweise verlangt, kannst du Dateien von deinem Rechner mit einreichen. Unterstützt sind PDF, PNG, JPG und GIF. Pro Datei maximal 10 MB, insgesamt maximal 50 MB pro Anfrage. Notizen sind auf 2.000 Zeichen begrenzt.
## KI-Agenten-Aktionen
Aktiviere PayPal-Aktionen auf einem [KI-Agenten](/de/ai-agents/skills-and-actions), wenn Automatisierung Streitfälle nachschlagen oder Antworten auf streitfallbezogene Tickets vorbereiten soll. Der Agent braucht ein Ticket mit einem Kontakt, der eine E-Mail-Adresse hat.
Verbinde PayPal zuerst, aktiviere dann die Aktionen am Agenten und wähle, welche verbundenen PayPal-Konten der Agent nutzen darf.
### Lese-Aktionen
* **List PayPal disputes** — Indexierte Streitfälle zur E-Mail des Ticket-Kontakts finden.
* **Get PayPal dispute** — Live-Details laden, bevor du schreibst. Immer nach dem Auflisten nutzen.
### Schreib-Aktionen
* **Send message** — Im Streitfall-Thread antworten.
* **Make offer** — Lösungsvorschlag machen.
* **Provide evidence** — Nachweise und optionale Anhänge aus Kundennachrichten im Ticket einreichen.
* **Escalate** — Zur Forderung eskalieren, wenn erlaubt.
* **Accept claim** — Streitverlust akzeptieren.
* **Appeal** — Berufung einlegen, wenn erlaubt.
* **Acknowledge returned item** — Wareneingang bestätigen.
Finanzielle Schreib-Aktionen wie **Accept claim** und **Make offer** verlangen standardmäßig eine [menschliche Freigabe](/de/ai-agents/human-in-the-loop). Passe die Freigabe pro Aktion in der Agenten-Konfiguration an.
Schreib in den Agenten-Anweisungen, dass zuerst Streitfälle gelistet, dann **Get PayPal dispute** für den Zielfall aufgerufen werden soll — und nur Angebots- oder Akzept-Typen genutzt werden, die in den Live-Details stehen.
## Best Practices
* Halte die Kontakt-E-Mail mit der E-Mail synchron, die der Kunde bei PayPal genutzt hat. Aktualisiere den Kontakt, wenn er von einer anderen Adresse schreibt.
* Nutze Anzeigenamen bei mehreren PayPal-Konten, damit Agenten und KI-Agenten das richtige Konto wählen.
* Verlange Freigaben für geldwirksame Aktionen, bis du dem Agenten-Playbook vertraust.
* Teste mit PayPal-Sandbox-App und -Zugangsdaten in einem Nicht-Produktions-Workspace, bevor du live gehst.
* Bei komplexen Fällen: Kontext in cx, Resolution-Center-Link für reine PayPal-Schritte.
## Fehlerbehebung
### Verbindungstest schlägt fehl
* Prüfe im PayPal Developer Dashboard, ob **Disputes** für die REST-App aktiv ist.
* Client ID und Client Secret müssen zur gleichen App und Umgebung (Live vs. Sandbox) gehören.
* Wurde das Secret in PayPal widerrufen, erneuere es und aktualisiere die Integration in cx.
### Keine Streitfälle für einen Kunden
* Stimmt die Kontakt-E-Mail mit der Käufer-E-Mail bei PayPal überein?
* Gib der Indexierung nach dem Verbinden etwas Zeit — neue und geänderte Fälle synchronisieren automatisch; der periodische Abgleich kann in Randfällen ein paar Stunden dauern.
* Gehört der Streitfall zu einem PayPal-Konto, das du in diesem Workspace verbunden hast?
### Aktion nicht verfügbar
PayPal erlaubt nur bestimmte Antworten pro Fallstatus. Öffne die Details in cx oder im Resolution Center. Wurde der Fall außerhalb von cx in PayPal geändert, schließe das Detail-Sheet und öffne es erneut.