Von Grund auf idempotent
Derselbe Schlüssel mit demselben Body liefert denselben Link: Ein wiederholter Aufruf erzeugt nie eine zweite Zahlung.
Entwickler
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.
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"
}'
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"
}
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"
}
Header, Felder, Status und Fehler von POST /payments/?action=fast-track. Die vollständigen Details finden Sie im Leitfaden.
| Header | Validierung |
|---|---|
X-API-Key | Ihr Wealthreader-API-Schlüssel mit aktivierten Zahlungen. |
Idempotency-Key | 16 bis 128 Zeichen: Buchstaben, Ziffern und . _ : -. Das ist Ihre Referenz der Zahlung; sie kommt in der Benachrichtigung als customer_reference zurück. |
| Feld | Validierung | Pflichtfeld |
|---|---|---|
amount | Betrag in Euro als String, mit bis zu zwei Dezimalstellen: "2450.00". Mindestens 0.01. | Ja |
currency | EUR. | Ja |
beneficiary.name | Name des Empfängers, 1 bis 140 Zeichen. | Ja |
beneficiary.iban | IBAN des Empfängers, ohne Leerzeichen und mit gültigen Prüfziffern. Sie muss nicht vorab hinterlegt werden. | Ja |
reference | Verwendungszweck, den Ihr Kunde sieht und der auf dem Kontoauszug erscheint, bis zu 140 Zeichen. | Ja |
priority | instant 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 |
payment_status | Bedeutung | outcome |
|---|---|---|
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 |
| HTTP | Code | Bedeutung |
|---|---|---|
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.
Derselbe Schlüssel mit demselben Body liefert denselben Link: Ein wiederholter Aufruf erzeugt nie eine zweite Zahlung.
Wählen Sie bei jeder Zahlung die Echtzeit- oder die Standardüberweisung. Akzeptiert die Bank keine Echtzeitüberweisung, kommt die Benachrichtigung als ko.
Senden Sie die URL Ihres Logos als SVG, und die Zahlungsseite zeigt es neben dem Namen des Empfängers an.
Ihr Kunde prüft Betrag, Empfänger und Verwendungszweck, wählt seine Bank und gibt frei. Derzeit wird die Seite auf Spanisch angezeigt.
Leitfaden Fast-Track-Zahlungen öffnen (öffnet in einem neuen Tab) API-Referenz öffnen (öffnet in einem neuen Tab) Zugang anfragen
Wir zeigen Ihnen FastTrackPay anhand der Zahlungen Ihres Unternehmens.