Konten des Kontakts#

Diese Methoden arbeiten mit den Konten des Kontakts — dem internen Guthaben im Bot: Boni, Punkte, ein Depot. Es sind dieselben Konten, mit denen die Blöcke „Kontaktkonto aufladen“ und „Vom Kontaktkonto abbuchen“ arbeiten und die in der Kontaktkarte im Tab „Konten“ zu sehen sind. Zum Beispiel kann ein Zahlungssystem dem Kontakt nach einem Kauf auf Ihrer Website Boni gutschreiben, und der Bot zeigt das Guthaben mit der Funktion getBalance an.

Für jede Währung hat der Kontakt ein eigenes Konto. Vorgänge über die API erscheinen im Journal des Kontos als „Aufladung über API“ und „Abbuchung über API“.

Achtung

Konten des Kontakts sind interne Guthaben des Bots (Boni, Punkte, Depot), keine Bankkonten: Die Plattform überweist darüber kein Geld und ist kein Zahlungsdienst. Führen Sie in Ihrem eigenen System Buch über die Operationen, die Sie über die API senden — damit können Sie die Guthaben abgleichen.

Wichtig

Beträge werden in der kleinsten Einheit der Währung — Cent — als Ganzzahl übergeben und zurückgegeben. 15000 auf einem EUR-Konto sind 150 €. Bei Währungen ohne Nachkommastellen, etwa JPY, ist die Einheit der ganze Yen. Eine einzelne Aufladung oder Abbuchung beträgt höchstens 10¹⁴ kleinste Einheiten (bei Euro eine Billion Euro); ein höherer Betrag ergibt 422.

getContactAccounts#

Gibt alle Konten eines Kontakts zurück.

curl -G "https://watbot.org/de/api/v1/getContactAccounts" \
  -H "Authorization: Bearer IHR_API_SCHLÜSSEL" \
  -H "Accept: application/json" \
  --data-urlencode "contact_id=678"

{
  "data": [
    {
      "id": 4521,
      "currency": "EUR",
      "amount": 15000,
      "amount_note": "150 EUR",
      "created_at": "2026-09-14T10:22:05+02:00",
      "updated_at": "2026-10-01T18:40:12+02:00",
      "blocked_at": null
    }
  ]
}

Die Konten kommen in der Reihenfolge ihrer Eröffnung.

addContactAccount#

Eröffnet für den Kontakt ein Konto in einer Währung. Dieselbe Methode ist auch unter dem Namen createContactAccount erreichbar.

curl -X POST "https://watbot.org/de/api/v1/addContactAccount" \
  -H "Authorization: Bearer IHR_API_SCHLÜSSEL" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"contact_id": 678, "currency": "EUR"}'

{
  "data": {
    "id": 4521,
    "currency": "EUR",
    "amount": 0,
    "amount_note": "0 EUR",
    "created_at": "2026-10-03T12:00:00+02:00",
    "updated_at": "2026-10-03T12:00:00+02:00",
    "blocked_at": null
  }
}

{
  "message": "Der Kontakt hat bereits ein Konto in dieser Währung.",
  "code": "currency_exists",
  "errors": {
    "currency": [
      "Der Kontakt hat bereits ein Konto in dieser Währung."
    ]
  }
}

Besonderheiten:

• Hat der Kontakt bereits ein Konto in dieser Währung — 422 mit einem Fehler im Feld currency.
• Für Blöcke im Szenario muss das Konto nicht vorab existieren: Der Block „Kontaktkonto aufladen“ eröffnet es selbst. Die Aufladung über die API braucht es dagegen, denn sie arbeitet mit account_id.

deleteContactAccount#

Löscht ein Konto des Kontakts.

curl -X POST "https://watbot.org/de/api/v1/deleteContactAccount" \
  -H "Authorization: Bearer IHR_API_SCHLÜSSEL" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"account_id": 4521}'

{
  "message": "Ein Konto mit einem Guthaben von 150 EUR kann nicht gelöscht werden.",
  "code": "account_not_empty",
  "errors": {
    "account_id": [
      "Ein Konto mit einem Guthaben von 150 EUR kann nicht gelöscht werden."
    ]
  }
}

Die Antwort ist der Status 204 ohne Inhalt.

Gelöscht werden kann nur ein leeres Konto. Liegt Geld darauf — 422 mit einem Fehler im Feld account_id; buchen Sie zuerst den Rest ab.

addFundsToContactAccount#

Lädt ein Konto auf.

curl -X POST "https://watbot.org/de/api/v1/addFundsToContactAccount" \
  -H "Authorization: Bearer IHR_API_SCHLÜSSEL" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"account_id": 4521, "amount": 15000, "description": "Bonus für Bestellung A-1024"}'

{
  "data": {
    "id": 4521,
    "currency": "EUR",
    "amount": 15000,
    "amount_note": "150 EUR",
    "created_at": "2026-10-03T12:00:00+02:00",
    "updated_at": "2026-10-03T12:05:41+02:00",
    "blocked_at": null
  }
}

Ein gesperrtes Konto lässt sich trotzdem aufladen.

withdrawFundsFromContactAccount#

Bucht von einem Konto ab.

curl -X POST "https://watbot.org/de/api/v1/withdrawFundsFromContactAccount" \
  -H "Authorization: Bearer IHR_API_SCHLÜSSEL" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"account_id": 4521, "amount": 5000, "description": "Versandkosten"}'

{
  "data": {
    "id": 4521,
    "currency": "EUR",
    "amount": 10000,
    "amount_note": "100 EUR",
    "created_at": "2026-10-03T12:00:00+02:00",
    "updated_at": "2026-10-03T12:07:15+02:00",
    "blocked_at": null
  }
}

{
  "message": "Nicht genügend Guthaben. Aktueller Kontostand: 100 EUR.",
  "code": "insufficient_funds",
  "errors": {
    "account_id": [
      "Nicht genügend Guthaben. Aktueller Kontostand: 100 EUR."
    ]
  }
}

Eine Abbuchung bringt das Konto nie ins Minus, auch nicht bei gleichzeitigen Anfragen. Ist die Abbuchung nicht möglich, ändert die Methode nichts und antwortet mit 422 und einem Fehler im Feld account_id:

Zuerst wird die Sperre geprüft, dann das Guthaben.

Fehler bei Konten#

• Kein Kontakt oder Konto mit dieser ID, Kontakt gelöscht oder sein Bot gelöscht — 404.
• Kontakt oder Konto aus einem fremden Bot — 403.
• Fehler dieser Methoden sind 422 mit den Feldern message, code und errors. Der Fehlertext ist in der Sprache der Anfrage (Header Accept-Language), prüfen Sie im Code daher code:

Allgemeine Fehler der API finden Sie unter Fehler.