Jeder API-Fehler kommt mit einem kurzen Code und einer verständlichen Meldung. Das sind die, auf die Händler am häufigsten stoßen.
Zugangsdaten und Zugriff
- unauthenticated / invalid_credentials: Projektschlüssel oder Secret fehlt oder ist falsch. Achte auf Leerzeichen und darauf, dass das Secret zu diesem Projekt gehört.
- project_inactive: Du hast das Live-Secret benutzt, bevor das Projekt freigegeben war. Nutze bis dahin das Test-Secret, siehe Projektprüfung: was wir prüfen.
- project_disabled: Das Projekt ist gesperrt oder wurde nicht freigegeben.
- ip_not_allowed: Der Aufruf kam von einer Adresse, die nicht auf der API-IP-Allowlist des Projekts steht.
Deine Anfrage
- invalid_request: Ein Feld fehlt oder hat das falsche Format. Die Meldung nennt das Feld.
- duplicate_order_id: In diesem Modus gibt es bereits eine Zahlung mit dieser Order-ID. Nimm eine neue oder schlag die bestehende Zahlung nach.
- insufficient_funds: Das Guthaben reicht nicht für einen Skin-Kauf. Die Meldung sagt, wie viel nötig ist.
Rate-Limits
Ein Projekt darf bis zu 600 Aufrufe pro Minute machen. Darüber bekommst du rate_limited mit einem Hinweis, wann du es wieder versuchen kannst. Warte, statt in einer engen Schleife erneut zu senden.
Wenn der Markt ausgelastet ist
Antwortet das Zahlungsnetzwerk nicht, bekommst du eine Meldung, es in einer Minute erneut zu versuchen. Order-IDs und Custom-IDs sind pro Projekt eindeutig, daher kann ein erneuter Versuch nie eine zweite Zahlung oder einen zweiten Kauf erzeugen. Ein wiederholter Kaufaufruf mit derselben Custom-ID liefert den bestehenden Kauf zurück.
Die vollständige Liste der Fehler, Felder und Beispiele steht in der API-Referenz.