Tamara zu MCP: Buy-now-pay-later-Bestellungen, Auszahlungen und Erstattungen in jedem KI-Agent

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Tamara klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

Tamara

Tamara, Buy now, pay later (Saudi-Arabien, VAE, Kuwait, Bahrain, Oman): Bestellungen über deine Bestellnummer oder die Tamara-ID nachschlagen, mit Status sowie gecaptureten, erstatteten und ausgezahlten Beträgen, dazu Zahlungsarten und die Berechtigung von Kunden prüfen. Capture und Erstattung sind enthalten, aber bei der Installation deaktiviert.

Einrichtung

Die Einrichtung dauert etwa 2 Minuten. Du brauchst ein Tamara-Händlerkonto und dessen API-Token.

1. Melde dich im Tamara Partners Portal an und öffne API Token Management, oder nimm das API-Token, das Tamara mit deinem Händlerkonto geschickt hat. Sandbox und Produktion haben unterschiedliche Tokens.
2. Füge das Token in TAMARA_API_TOKEN ein, ohne "Bearer" und ohne Leerzeichen. Es wird als Authorization: Bearer <token> gesendet. Notification-Token und Public Key werden hier nicht verwendet.
3. Setz TAMARA_API_URL auf https://api.tamara.co für die Produktion oder https://api-sandbox.tamara.co für die Sandbox. Es muss zum Token passen.
4. Installiere den Connector und rufe tamara_list_payment_types auf: Es listet die Zahlungsarten, die dein Shop anbietet, und bestätigt das Token.

Deine Bestellnummer oder Tamaras ID: order_reference_id ist deine eigene Bestellnummer, die beim Checkout mitgeschickt wurde, etwa die Bestellnummer des Shops; order_id ist die UUID, die Tamara vergeben hat. Die meisten Fragen beginnen mit deiner Bestellnummer, also mit tamara_get_order_by_reference.

Was er liest: eine Bestellung über deine Bestellnummer oder Tamaras Bestell-ID, mit Status, Zahlungsart und Raten, Kunde, Adressen, Positionen, Gesamtbetrag, gecaptureten, erstatteten, stornierten und bezahlten Beträgen, Auszahlungsstatus und -datum sowie ihren Transaktionen (Captures, Erstattungen und Stornos); die in einem Land verfügbaren Zahlungsarten (etwa PAY_BY_INSTALMENTS oder PAY_NOW) mit Mindest- und Höchstbetrag und den möglichen Ratenzahlen, auf Wunsch nur die für einen Betrag zulässigen; vor dem Checkout, welche Zahlungsoptionen ein bestimmter Kunde für einen Betrag nutzen kann und ob Tamara einen Kunden (per Telefonnummer, E-Mail oder beidem) gerade als berechtigt ansieht; und einen registrierten Webhook mit URL, Events und Headern.

Bestellstatus: new, approved, authorised, dann partially_captured oder fully_captured und partially_refunded oder fully_refunded; canceled, declined und expired sind endgültig. paid_amount ist, was der Kunde bisher bezahlt hat; settlement_status und settlement_date zeigen, ob Tamara an dich ausgezahlt hat.

Bei der Installation deaktiviert: tamara_capture_order (captured eine autorisierte Bestellung ganz oder teilweise beim Versand, damit Tamara sie auszahlt) und tamara_refund_order (erstattet eine gecapturete Bestellung ganz oder teilweise; das Geld geht an den Kunden zurück und lässt sich nicht zurückholen). Beide bewegen Geld, deshalb schaltet ein Administrator sie bewusst ein. Auch dann zeigt dir die KI Bestellung, Betrag und Währung und wartet auf dein Ja.

Beträge und Zeiten: Beträge sind Objekte mit amount und currency; SAR und AED haben 2 Dezimalstellen, BHD, KWD und OMR 3. Zeiten sind UTC, ISO 8601.

Limits: Tamara hat keinen Endpunkt, um Bestellungen aufzulisten oder zu suchen; die KI schlägt Bestellungen deshalb über deine Bestellnummer oder Tamaras ID nach.

Häufige Fehler: 401 bedeutet ein falsches Token oder ein Token der anderen Umgebung (Sandbox oder Produktion). 404 bei einer Bestellung heißt, dass es in dieser Umgebung keine Bestellung mit dieser Referenz oder ID gibt. 400 oder 422 bei Capture oder Erstattung nennt das Feld, das Tamara abgelehnt hat, etwa einen Betrag über dem, was sich capturen lässt. 403 heißt, dass das Token funktioniert, diese API aber nicht nutzen darf; bitte Tamara, sie für dein Händlerkonto freizuschalten.

Der Connector legt keine Checkout-Sessions an, autorisiert oder storniert keine Bestellungen, nutzt nicht die Claims API und ruft keine Auszahlungsberichte ab.

Voraussetzungen: TAMARA_API_URL, TAMARA_API_TOKEN

Connector lokal installieren

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Öffne http://localhost:3000/connectors/store, wähle Tamara und trage die unter Voraussetzungen aufgelisteten Variablen ein.

Verfügbare Tools

Beispiel-Prompts

• „Welchen Status hat unsere Bestellung 100245 bei Tamara, und hat Tamara sie schon an uns ausgezahlt?“
• „Wie viel von Bestellung 100245 ist bisher gecaptured, erstattet und vom Kunden bezahlt?“
• „Welche Tamara-Zahlungsarten bietet unser Shop in Saudi-Arabien für eine Bestellung über 1.200 SAR an?“
• „Kann der Kunde mit der Telefonnummer +966501234567 800 SAR mit Tamara bezahlen?“
• „Bestellung 100245 ist versendet: Capture sie vollständig. Zeig mir vorher Bestellung und Betrag.“

Nächste Schritte

• Mit Claude verbinden
• Mit ChatGPT verbinden