Ihr KI-Agent und Paddle-Erstattungen: „beantragt“ ist nicht „erstattet“
Paddle prüft Erstattungen vor der Auszahlung, und seine API kennt keine Idempotenzschlüssel. Zwei Gründe, warum ein KI-Agent auf Paddle dem Kunden das Falsche sagen – oder doppelt erstatten – kann.
Ihr Support-Agent kann jetzt auch auf Paddle Billing erstatten, nicht nur auf Stripe. Paddle ist ein Merchant of Record, und das ändert zwei Dinge, die ein KI-Agent leicht falsch macht.
1. Eine Paddle-Erstattung ist ein Antrag, keine Auszahlung
Auf Paddle ist eine Erstattung ein Adjustment. Nach dem Anlegen wartet es meist auf Paddles Prüfung – Status pending_approval – und wird erst später approved (oder rejected). Es ist noch kein Geld geflossen.
Ein Agent, der „Erledigt, Ihre 29 € sind erstattet“ sagt, sobald die API antwortet, erzählt dem Kunden etwas, das noch nicht stimmt – und vielleicht nie stimmen wird.
| Feld | Erwartet | Beobachtet |
|---|---|---|
| Status der Erstattung | approved | pending_approval |
| dem Kunden gesagt | „beantragt“ | „erstattet“ |
Mit COLVO zeigt die Operation Wartet auf Paddle. Sie wird erst VERIFIED, wenn Paddle die Erstattung genehmigt – über Paddles signierte Benachrichtigung oder COLVOs stündliche Prüfung. Lehnt Paddle ab, schlägt die Operation fehl, das Budget wird freigegeben und ein Incident erinnert Sie daran, den Kunden zu informieren. Unsere SDKs formulieren es bereits richtig: messageFor(op) sagt, die Erstattung sei beantragt, solange Paddle sie prüft.
2. Ein Wiederholungsversuch kann zur zweiten Erstattung werden
Paddles API hat keine Idempotenzschlüssel. Geht die Antwort auf eine Erstattung verloren – ein Timeout, eine abgebrochene Verbindung –, erzeugt eine naive Wiederholung eine zweite Erstattung.
COLVO markiert jede Erstattung, die es anlegt, mit seiner Operations-ID und sucht vor jeder Wiederholung nach dieser Markierung. Eine verlorene Antwort wird gefunden, nicht wiederholt. Das Szenario Wiederholung nach verlorener Antwort belegt es bei jedem Lauf: Am Ende muss genau eine Erstattung existieren.
Testen Sie es, bevor ein Kunde es tut
COLVO führt jetzt 12 Paddle-Szenarien gegen ein simuliertes Paddle aus: IDs im Paddle-Format (ctm_, sub_, txn_), Erstattungen, die auf Prüfung warten, keine Idempotenzschlüssel. Wählen Sie Paddle unter Szenarien wählen… – die Tools Ihres Agenten bleiben gleich.
- Die Paddle-Szenarien
- Leitfaden: einen Paddle-Erstattungsagenten testen und absichern
- Paddle-Integration
Planwechsel und Rabatte gibt es vorerst nur auf Stripe; auf Paddle kann COLVO erstatten, kündigen, pausieren, fortsetzen und eine geplante Kündigung zurücknehmen.
