Kartentyp erkennen
Ein Werkzeug, das anhand der ersten Ziffern einer Kartennummer den Kartentyp erkennt, etwa Visa, Mastercard oder American Express. Gedacht für Zahlungsformulare, die schon während der Eingabe das passende Kartensymbol anzeigen möchten, ohne die vollständige Nummer dafür zu speichern oder zu übertragen.
Im Browser ausführen – kostenlos
Läuft direkt in Ihrem Browser – kostenlos. Ihre Datei verlässt Ihren Browser nicht und wird an keinen Server übertragen.
Wie sich der Kartentyp erkennen lässt
Jeder Kartenaussteller verwendet feste Ziffernbereiche am Anfang der Nummer, etwa beginnt Visa üblicherweise mit einer 4, Mastercard mit bestimmten Bereichen ab 51 bis 55 oder 2221 bis 2720, und American Express mit 34 oder 37. Aus diesen ersten Ziffern leitet die Funktion den wahrscheinlichen Kartentyp ab, ohne die vollständige Nummer für die Erkennung zu benötigen, was die Prüfung besonders schonend im Umgang mit sensiblen Daten macht.
Wofür sich das eignet
Ein Zahlungsformular, das während der Eingabe bereits das passende Kartensymbol zeigt, wirkt aufgeräumter und gibt sofortiges Feedback, wenn eine akzeptierte Kartenart erkannt wurde. Auch für die interne Auswertung, welche Kartentypen bei Ihren Kunden überwiegen, können Sie die Erkennung nutzen, ohne vollständige Kartennummern dauerhaft zu speichern oder in einer eigenen Datenbank vorhalten zu müssen, was zusätzlichen Aufwand beim Datenschutz spart.
Kostenlos, ohne Speicherung
Die Erkennung läuft vollständig im Browser: Die eingegebene Nummer wird lokal ausgewertet, nicht gespeichert und nicht an einen Server übertragen. Für die automatisierte Einbindung in ein eigenes Zahlungsformular steht dieselbe Funktion auch per API zur Verfügung, für $0.002 pro Prüfung, ebenfalls ohne Speicherung der Nummer, mit dem Preis vorab veröffentlicht wie bei jeder Funktion in KIT, ohne Mindestumsatz und ohne Abonnement.
Anwendungsfälle
Kartensymbol während der Eingabe anzeigen
Ein Onlineshop zeigt im Zahlungsformular automatisch das passende Kartenlogo an, sobald die eingegebenen Ziffern einen bekannten Kartentyp erkennen lassen.
Akzeptierte Kartentypen früh prüfen
Jonas Weber weist Kunden bereits während der Eingabe darauf hin, wenn eine erkannte Kartenart in seinem Shop nicht akzeptiert wird, statt erst nach dem Absenden.
Auswertung der Zahlungsarten
Ein Händler lässt auswerten, welcher Anteil der Bestellungen mit Visa, Mastercard oder American Express bezahlt wird, um Gebührenmodelle zu vergleichen.
Häufige Fragen
Wird die vollständige Kartennummer gespeichert?
Nein, weder im Browser-Modus noch bei Nutzung über die API. Die Nummer wird nur zur Erkennung des Kartentyps ausgewertet.
Welche Kartentypen werden erkannt?
Die gängigen internationalen Kartentypen wie Visa, Mastercard und American Express sowie weitere anhand ihrer bekannten Ziffernbereiche.
Ist die Prüfung kostenlos?
Ja, im Browser ohne Limit und ohne Anmeldung. Nur die API-Nutzung kostet $0.002 pro Prüfung.
Prüft das auch, ob die Nummer gültig ist?
Nein, dafür gibt es eine eigene Funktion mit dem Luhn-Algorithmus. Diese Funktion erkennt ausschließlich den Kartentyp.
Reichen die ersten Ziffern für eine sichere Erkennung?
In den meisten Fällen ja, da die Aussteller feste Ziffernbereiche verwenden. Bei sehr neuen oder seltenen Kartenprogrammen kann die Zuordnung im Einzelfall abweichen.
Brauche ich ein Konto?
Nein, weder für den Browser-Modus noch für die API-Nutzung ist ein Konto erforderlich.
Für Entwickler — API-Zugang
Alles auf dieser Seite ist auch per API verfügbar. Dieser Abschnitt richtet sich an Teams, die es in ihre eigenen Systeme einbinden möchten; alle anderen nutzen einfach das Tool oben.
Endpunkt
Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.
Aufruf aus Ihrem Stack
curl -X POST https://api.kit.forhosting.com/verify/card-type \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"items":["valor-1","valor-2"]}'const res = await fetch("https://api.kit.forhosting.com/verify/card-type", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"items": [
"valor-1",
"valor-2"
]
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/verify/card-type",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"items": [
"valor-1",
"valor-2"
]
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/verify/card-type", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"items":["valor-1","valor-2"]}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"items":["valor-1","valor-2"]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/verify/card-type", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Beispiel-Anfrage
{
"items": [
"valor-1",
"valor-2"
]
}Beispiel-Antwort
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "verify.card_type",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}Die API arbeitet asynchron: Sie erhalten sofort eine task_id. Polling ist mit 1 Anfrage pro Sekunde erlaubt.
Preis
Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.
Fehler
| HTTP | Code | Bedeutung |
|---|---|---|
401 | unauthorized | Der API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer). |
402 | insufficient_balance | Ihr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht. |
404 | unknown_type | Unbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog. |
429 | rate_limited | Zu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt. |