Fehlercodes

Katalog der Codes

Stabile maschinenlesbare Kennungen, die in code zurückgegeben werden (und je Feld in errors[].code). Das ist der tatsächlich vorhandene Satz — jeder Code unten wird von mindestens einem Handler, Validator oder einer Middleware der laufenden API erzeugt, keine theoretische Obermenge. Bestehende Codes ändern nie ihre Bedeutung, und neue kommen hinzu, wenn neue Fälle entstehen. Umbenannt wird ein Code nur in seltenen Fällen, und jede Umbenennung steht im Changelog.

Verzweigen Sie für die programmatische Behandlung auf code. detail ist ausschließlich englisch und für Protokolle oder eine Notfall-Oberfläche gedacht; lokalisieren Sie im Client anhand von code.

Feldbezogene Codes

Werden von der Prüfung der Anfrage ausgegeben. Jeder Code unten setzt field auf den Namen des beanstandeten Feldes in snake_case. Schlagen mehrere Felder gleichzeitig fehl, ist der code auf oberster Ebene validation_failed, und jeder einzelne Feldfehler landet in errors[].

Code	Wann	Was zu tun ist
validation_failed	Der code auf oberster Ebene, wenn mehrere Felder gleichzeitig fehlschlagen. Jeder einzelne Feldfehler trägt seinen eigenen code und field in errors[].	Sehen Sie errors[] durch und beheben Sie jedes aufgeführte field.
field_required	Ein erforderliches Feld ist leer, null oder enthält nur Leerzeichen.	Geben Sie einen Wert für field an.
field_too_long	Das Feld überschreitet die zulässige Höchstlänge.	Kürzen Sie auf die für diesen Endpunkt dokumentierte Grenze.
field_out_of_range	Ein numerischer Wert liegt außerhalb des zulässigen Bereichs.	Begrenzen Sie den Wert auf den dokumentierten Bereich.
field_invalid_enum	Der Wert gehört nicht zu den zulässigen Enum-Werten (etwa unbekannte currency oder network, oder ein Token, das im Projekt nicht aktiviert ist).	Prüfen Sie die Enum-Referenz; bei Token stellen Sie sicher, dass das Projekt die Kombination aus Token und Netzwerk aktiviert hat.
field_invalid_format	Der Wert entspricht nicht der erwarteten Form — eine nicht lesbare ID (etwa invoice_id ohne das Präfix inv_…) oder ein amount, der keine schlichte Dezimalzeichenkette wie "10.00" ist.	Senden Sie das Feld im dokumentierten Format; übernehmen Sie von der API zurückgegebene IDs unverändert.
entity_id_empty	Eine übergebene ID ist eine reine Null- oder leere GUID (00000000-0000-…). field nennt die beanstandete ID — etwa invoice_id oder withdrawal_id.	Senden Sie die von der API zurückgegebene ID unverändert; nie eine genullte oder leere ID.
field_must_be_positive	Dezimal- oder Ganzzahlwert muss größer als 0 sein.	Senden Sie einen positiven Wert.
field_percentage_out_of_range	Der Prozentwert muss zwischen 0 und 100 liegen, jeweils einschließlich.	Begrenzen Sie den Wert auf [0, 100].
query_parameter_unknown	Eine Listenanfrage enthält einen Query-Parameter, den der Endpunkt nicht unterstützt.	Entfernen Sie den Parameter oder nutzen Sie seinen dokumentierten Namen in snake_case.
pagination_cursor_invalid	Ein Cursor ist fehlerhaft, abgelaufen, manipuliert, gehört zu einer anderen Ressource oder wird mit anderen Filtern kombiniert.	Beginnen Sie die Navigation ohne cursor neu und halten Sie die Filter unverändert, während Sie next_cursor folgen.
amount_too_many_decimals	Bei Rechnungen im Fiat-Weg hat amount mehr Nachkommastellen als die Untereinheit der Währung (etwa 23.345 für USD, 23.01 für JPY).	Runden Sie auf die Untereinheit der Währung.
amount_too_large	Der amount beim Anlegen einer Rechnung oder Auszahlung liegt außerhalb des unterstützten Bereichs — oberhalb der Obergrenze von 20 Vorkommastellen, die die API speichert.	Senden Sie einen Betrag innerhalb des unterstützten Bereichs.

Allgemeine Rückfälle je HTTP-Status

Werden zurückgegeben, wenn dem Fehlschlag kein spezifischer fachlicher Code anhängt. Jeder dieser Codes ist ein Rückfall für einen HTTP-Status: Die Anfrage ist gescheitert, aber kein feinerer Code beschrieb die Ursache.

Code	HTTP	Wann	Was zu tun ist
forbidden	403	Authentifiziert, aber dieser Zugang darf die Operation nicht ausführen — sein Geltungsbereich (die Fähigkeit) oder seine Umgebung erlauben es nicht, etwa ein Sandbox-Schlüssel an einem Endpunkt, den es nur in der Produktion gibt.	Rufen Sie mit einem Zugang auf, dessen Fähigkeit und Umgebung zur Operation passen. Eigentum führt nie zu 403: Eine Ressource, die einem anderen Händler gehört, liefert not_found (404), nicht forbidden.
payment_key_required	403	Der Endpunkt braucht einen Payment-Schlüssel (pk_), die Anfrage nutzte aber einen Payout-Schlüssel (rk_) — etwa beim Auflisten von Rechnungen.	Rufen Sie ihn mit einem Payment-Schlüssel auf.
payout_key_required	403	Der Endpunkt braucht einen Payout-Schlüssel (rk_), die Anfrage nutzte aber einen Payment-Schlüssel (pk_) — etwa beim Lesen von Guthaben.	Rufen Sie ihn mit einem Payout-Schlüssel auf. Beachten Sie, dass der Payout-Schlüssel zusätzlich eine IP-Freigabeliste braucht, bevor er funktioniert.
internal_error	500	Ein unerwarteter Fehler auf unserer Seite.	Wiederholen Sie einmal. Scheitert es weiterhin, wenden Sie sich an den Support und nennen Sie den Zeitpunkt der Antwort.
validation_failed	400	Die Anfrage hat die Prüfung nicht bestanden, aber kein einzelner feldbezogener Code traf zu.	Lesen Sie das Feld detail — dort steht, was abgewiesen wurde.

Authentifizierung

Werden ausschließlich bei 401 Unauthorized vom HMAC-Authentifizierungshandler zurückgegeben. Jeder Code benennt eine konkrete Fehlerstelle, sodass Clients eine hilfreiche Meldung zeigen können statt eines pauschalen „Authentifizierung fehlgeschlagen“.

Code	HTTP	Wann	Was zu tun ist
unauthorized	401	Allgemeiner Rückfall, wenn keiner der spezifischen Codes unten zutraf — typischerweise eine Anfrage an einen authentifizierungspflichtigen Endpunkt ohne Authorization-Header (oder mit einem unbekannten Auth-Schema).	Senden Sie einen gültigen HMAC-Authorization-Header; prüfen Sie den Signaturablauf von Anfang bis Ende.
authorization_missing	401	Der Wert des Authorization-Headers ist leer (gesendet, aber ohne Inhalt).	Senden Sie den vollständigen Header Authorization: HMAC-SHA256 {apiKeyId}:{base64signature}.
authorization_malformed	401	Der Header ist vorhanden, aber fehlerhaft: Das Schema lässt sich lesen, doch im Zugangsdatenteil fehlt der Doppelpunkt, die Schlüssel-ID ist nicht lesbar, oder die Signatur ist leer.	Bauen Sie den Header nach Authentifizierung neu auf; ein Tippfehler in der Schlüssel-ID ist die häufigste Ursache.
timestamp_missing	401	Der Header X-Request-Timestamp fehlt oder lässt sich nicht als positive Ganzzahl lesen.	Setzen Sie den Header auf den aktuellen Unix-Zeitstempel in Sekunden.
timestamp_expired	401	Der Zeitstempel liegt außerhalb des erlaubten Fensters für Uhrabweichung (standardmäßig 5 Minuten).	Gleichen Sie Ihre Uhr per NTP ab; signieren Sie mit frischem Zeitstempel neu.
invalid_credentials	401	Der Zugang ist unbrauchbar: unbekannte Schlüssel-ID, widerrufener Schlüssel, ein Präfix für Umgebung oder Art, das nicht zum gespeicherten Schlüssel passt, oder eine Signatur, die nicht verifiziert. Bewusst ein Code für alle vier — eine unterscheidbare Antwort würde einem Aufrufer ohne Geheimnis bestätigen, welche Schlüssel-IDs existieren.	Prüfen Sie, ob die Schlüssel-ID richtig und aktiv ist und die Signatur mit dem passenden Geheimnis gebildet wurde. Die häufigste Ursache ist die Signatur: Prüfen Sie den Aufbau Ihres string-to-sign ({ts}\n{METHOD}\n{path}\n{query}\n{bodyHash}) und dass bodyHash bei leerem Körper leer ist (hashen Sie keine leere Zeichenkette).
ip_not_allowed	401	Für den Payout-Schlüssel ist eine IP-Freigabeliste eingerichtet, und Ihre aufrufende IP steht nicht darin. Nur Payout-Schlüssel tragen eine IP-Prüfung — Payment-Schlüssel sind von jeder IP aus aufrufbar. Die Prüfung erfolgt nach erfolgreicher Signatur, sodass auch eine gültige Signatur aus dem falschen Netz scheitert.	Tragen Sie die aufrufende IP (oder ihren CIDR-Block) im Dashboard in die Freigabeliste des Payout-Schlüssels ein.
payout_whitelist_required	401	Für einen frisch erzeugten Payout-Schlüssel ist noch keine IP-Freigabeliste eingerichtet. Payout-Schlüssel bleiben inaktiv, bis der Händler mindestens eine erlaubte IP hinterlegt — getrennt von ip_not_allowed, damit Clients „Konfiguration im Dashboard fehlt“ von „falsche Quell-IP“ unterscheiden können.	Öffnen Sie das Dashboard, gehen Sie zur Seite der API-Schlüssel und hinterlegen Sie mindestens eine IP oder einen CIDR-Block in der Freigabeliste des Payout-Schlüssels.

Anfragegrenze

Werden bei 429 Too Many Requests zurückgegeben, wenn eine Anfrage die Grenze je Händler überschreitet. Gezählt wird im Ein-Sekunden-Fenster, und zwar über alle Ihre API-Schlüssel hinweg: ein eigenes Kontingent je Schlüssel gibt es nicht. Vor der API greift eine weitere Grenze je IP-Adresse — beschrieben ist hier die Grenze je Händler.

Code	HTTP	Wann	Was zu tun ist
rate_limited	429	Die Anfragegrenze je Händler wurde überschritten. Es gelten zwei Grenzen: eine allgemeine Obergrenze für alle Endpunkte (standardmäßig 30 Anfragen/Sekunde) und eine strengere für die Rechnungserstellung — POST /v1/invoices (standardmäßig 5 Anfragen/Sekunde). Die Antwort nennt, welche ausgelöst hat und bei welchem Wert.	Lesen Sie den Header Retry-After (die Wartezeit in Sekunden) und wiederholen Sie danach; die meisten HTTP-Clients mit Wiederholungslogik beachten ihn automatisch.

Transport und Framework

Werden vom Fehlerhandler des Frameworks zurückgegeben, wenn die Anfrage nie einen regulären Handler erreicht hat.

Code	HTTP	Wann	Was zu tun ist
malformed_request	400	Der Anfragekörper ließ sich nicht lesen — fehlerhaftes JSON.	Prüfen Sie, ob der Körper gültiges JSON ist.
payload_too_large	413	Der Anfragekörper überschreitet die Grenze von 1 MiB.	Senden Sie einen kleineren Inhalt; verteilen Sie große Vorgänge auf mehrere Anfragen.
unsupported_media_type	415	Content-Type ist nicht application/json.	Setzen Sie Content-Type: application/json.
method_not_allowed	405	Der Pfad existiert, aber nicht für diese HTTP-Methode.	Nutzen Sie die für den Endpunkt dokumentierte Methode (etwa POST zum Erstellen).
route_not_found	404	Kein Endpunkt passt zum Pfad der Anfrage.	Prüfen Sie die URL erneut gegen die API-Referenz.

Rechnungen

Code	HTTP	Wann	Was zu tun ist
invoice_not_found	404	Die Rechnungskennung führt zu nichts oder zu einer Rechnung, die einem anderen Händler gehört.	Übernehmen Sie die von POST /v1/invoices zurückgegebene Kennung unverändert.
project_not_found	404	Die project_id einer Anfrage zur Rechnungserstellung führt zu nichts, was für den Aufrufer sichtbar wäre.	Nutzen Sie eine Projektkennung aus dem Dashboard (das Projekt muss aktiv sein und demselben Händler gehören wie der API-Schlüssel).
invoice_terminal	410	Die Zahlungsbestätigung wurde auf einer Rechnung im Zustand expired oder cancelled aufgerufen. (Eine Rechnung im Zustand paid liefert invoice_not_awaiting_client mit 409, nicht diesen Code.)	Aktualisieren Sie den Rechnungsstatus; mehr ist nicht zu tun.
invoice_deadline_passed	410	Die Zahlungsbestätigung wurde nach der Frist der Rechnung aufgerufen.	Erstellen Sie eine neue Rechnung.
requested_amount_invalid	400	Der amount der Rechnung fehlt, ist fehlerhaft, liegt außerhalb des unterstützten Dezimalbereichs oder ist nicht positiv.	Senden Sie amount als positive Dezimalzeichenkette zusammen mit der gewählten currency und optional network.
invoice_amount_below_minimum	400	Der errechnete USD-Wert der Rechnung liegt unter dem Mindestwert je Token und Netzwerk aus dem Katalog.	Erhöhen Sie den Betrag über den für das gewählte Token angezeigten Mindestwert.
deposit_amount_exceeds_limit	400	Der errechnete USD-Wert der erwarteten Zahlung überschreitet die Obergrenze MaxDepositAmount des Händlers je Einzahlung. Begrenzt wird der angebotene Rechnungsbetrag bei der Bestätigung, nicht der tatsächliche Eingang on-chain.	Verringern Sie den Rechnungsbetrag oder wenden Sie sich an den Support, um die Grenze anzuheben.
currency_not_enabled_for_project	400	Die angefragte Krypto-Währung steht nicht in der Liste der aktivierten Token des Projekts (in keinem Netzwerk).	Aktivieren Sie die Währung im Projekt oder wählen Sie eine aus den enabled_tokens des Projekts.
tokens_required	409	Rechnungserstellung oder Zahlungsbestätigung in einem Projekt, das überhaupt keine aktivierten Token hat.	Aktivieren Sie im Dashboard mindestens ein Token im Projekt.
acceptance_disabled	503	Das angefragte Token wird derzeit nicht angenommen.	Nutzen Sie ein anderes Token oder versuchen Sie es später erneut.
exchange_rate_unavailable	503	Der Kursanbieter hat keinen frischen Kurs für das Paar aus Token und Fiat.	Wiederholen Sie; Kurse werden in kurzen Abständen erneuert.
network_unavailable	503	Die automatische Bestätigung konnte das gewählte Netzwerk nicht nutzen.	Verzichten Sie auf die automatische Bestätigung; lassen Sie den Kunden das Token auf der gehosteten Seite wählen.
payment_method_unavailable	503	Das gewählte Token bzw. Netzwerk kann derzeit keine Zahlung annehmen. Ersetzt seit dem 23.08.2026 no_available_address, address_lease_failed und bridge_unavailable.	Wiederholen Sie, oder lassen Sie den Kunden ein anderes Token oder Netzwerk wählen.
client_confirmation_failed	409	Die Bestätigung auf Kundenseite (Token-Auswahl, automatische Bestätigung) wurde abgewiesen. Der genaue Grund steht im Feld detail.	Prüfen Sie detail; häufige Fälle: Die Rechnung ist bereits über awaiting_client hinaus, oder das Token ist nicht erlaubt.
invoice_not_awaiting_client	409	Die Zahlungsbestätigung wurde auf einer Rechnung aufgerufen, die nicht mehr in awaiting_client steht.	Aktualisieren Sie den Rechnungsstatus; der Kunde hat die Auswahl bereits hinter sich.
invoice_cannot_be_cancelled	409	Die Rechnung steht nicht mehr in awaiting_client — der Kunde hat bereits ein Token gewählt, oder sie ist schon bezahlt oder abgelaufen. Eine bereits stornierte Rechnung erneut zu stornieren liefert 200, nicht diesen Fehler.	Prüfen Sie den aktuellen Status; eine Stornierung funktioniert nur in awaiting_client.
simulate_payment_failed	409	Das nur in der Sandbox verfügbare simulate_payment wurde abgewiesen.	Prüfen Sie detail; meist stimmt der Status oder der Betrag nicht.
not_sandbox	403	simulate-payment (der Sandbox-Simulator) wurde auf einer Produktionsrechnung aufgerufen.	Simulieren lassen sich nur Sandbox-Rechnungen — nutzen Sie eine Sandbox-Rechnung oder treiben Sie eine Live-Rechnung mit einer echten On-Chain-Zahlung an.

Widget-Rechnungen

Werden von POST /public/v1/sdk zurückgegeben (Rechnungserstellung über das Low-Code SDK).

Code	HTTP	Wann	Was zu tun ist
widget_key_missing	401	Der Header X-Sdk-Key fehlt oder ist leer an einem Endpunkt, der Widget-Authentifizierung verlangt.	Senden Sie den öffentlichen SDK-Schlüssel in X-Sdk-Key.
widget_key_invalid	401	X-Sdk-Key ist vorhanden, lässt sich aber nicht als Paymos-Schlüssel-ID lesen.	Kopieren Sie den Schlüssel aus dem Dashboard; achten Sie auf überflüssige Leerzeichen, ein falsches Präfix oder versehentliche URL-Kodierung.
widget_key_not_found	401	Der Schlüssel lässt sich lesen, führt aber zu keinem aktiven Zugang — widerrufen, gelöscht oder kein Schlüssel vom Typ Payment (Payout-Schlüssel können das Widget nicht betreiben).	Nutzen Sie einen aktiven Payment-Schlüssel aus dem Dashboard.
widget_inactive	403	Das Widget des Zielprojekts ist ausgeschaltet oder wurde nie eingerichtet.	Aktivieren Sie das Widget in den Projekteinstellungen.
terminal_not_enabled	403	Die Anfrage kam mit source=terminal, aber die Integrationsmethode des Projekts ist nicht Terminal.	Legen Sie ein Terminal-Projekt an oder senden Sie source=embed aus einem Low-Code-Projekt.
embed_not_enabled	403	Die Anfrage kam mit source=embed, aber die Integrationsmethode des Projekts ist nicht Low-Code.	Nutzen Sie die Integrationsmethode des Projekts oder legen Sie ein Low-Code-Projekt an.
origin_not_allowed	401	Die Origin des Browsers passt zu keiner erlaubten Herkunft. Die Prüfung läuft zweimal — die Auth-Schicht prüft die Herkunft gegen die Vereinigung aller Projekte mit aktivem Widget an diesem Schlüssel, danach prüft der Handler sie gegen das genaue Zielprojekt —, und beide antworten mit derselben 401, demselben Code und demselben Detail. Das ist Absicht: Ein anderer Status aus der zweiten Prüfung würde einem Aufrufer, der den (öffentlichen, auslesbaren) pk_-Schlüssel hält, verraten, dass die Herkunft an einem anderen Projekt desselben Händlers eingetragen ist — Staging-Hosts und unveröffentlichte Marken ließen sich so Anfrage für Anfrage aufzählen.	Tragen Sie die Domain in die erlaubten Herkünfte des Widgets ein. Anfragen von derselben Herkunft — etwa ein POS-Terminal, das vom selben Host ausgeliefert wird — überspringen die Prüfung.

Zahlungskanäle

Code	HTTP	Wann	Was zu tun ist
payment_channels_disabled	503	Zahlungskanäle sind für Ihr Konto in dieser Umgebung nicht freigeschaltet. So antwortet jede Route zu Kanälen und Einzahlungen, auch der Simulator der Sandbox.	Wenden Sie sich an den Support, um freigeschaltet zu werden. Eine Wiederholung ändert die Antwort nicht.
payment_channel_not_found	404	Die pc_-Kennung führt zu nichts, was diese Zugangsdaten sehen dürfen — es gibt sie nicht, sie gehört einem anderen Händler, sie liegt in der anderen Umgebung, oder sie sitzt in einem Projekt außerhalb des Geltungsbereichs des Schlüssels. Alle vier Fälle sind bewusst nicht zu unterscheiden.	Übernehmen Sie die von POST /v1/payment-channels zurückgegebene Kennung unverändert und signieren Sie mit einem Schlüssel derselben Umgebung und desselben Projekts.
payment_channel_deposit_not_found	404	Die pcd_-Kennung führt zu nichts, was diese Zugangsdaten sehen dürfen. Dieselben vier Ursachen wie oben.	Übernehmen Sie die Kennung aus dem Inhalt des Webhooks oder aus dem Feed unverändert.
payment_channel_external_id_invalid	400	external_id ist leer, besteht nur aus Leerzeichen oder ist länger als 128 Zeichen — beim Anlegen ebenso wie als Filter einer Liste.	Senden Sie eine nicht leere Kennung mit höchstens 128 Zeichen.
payment_channel_project_has_no_supported_tokens	409	Das Projekt aktiviert kein Token, das ein Zahlungskanal einsammeln könnte; der Kanal hätte damit überhaupt keinen Weg.	Aktivieren Sie im Projekt mindestens ein unterstütztes Token und legen Sie den Kanal dann an.
payment_channel_simulation_sandbox_only	403	simulate-deposit wurde auf einem Produktionskanal aufgerufen.	Die Simulation gibt es nur für Kanäle in der Sandbox. Einen Produktionskanal treiben Sie mit einem echten Transfer an.
payment_key_required	403	Die Anfrage wurde mit einem Payout-Schlüssel (rk_) signiert. Der Zugriff auf Kanäle läuft über den Payment-Schlüssel, genau wie Auszahlungen über den Payout-Schlüssel laufen.	Signieren Sie mit einem pk_-Schlüssel derselben Umgebung.
pagination_cursor_invalid	400	Ein Cursor einer Liste oder des Feeds ist fehlerhaft, älter als 24 Stunden oder an andere Filter gebunden — beim Feed zusätzlich an einen anderen Händler, eine andere Umgebung oder einen anderen Projektumfang.	Beginnen Sie bei der ersten Seite. Die Deduplizierung über pcd_ macht eine vollständige Neusynchronisierung harmlos.
currency_not_enabled_for_project	400	Das an simulate-deposit übergebene Token steht nicht in der Liste der aktivierten Token des Projekts.	Aktivieren Sie es im Projekt oder wählen Sie eines, das der Kanal in seinen networks[].tokens bereits zurückgibt.
acceptance_disabled	503	Die Annahme des angefragten Tokens ist derzeit plattformweit deaktiviert.	Nutzen Sie ein anderes Token oder warten Sie, bis die Annahme wieder aktiviert ist.
amount_too_many_decimals	400	Der simulierte Betrag hat mehr Nachkommastellen, als das Token unterstützt. Geld eines Händlers wird nie still auf eine andere Zahl gerundet.	Runden Sie den Betrag vor dem Senden auf die Genauigkeit des Tokens.

Auszahlungen

Code	HTTP	Wann	Was zu tun ist
withdrawal_not_found	404	Die Auszahlungskennung führt zu nichts oder zu einer Auszahlung, die einem anderen Händler gehört.	Übernehmen Sie die von POST /v1/withdrawals zurückgegebene Kennung unverändert.
insufficient_balance	409	Das verfügbare Guthaben des Händlers liegt unter amount + fee.	Laden Sie auf oder verringern Sie den Auszahlungsbetrag.
whitelist_required	403	Die Zieladresse steht für das gewählte Netzwerk nicht auf der Freigabeliste. (Das Netzwerk unterstützt Freigabelisten; diese konkrete Adresse wurde noch nicht eingetragen.)	Tragen Sie die Adresse in Ihre Freigabeliste ein und versuchen Sie es erneut.
destination_address_invalid	400	Die Adresse besteht die Format- oder Prüfsummenkontrolle des Netzwerks nicht.	Gleichen Sie die Adresse erneut mit der Spezifikation des Netzwerks ab.
withdrawal_amount_below_minimum	400	Der Betrag liegt unter dem für das gewählte Token festgelegten Mindestbetrag.	Erhöhen Sie den Betrag über den Mindestbetrag (er steht in detail).
withdrawal_quota_exceeded	409	Die Zahl der laufenden Auszahlungen hat die Grenze des Händlers erreicht.	Warten Sie, bis laufende Auszahlungen abgeschlossen sind, oder wenden Sie sich an den Support, um die Grenze anzuheben.
withdrawal_amount_exceeds_limit	400	Der USD-Gegenwert des Auszahlungsbetrags überschreitet die Obergrenze MaxWithdrawalAmount des Händlers je Transaktion.	Verringern Sie den Betrag oder wenden Sie sich an den Support, um die Grenze anzuheben.
exchange_rate_unavailable	503	Für den Händler ist eine Obergrenze MaxWithdrawalAmount gesetzt, aber es lag kein frischer Kurs von Token zu USD vor, um den Betrag dagegen zu prüfen — die Grenze lässt sich nicht verifizieren, deshalb scheitert die Anfrage im Zweifel.	Wiederholen Sie; Kurse werden in kurzen Abständen erneuert.
withdrawal_not_enabled	400	Paymos zahlt das angefragte Paar aus Token und Netzwerk nicht aus. detail nennt das Paar — etwa Withdrawals are not available for USDT on TRC20. Welche Paare auszahlbar sind, entscheidet unsere Konfiguration, nicht Ihre.	Zahlen Sie das Token in einem Netzwerk aus, das Paymos bedient, oder fragen Sie den Support nach dem benötigten Paar.
withdrawal_cannot_be_cancelled	409	Die Auszahlung ist über den Zustand hinaus, in dem sie storniert werden kann.	Prüfen Sie den aktuellen Status. Das Fenster schließt sich mit dem Beginn der Ausführung — noch innerhalb von created, bevor irgendetwas signiert wurde.
withdrawal_simulation_failed	409	Das nur in der Sandbox verfügbare simulate_completion wurde abgewiesen.	Prüfen Sie detail.
merchant_suspended	403	Das Händlerkonto ist für ausgehende Vorgänge ausgesetzt, deshalb lässt sich keine Auszahlung anlegen.	Wenden Sie sich an den Support, um die Aussetzung aufzuheben.
outbound_frozen	503	Ausgehende Transfers sind eingefroren — entweder plattformweit oder für das Netzwerk und Token, in dem Sie auszahlen.	Warten Sie, bis die Sperre aufgehoben ist, versuchen Sie ein anderes Netzwerk oder Token, oder wenden Sie sich an den Support.
withdrawal_network_unavailable	503	Auszahlungen dieses Tokens in diesem Netzwerk lassen sich derzeit nicht abwickeln.	Versuchen Sie ein anderes Zielnetzwerk oder später erneut.

Projektzustand

Werden bei der Rechnungserstellung und der Zahlungsbestätigung zurückgegeben, wenn das Projekt in seinem aktuellen Zustand keine Rechnungen ausstellen kann.

Code	HTTP	Wann	Was zu tun ist
project_state_invalid	409	Das Projekt ist nicht Active — es ist Suspended oder Archived. Die Antwort sagt nicht, welches von beidem.	Prüfen Sie den Status des Projekts im Dashboard: stellen Sie es wieder her, wenn es archiviert ist, oder aktivieren Sie es, wenn es ausgesetzt ist. Oder senden Sie die Anfrage an ein Projekt, das bereits aktiv ist.