DocsFAQ & Fehlerbehebung
Häufige Fragen und Tipps zur Fehlerbehebung
1. Ich erhalte einen „Unauthorized"-Fehler
Dies bedeutet in der Regel, dass Sie einen falschen oder falsch geschriebenen API-Schlüssel übermitteln. Überprüfen Sie, ob Ihr Schlüssel korrekt ist und im Authorization-Header richtig formatiert wurde.
Beispiel einer fehlgeschlagenen Authentifizierungsantwort:
{
"error": "werkzeug.exceptions.Unauthorized",
"message": "The server could not verify that you are authorized to access the URL requested."
}Stellen Sie sicher, dass Sie den abschließenden Doppelpunkt nach Ihrem API-Schlüssel bei der Verwendung von Basic Auth angeben (z. B. YOUR_API_KEY:). Der Doppelpunkt trennt den Benutzernamen vom leeren Passwort.
2. Ich erhalte einen „Unsupported payment method"-Fehler
Jede Zahlungsmethode muss in Ihrem Konto aktiviert sein, bevor sie verwendet werden kann. Wenn Sie versuchen, eine inaktive Methode zu verwenden, gibt die API einen 400 Bad Request zurück:
{
"error": "werkzeug.exceptions.BadRequest",
"message": "The requested payment method is not active for this merchant."
}Kontaktieren Sie Ihren Cost+ Account Manager oder aktivieren Sie die Zahlungsmethode im Admin-Portal unter Einstellungen > Zahlungsmethoden.
3. Welche Testkartennummern kann ich verwenden?
Siehe die Seite Integration testen für eine vollständige Liste der Testkartennummern, einschließlich Karten, die erfolgreiche und fehlgeschlagene Transaktionen simulieren.
4. Wie werden Webhook-Wiederholungsversuche behandelt?
Wenn Ihr Webhook-Endpunkt nicht mit einem 2xx-Statuscode antwortet, wiederholt Cost+ die Zustellung:
- Bis zu 10 Wiederholungsversuche im Abstand von 2 Minuten.
- Der erste Versuch hat ein Timeout von 4 Sekunden.
- Nachfolgende Versuche haben ein Timeout von 10 Sekunden.
Wenn alle 10 Wiederholungsversuche fehlschlagen, wird das Webhook-Ereignis als fehlgeschlagen markiert und nicht erneut versucht. Stellen Sie sicher, dass Ihr Endpunkt schnell antwortet und einen 200-Statuscode zurückgibt.
Vollständige Details zur Webhook-Konfiguration und zu Payload-Formaten finden Sie in der Anleitung zu Webhooks.