DocsIntegration testen
Testumgebung einrichten und Testzugangsdaten verwenden
Bevor Sie live gehen, verwenden Sie eine Cost+ Sandbox-Website, um zu überprüfen, ob Ihre Integration korrekt funktioniert. Es gibt keine separate Sandbox-URL — Sie verwenden denselben Produktions-API-Endpunkt (https://api.costplus.online/v1) mit einem API-Schlüssel einer Sandbox-Website.
Ihren Test-API-Schlüssel erhalten
- Melden Sie sich im Händlerportal an
- Navigieren Sie zu Websites
- Erstellen Sie eine neue Website und wählen Sie Sandbox als Typ, oder wählen Sie eine bestehende Sandbox-Website
- Klicken Sie auf Integration, um Ihren API-Schlüssel zu finden
- Verwenden Sie diesen API-Schlüssel in Ihrer Integration — alle Transaktionen werden simuliert
Ob Sandbox- oder Produktionsmodus verwendet wird, hängt ausschließlich vom Website-Typ im Händlerportal ab, nicht von der API-URL. Ein API-Schlüssel einer Sandbox-Website verarbeitet simulierte Transaktionen; ein API-Schlüssel einer Produktions-Website verarbeitet echte Zahlungen. Beide verwenden denselben API-Endpunkt.
Testkartennummern
Verwenden Sie die folgenden Kartennummern, um verschiedene Zahlungsszenarien zu simulieren. Verwenden Sie keine echten Kartennummern im Testmodus.
| Kartennummer | CVV | Marke | Ergebnis |
|---|---|---|---|
4111111111111111 | beliebig | Visa | Erfolg |
5544330000000037 | beliebig | Mastercard | Erfolg |
4462030000000000 | beliebig | Visa | Erfolg |
4111111111111105 | beliebig | Visa | Do Not Honor |
4111111111111143 | beliebig | Visa | Stolen Card |
4111111111111151 | beliebig | Visa | Insufficient Funds |
Verwenden Sie ein beliebiges zukünftiges Ablaufdatum und eine beliebige 3-stellige CVC.
Testkartennummern funktionieren nur im Sandbox-Modus. Die Übermittlung an einen Produktions-Website-API-Schlüssel führt zu einer abgelehnten Transaktion.
Fehlercodes
Wenn eine Transaktion fehlschlägt, gibt die API einen der folgenden Fehlercodes im reason-Feld der Transaktion zurück:
| Fehlercode | Beschreibung |
|---|---|
ERROR_CARD_AUTHENTICATION_FAILURE | 3DS-Authentifizierung nicht rechtzeitig abgeschlossen; Zahlung storniert |
ERROR_CARD_CVV_NOT_VALID | CVV korrekt formatiert, aber ungültig |
ERROR_CARD_INFORMATION_NOT_VALID | Karteninformationen korrekt formatiert, aber ungültig |
ERROR_CARD_NOT_SUPPORTED_FOR_ECOMMERCE | Transaktion wird für E-Commerce nicht unterstützt |
ERROR_CARD_NOT_VALID | Karten-ID ist ungültig |
ERROR_CARD_TYPE_DISABLED | Kartentyp ist deaktiviert |
ERROR_TRANSACTION_FAILED | Kartentransaktion fehlgeschlagen |
ERROR_TRANSACTION_REJECTED_BY_CARD_PROCESSOR | Vom Prozessor abgelehnt (enthält Visa/MC-Branchennummerncode) |
ERROR_TRANSACTION_TYPE_NOT_ALLOWED_BY_SELLER | Transaktionstyp vom Händler nicht erlaubt |
ERROR_TRANSACTION_TYPE_NOT_SUPPORTED | Vom Kartennetzwerk nicht unterstützt |
INVALID_CARD_CVV | CVV nicht erkannt |
INVALID_CARD_NUMBER | Kartennummer nicht erkannt |
Häufige API-Validierungsfehler
Diese Fehler werden als 400 Bad Request zurückgegeben, wenn die API-Anfrage selbst ungültig ist:
| Fehler | Beschreibung |
|---|---|
| Unknown payment method | Sie haben einen falschen Zahlungsmethodennamen angegeben |
| No permissions for payment method | Ihr API-Schlüssel (Projekt) hat keine Berechtigungen für die angegebene Zahlungsmethode |
| Payment method not enabled | Die Zahlungsmethode wurde für Ihren API-Schlüssel (Projekt) nicht aktiviert |
| Payment method not supported | Ihr API-Schlüssel (Projekt) hat nicht den korrekten Status, um die angegebene Zahlungsmethode zu verwenden |
Wenn Sie „Payment method not enabled" oder „No permissions" erhalten, überprüfen Sie die Zahlungsmethoden-Konfiguration im Händlerportal unter Ihren Website-Einstellungen.