ForHosting KIT · Verifiche e controlli

Che carta è?

Questo strumento riconosce il circuito di una carta — Visa, Mastercard, American Express e altri — a partire dalle prime cifre del numero. Bastano sei o otto numeri, non serve la carta intera. Utile per mostrare il logo giusto in un modulo o capire con quale circuito stai lavorando.

● StabileGratis · nel tuo browser

Esegui gratis nel browser Vedi l'API

Usalo da WebAPIEmailApp prestoTelegram presto

Come si riconosce il circuito

Ogni circuito assegna ai propri numeri intervalli iniziali fissi: le carte Visa iniziano sempre con 4, Mastercard con intervalli intorno a 51-55 e 2221-2720, American Express con 34 o 37. Lo strumento confronta le prime cifre con questi intervalli pubblici e ti dice quale circuito corrisponde, oltre alla lunghezza attesa del numero completo per quel circuito, un dato utile per capire subito se il numero digitato è coerente.

Bastano poche cifre

Non serve digitare la carta intera: le prime sei o otto cifre bastano per riconoscere il circuito nella maggior parte dei casi. È comodo quando vuoi solo sapere se è una Visa o una Mastercard senza maneggiare il numero completo, per esempio per capire in anticipo se un cliente userà un circuito che la tua attività accetta davvero, senza dover chiedere il numero intero solo per saperlo.

Come si usa

Incolla le prime cifre del numero ed esegui. Il risultato mostra il circuito riconosciuto — Visa, Mastercard, American Express, e altri circuiti minori quando li copre — o ti avvisa se la sequenza non corrisponde a nessun intervallo noto. Nessun dato viene inviato a un server: tutto resta nella pagina, sul tuo dispositivo, dall’inserimento delle cifre fino al risultato mostrato a schermo.

Quando è utile saperlo subito

Un modulo d’ordine che mostra il logo del circuito mentre l’utente digita comunica professionalità e riduce gli errori di battitura. Un negozio che accetta solo alcuni circuiti può avvisare subito il cliente invece di farglielo scoprire al momento del pagamento rifiutato, un dettaglio piccolo che evita carrelli abbandonati per un motivo evitabile e riduce le richieste di assistenza dopo un pagamento respinto.

Casi d'uso

Logo dinamico nel modulo di pagamento

Nel checkout online di Tecnoedil Verona S.n.c. il logo del circuito compare mentre il cliente digita il numero, prima ancora di completare l’inserimento: un dettaglio che rassicura chi sta comprando.

Regole di accettazione per circuito

Un negozio che non accetta American Express per le commissioni più alte può avvisare subito il cliente appena riconosce il circuito, invece di farglielo scoprire dopo aver compilato tutto il modulo.

Assistenza clienti

Al telefono con un cliente che segnala un pagamento rifiutato, riconoscere il circuito dalle prime cifre che ti legge aiuta a capire subito se il problema è del circuito o del gestore di pagamento.

Domande frequenti

In cosa è diverso dal controllo Luhn?

Il controllo Luhn verifica se la sequenza di cifre è matematicamente coerente; questo strumento riconosce solo a quale circuito appartiene il numero. Sono due controlli distinti e complementari.

Quali circuiti riconosce?

I principali: Visa, Mastercard, American Express, e altri circuiti minori quando la sequenza rientra nei loro intervalli pubblici. Se un numero non corrisponde a nessuno, lo strumento te lo dice chiaramente.

Serve il numero di carta completo?

No, bastano le prime sei o otto cifre. Non è necessario digitare l’intero numero per riconoscere il circuito.

Il numero che digito viene salvato?

No. Il riconoscimento avviene nella pagina, sul tuo dispositivo: non viene inviato a nessun server né conservato.

Anche il riconoscimento del circuito è gratis?

Sì, gratis, senza limiti e senza registrazione: gira interamente nel browser.

Si usa bene anche da smartphone?

Sì, dal browser dello smartphone: incolli le cifre, esegui, leggi il risultato.

Per sviluppatori — accesso via API

Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.

Endpoint

POSThttps://api.kit.forhosting.com/verify/card-type

Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.

Chiamala dal tuo stack

curl -X POST https://api.kit.forhosting.com/verify/card-type \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"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[&#39;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" => &#39;{"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)

Esempio di richiesta

{
  "items": [
    "valor-1",
    "valor-2"
  ]
}

Esempio di risposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "verify.card_type",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.

Prezzi

per richiesta$0.002

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

Errori

HTTP	Codice	Significato
`401`	`unauthorized`	Chiave API mancante o non valida: controlla l'header Authorization.
`402`	`insufficient_balance`	Credito esaurito: ricarica per continuare a eseguire attività.
`404`	`unknown_type`	Tipo di attività sconosciuto: controlla il campo type della richiesta.
`429`	`rate_limited`	Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Leggi la documentazione completa del KIT →

Esegui gratis nel browser