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

# Unzer

> Sieh die Unzer-Zahlung per Rechnungskauf oder Ratenkauf zur Bestellung direkt im Ticket – und lass KI-Agenten sie lesen oder das Mahnwesen einmalig verzögern.

Die Unzer-Integration verbindet dein Unzer-Konto mit Chatarmin CX. Hat eine Kundin per Rechnungskauf oder Ratenkauf bezahlt, sieht dein Team die Zahlung zur Bestellung direkt im Ticket – inklusive Bankverbindung und Verwendungszweck – statt dafür das Unzer Merchant Portal in einem zweiten Tab zu öffnen.

> [!NOTE]
>
> Unzer erscheint im **Kundenpanel** eines Tickets. Die Integration erzeugt keine Tickets und sendet keine Benachrichtigungen. Die Karte selbst liest ausschließlich. Ein KI-Agent kann zusätzlich das Mahnwesen einmalig verzögern – aber nur, wenn du ihm diese Aktion gibst, und er fragt vorher nach deiner Freigabe, siehe [Unzer in KI-Agenten nutzen](#unzer-in-ki-agenten-nutzen).

## Wann du es brauchst

Nutze Unzer, wenn du über Unzer auf Rechnung oder in Raten verkaufst und dein Team oft Folgendes bearbeitet:

* „Ist meine Rechnung angekommen?“ und „Auf welches Konto zahle ich?“
* „Welchen Verwendungszweck gebe ich an?“
* „Ich kann vor dem Gehalt nicht zahlen – könnt ihr die Mahnungen stoppen?“
* Rückfragen zu Retouren und Erstattungen, für die jemand wissen muss, was tatsächlich eingezogen wurde

## Was die Karte sagt, und was nicht

Die Unzer-API meldet, **was dein Shop eingezogen hat**, nicht ob die **Kundin bezahlt hat**. Es gibt dort weder ein Fälligkeitsdatum noch eine Kennzeichnung „ausgeglichen“.

Deshalb zeigt die Karte „Charged“ (eingezogen) und „Left to charge“ (noch einzuziehen) – nie „Paid“. „Eingezogen 59,90 €, noch einzuziehen 0,00 €“ heißt: Unzer hat die Rechnung für dich eingezogen. Die Überweisung der Kundin kann trotzdem noch unterwegs sein. Ob tatsächlich gezahlt wurde, steht in Unzer Insights und in den Abstimmungsdateien von Unzer, nicht auf dieser Karte.

## Einrichten

Du brauchst den **Private Key** deines Unzer-Kontos. Wenn du über Unzer abrechnest, hast du ihn bereits – er steht in Unzer Insights bei deinen API-Keys. Das Verbinden dauert etwa zwei Minuten und braucht keine Freigabe von Unzer.

**1. Private Key in Unzer kopieren**

Öffne in **Unzer Insights** deine API-Keys und kopiere den **Private Key**. Er beginnt mit `p-priv-` für dein Live-Konto oder mit `s-priv-` für ein Sandbox-Konto.

Der Public Key (`p-pub-`/`s-pub-`) ist für Checkout-Seiten und funktioniert hier nicht.

**2. Integrationen öffnen**

[Öffne die Integrationen](https://armin.cx/app/_/settings/integrations) in deinen Workspace-Einstellungen und wähle **Unzer**.

Wird Unzer nicht angezeigt, wende dich an dein Chatarmin-CX-Team, damit es für deinen Workspace freigeschaltet wird.

**3. Unzer-Konto verbinden**

Klicke **Connect**, füge den **Private Key** ein und speichere. Chatarmin CX prüft ihn vorher bei Unzer. Lehnt Unzer ihn ab, siehst du den Grund und es wird nichts gespeichert.

Eine Umgebung wählst du nicht aus: Der Key sagt selbst, wohin er gehört – ein Sandbox-Key spricht immer mit der Sandbox.

## Unzer im Posteingang nutzen

Ist Unzer verbunden, erscheint im Kundenpanel eines Tickets eine **Unzer**-Karte. Aufgeklappt zeigt sie die Zahlungen zu den jüngsten Bestellungen des Kontakts, neueste zuerst – bis zu drei.

Pro Zahlung zeigt die Karte:

* Den **Status** von Unzer: „Charged“, „Partly charged“, „Pending“, „Canceled“, „In review“ oder „Chargeback“
* Den **Gesamtbetrag**, den eingezogenen Betrag („Charged“), den Betrag, der noch einzuziehen ist („Left to charge“), sowie stornierte oder erstattete Beträge („Cancelled or refunded“)
* Die **Bankverbindung** für die Überweisung: IBAN, Kontoinhaber und den **Verwendungszweck** – beide mit einem Klick kopierbar
* „Dunning delayed“, wenn die eine Verzögerung, die Unzer erlaubt, bereits genutzt wurde
* Die **Payment-ID** von Unzer, damit du sie dem Unzer-Support nennen kannst

Das gezeigte Konto gehört Unzer, nicht der Kundin. Es ist dasselbe Konto, das auf ihrer Rechnung steht.

### Wenn die Karte nichts zeigt

> [!NOTE]
>
> Die Texte der Unzer-Karte sind vorerst nur auf Englisch verfügbar; die Übersetzung folgt. Unten stehen sie daher im Original.

| Situation | Was du siehst |
| - | - |
| Der Kontakt hat keine Unzer-Bestellungen | „No Unzer payment on this customer's recent orders“ |
| Unzer kennt die Zahlung zur Bestellung nicht | „Unzer has no record of the payment on this customer's order.“ |
| Unzer drosselt gerade | „Unzer is busy right now. Try again in a moment.“ mit **Erneut versuchen** |
| Der Private Key wurde abgelehnt | „Unzer rejected this connection's key. Reconnect it in the integration settings.“ |
| Unzer ist nicht erreichbar | „Could not load Unzer payments.“ mit **Erneut versuchen** |

Die Karte muss wissen, welche Bestellungen zum Kontakt gehören, und die Unzer-Referenz steht auf der Shopify-Bestellung. Fehlt diese Verknüpfung, bleibt die Karte leer – meist bei Social-DMs und bei Bestellungen aus einem Shop, der nicht mit Chatarmin CX verbunden ist.

## Unzer in KI-Agenten nutzen

Gib einem [KI-Agenten](https://docs.armin.cx/de/ai-agents/skills-and-actions.md) Unzer-Aktionen und wähle die Unzer-Verbindung, die er nutzen darf. Es gibt zwei, und du entscheidest, welche er bekommt:

| Aktion | Was sie tut | Freigabe |
| - | - | - |
| **Unzer-Zahlung lesen** | Liest eine Zahlung: Status, Beträge sowie Bankverbindung und Verwendungszweck. | Nicht nötig, sie liest nur |
| **Unzer-Mahnwesen verzögern** | Verzögert das Mahnwesen einmalig, damit eine Kundin nicht gemahnt wird, während Retoure, Erstattung oder Überweisung noch laufen. | **Jedes Mal angefragt** (Standard) |

Aktiviere **Unzer-Zahlung lesen** zusammen mit deiner Shopify-Aktion **Bestellung lesen**. Der Agent nimmt die Unzer-Referenz aus der gerade gelesenen Bestellung; einen anderen Weg zur Zahlung hat er nicht.

> [!WARNING]
>
> Unzer erlaubt **eine** Verzögerung pro Zahlung und lehnt eine zweite ab. Der Agent prüft das vor dem Schreiben und sagt dir, wenn bereits eine genutzt wurde, statt vor der Kundin zu scheitern.

Drei Grenzen sind fest eingebaut:

* Chatarmin CX prüft jede Zahlungsreferenz gegen die Bestellungen des Ticket-Kontakts, bevor Unzer überhaupt aufgerufen wird. Eine Referenz von woanders wird abgelehnt – beim Lesen, beim Schreiben und auch nach deiner Freigabe.
* Geht die Antwort auf eine Verzögerung verloren – Timeout, Störung –, meldet der Agent das als unklares Ergebnis statt als schlichten Fehlschlag und liest die Zahlung erneut, bevor er es noch einmal versucht; ein zweiter Versuch würde abgelehnt.
* In einem Testlauf erreicht kein Schreibvorgang Unzer; er wird simuliert.

> [!TIP]
>
> Schreib deinem Agenten in die Instruktionen, dass „eingezogen“ nicht „bezahlt“ heißt. Die Aktion sagt es ihm auch – aber deine Formulierung ist die, die bei der Kundin ankommt.

## Daten und Zugriff

Pro Abfrage sendet Chatarmin CX nur die auf der Bestellung hinterlegte Zahlungsreferenz an Unzer. Dein Private Key wird verschlüsselt gespeichert und nach dem Speichern nie wieder angezeigt.

Nach Unzer geschrieben wird nur, wenn du einem KI-Agenten die Aktion **Unzer-Mahnwesen verzögern** gibst. Das ist der einzige Schreibvorgang dieser Integration; er ist standardmäßig freigabepflichtig und wird im Lauf mit der betroffenen Zahlung protokolliert – nie mit Kundendaten.

> [!NOTE]
>
> Ein Unzer Private Key ist nicht auf Lesen beschränkt: Es ist derselbe Key, der einziehen und erstatten kann. Chatarmin CX authentifiziert sich, liest eine Zahlung samt Transaktion und führt den einen Schreibvorgang „Mahnwesen verzögern“ aus – mehr nicht. Behandle den Key trotzdem wie jedes Zahlungs-Credential und rotiere ihn in Unzer Insights, falls er je offenliegt.

## Unzer ändern oder trennen

Zum Ändern klickst du die Verbindung in den [Integrationen](https://armin.cx/app/_/settings/integrations) an. Lass **Private Key** leer, um den gespeicherten zu behalten.

Zum Trennen öffnest du im Menü **Connected** der Verbindung **Disconnect** und bestätigst mit **Delete**. Die Unzer-Karte verschwindet aus den Tickets, und KI-Agenten-Aktionen auf dieser Verbindung funktionieren nicht mehr. An deinen Zahlungen und deinem Unzer-Konto ändert sich nichts.

## Fehlerbehebung

### Die Verbindung lässt sich nicht speichern

* Prüfe, ob der Key vollständig und ohne Leerzeichen kopiert wurde.
* Stelle sicher, dass es der **Private** Key ist (`p-priv-` oder `s-priv-`), nicht der Public Key.
* Meldet Unzer, dass es nicht erreichbar ist, statt den Key abzulehnen, ist das eine Störung bei Unzer. Versuche es gleich noch einmal; gespeichert wurde nichts.

### Die Verbindung verlangt eine Neuverbindung

Wird der Key in Unzer Insights rotiert oder gelöscht, ist er ungültig. Kopiere den neuen Private Key und trage ihn in der Verbindung ein.

### Die Karte zeigt eine Zahlung, die Kundin sagt, sie habe bezahlt

Das ist erwartbar – siehe [Was die Karte sagt, und was nicht](#was-die-karte-sagt-und-was-nicht). Die Überweisung der Kundin meldet Unzer hier nicht. Prüfe Unzer Insights oder deine Abstimmungsdatei, bevor du einer Kundin sagst, ihre Rechnung sei abgeschlossen.

### Der Agent findet die Zahlung nicht

Der Agent braucht die Referenz aus der Shopify-Bestellung. Prüfe, ob die Shopify-Aktion **Bestellung lesen** auf demselben Agenten aktiv ist und ob die Bestellung tatsächlich über Unzer bezahlt wurde – Bestellungen per Karte oder PayPal tragen keine Unzer-Referenz.

Hilft das alles nicht, wende dich an den Chatarmin-CX-Support. Nenne den Ticket-Link und die Unzer-Payment-ID, niemals deinen Private Key.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.