Entwickler

Ein Aufruf. Ein Zahlungslink.

FastTrackPay ist ein Endpunkt der Zahlungs-API von Wealthreader: HTTPS und JSON. Senden Sie die Zahlung, leiten Sie Ihren Kunden weiter und erhalten Sie die Benachrichtigung mit Ihrer Referenz.

Zum Start aktivieren wir die Zahlungen und Ihr Zahlungsprofil auf Ihrem Wealthreader-API-Schlüssel. Wenn Sie die API bereits nutzen, ist es derselbe Schlüssel.

  1. Zahlung erstellen

    Ein POST mit Ihrem API-Schlüssel, einem Idempotenzschlüssel, der zugleich Ihre Referenz ist, und dem Body der Zahlung: Betrag, Währung, Empfänger, Verwendungszweck, Priorität und Benachrichtigungs-URL.

    # Zahlung erstellen
    curl 'https://api.wealthreader.com/payments/?action=fast-track' \
      -H "X-API-Key: $API_KEY" \
      -H "Idempotency-Key: invoice-F-2026-104" \
      -H "Content-Type: application/json" \
      -d '{
        "amount": "2450.00",
        "currency": "EUR",
        "beneficiary": {
          "name": "Beispielfirma GmbH",
          "iban": "ES9121000418450200051332"
        },
        "reference": "Rechnung F-2026-104",
        "priority": "instant",
        "notification_url": "https://example.com/payments/notice"
      }'
  2. Kunden zum Link leiten

    Die Antwort enthält die URL der Zahlung und ihre Kennung. Leiten Sie Ihren Kunden zur URL weiter: Sie läuft nach wenigen Minuten ab (standardmäßig 15), erstellen Sie sie also erst, wenn er zahlen will.

    {
      "url": "https://widget.wealthreader.com/payments/pay/#payment_intent_id=…&widget_token=…",
      "payment_intent_id": "22222222-2222-4222-8222-222222222222"
    }
  3. Benachrichtigung empfangen

    Erreicht die Zahlung einen Endstatus, senden wir einen POST an Ihre notification_url mit outcome ok oder ko und Ihrer Referenz in customer_reference. Antworten Sie mit einem 2xx-Code.

    Die Benachrichtigung kann mehr als einmal eintreffen und ist nicht signiert: Bevor Sie etwas Wertvolles übergeben, bestätigen Sie den Status mit POST /payments/?action=status.

    {
      "outcome": "ok",
      "payment_status": "settled",
      "customer_reference": "invoice-F-2026-104",
      "payment_intent_id": "22222222-2222-4222-8222-222222222222"
    }

Kurzreferenz

Header, Felder, Status und Fehler von POST /payments/?action=fast-track. Die vollständigen Details finden Sie im Leitfaden.

Header der Anfrage
HeaderValidierung
X-API-KeyIhr Wealthreader-API-Schlüssel mit aktivierten Zahlungen.
Idempotency-Key16 bis 128 Zeichen: Buchstaben, Ziffern und . _ : -. Das ist Ihre Referenz der Zahlung; sie kommt in der Benachrichtigung als customer_reference zurück.
Felder im Body
FeldValidierungPflichtfeld
amountBetrag in Euro als String, mit bis zu zwei Dezimalstellen: "2450.00". Mindestens 0.01.Ja
currencyEUR.Ja
beneficiary.nameName des Empfängers, 1 bis 140 Zeichen.Ja
beneficiary.ibanIBAN des Empfängers, ohne Leerzeichen und mit gültigen Prüfziffern. Sie muss nicht vorab hinterlegt werden.Ja
referenceVerwendungszweck, den Ihr Kunde sieht und der auf dem Kontoauszug erscheint, bis zu 140 Zeichen.Ja
priorityinstant für Echtzeitüberweisung oder normal für Standardüberweisung.Ja
notification_urlÖffentliche https-URL, an die wir die Benachrichtigung ok oder ko senden.Ja
logoÖffentliche https-URL des Logos Ihres Unternehmens als SVG, das die Zahlungsseite neben dem Empfänger anzeigt.Nein
Zahlungsstatus und Benachrichtigung
payment_statusBedeutungoutcome
settled Die Bank hat die Zahlung abgewickelt. ok
rejected Die Bank hat die Zahlung abgelehnt, auch wegen des Betrags oder weil sie keine Echtzeitüberweisung annimmt. ko
cancelled Die Zahlung wurde vor dem Abschluss abgebrochen. ko
expired Die Zahlungssitzung ist abgelaufen, ohne abgeschlossen zu werden. ko
failed Die Zahlung konnte nicht abgeschlossen werden. ko
pending In Bearbeitung: noch kein Endstatus. Noch keine Benachrichtigung
Fehlercodes
HTTPCodeBedeutung
400 idempotency_key_required Der Header Idempotency-Key fehlt oder hat eine ungültige Länge.
401 invalid_api_key Ungültiger API-Schlüssel.
403 payments_not_allowed, payment_profile_required Für Ihren Schlüssel sind keine Zahlungen aktiviert oder es fehlt das Zahlungsprofil.
409 idempotency_conflict Sie haben einen Idempotency-Key mit anderen Daten wiederverwendet.
422 invalid_request, invalid_amount, invalid_beneficiary, invalid_notification_url Ungültiger Body: ein überzähliges oder fehlendes Feld oder ein falscher Betrag, Empfänger oder eine falsche Benachrichtigungs-URL.
429 api_limit_reached Sie haben das Aufruflimit erreicht.
503 payments_disabled Zahlungen sind derzeit nicht verfügbar.

Fehler liefern ein JSON mit success auf false und dem Code aus der Tabelle in error.code.

Details zur Integration

Von Grund auf idempotent

Derselbe Schlüssel mit demselben Body liefert denselben Link: Ein wiederholter Aufruf erzeugt nie eine zweite Zahlung.

Echtzeit oder Standard

Wählen Sie bei jeder Zahlung die Echtzeit- oder die Standardüberweisung. Akzeptiert die Bank keine Echtzeitüberweisung, kommt die Benachrichtigung als ko.

Ihre Marke in der Zahlung

Senden Sie die URL Ihres Logos als SVG, und die Zahlungsseite zeigt es neben dem Namen des Empfängers an.

Die Zahlungsseite

Ihr Kunde prüft Betrag, Empfänger und Verwendungszweck, wählt seine Bank und gibt frei. Derzeit wird die Seite auf Spanisch angezeigt.

Bitten Sie Ihren Kunden nicht um eine Überweisung: Senden Sie ihm die vorbereitete Zahlung

Wir zeigen Ihnen FastTrackPay anhand der Zahlungen Ihres Unternehmens.

Demo anfragen