ArgorantDocs

Credits über einen Agenten kaufen

So kauft ein Skript oder ein KI-Agent sicher Credits. Pakete zeigen, Angebot holen, die zahlende Person fragen, dann wird die gespeicherte Karte innerhalb der Workspace-Limits belastet oder du bekommst einen Zahlungslink.

Credits gibt es in vier Paketen: 500 für 17,50 $, 5.000 für 69 $, 25.000 für 199 $ und 100.000 für 499 $. Sie werden einmal bezahlt, bleiben 365 Tage gültig und bleiben im Konto, auch wenn ein Plan gekündigt wird. Ein Credit ist ein Kontakt, ein halber Credit prüft eine E-Mail, eine Telefonnummer kostet 10.

Ein Agent kauft nie von sich aus. Er zeigt immer ein Angebot und wartet auf ein klares Ja der Person, die zahlt.

Pakete zeigen

Shell
curl "https://app.argorant.com/api/v1/credits/packs" -H "Authorization: Bearer $ARGORANT_API_KEY"

Häng ?currency=eur an, um Preise in Euro zu bekommen.

Angebot holen

Shell
curl -X POST "https://app.argorant.com/api/v1/credits/quote" \
  -H "Authorization: Bearer $ARGORANT_API_KEY" -H "Content-Type: application/json" \
  -d '{"credits": 5000, "currency": "usd"}'

Das Angebot enthält den Preis, einen Satz zum Anzeigen (summary) und payment, das sagt, wie bezahlt würde. Wenn payment.saved_card.usable den Wert true hat, wird die gespeicherte Karte direkt nach dem Ja belastet. Sonst liefert der Kauf einen Zahlungslink. Ein Angebot berechnet nichts.

Fragen

Zeig summary und bei der gespeicherten Karte, welche Karte belastet wird. Warte auf ein klares Ja.

Kaufen

Shell
curl -X POST "https://app.argorant.com/api/v1/credits/purchases" \
  -H "Authorization: Bearer $ARGORANT_API_KEY" -H "Content-Type: application/json" \
  -d '{"quote_id": "2f8a1b3c-4d5e-4f70-8192-a3b4c5d6e7f8", "confirmed": true}'

Mit einer nutzbaren gespeicherten Karte ist die Antwort status: paid, und die Credits sind sofort im Konto. Eine Quittung geht an den Inhaber des Workspace und an die kaufende Person. Ohne Karte ist die Antwort status: awaiting_payment mit checkout_url. Gib diesen Link an die Person, die zahlt. Die Credits kommen an, sobald sie bezahlt. "pay_with": "link" fordert immer einen Link an.

Prüfen

Shell
curl "https://app.argorant.com/api/v1/credits/purchases/2f8a1b3c-4d5e-4f70-8192-a3b4c5d6e7f8" -H "Authorization: Bearer $ARGORANT_API_KEY"

Ein Zahlungslink zeigt paid, sobald er bezahlt wurde, und expired, wenn er unbezahlt abgelaufen ist.

Warum das sicher ist

  • Die Angebots-ID ist der Schlüssel. Wer denselben Kauf erneut sendet, bekommt die erste Antwort zurück, und es wird nie doppelt abgebucht.
  • Eine gespeicherte Karte wird nur genutzt, wenn sie für Käufe über die API und Agenten gespeichert wurde. Die erste Zahlung über einen Link speichert sie, mit einem Hinweis auf der Zahlungsseite.
  • Der Workspace entscheidet unter Einstellungen, Abrechnung, ob Agenten die gespeicherte Karte nutzen dürfen, und kann ein Monatslimit und ein Limit pro Kauf setzen. Über einem Limit bekommt der Kauf stattdessen einen Zahlungslink.
  • Ein Kauf mit gespeicherter Karte muss innerhalb von 15 Minuten nach seinem Angebot erfolgen. Danach holst du ein neues Angebot.
  • Eine Karte, die abgelehnt wird oder eine Bestätigung des Karteninhabers braucht, wird nicht belastet. Du bekommst stattdessen einen Zahlungslink.

Postfächer auf neuen Domains kaufst du genauso mit POST /api/v1/inboxes/quote und POST /api/v1/inboxes/orders.