Skip to main content
Questo documento introduce un’API di verifica a due fattori della carta bancaria, che può essere utilizzata per verificare la veridicità e la coerenza del nome e del numero della carta bancaria.

​
Processo di richiesta

Per utilizzare l’API di verifica a due fattori della carta bancaria, prima di tutto vai al Pannello di controllo di Ace Data Cloud per ottenere il tuo API Token, da conservare per uso futuro. Se non hai ancora effettuato il login o la registrazione, verrai automaticamente reindirizzato alla pagina di login che ti invita a registrarti e a effettuare il login; una volta completato, verrai riportato automaticamente alla pagina corrente. Un API Token è sufficiente per accedere a tutti i servizi della piattaforma, senza dover richiedere separatamente per ogni servizio. La prima richiesta include un credito gratuito, che consente di provare il servizio gratuitamente; quando il credito è insufficiente, puoi ricaricare il saldo generale nel pannello di controllo.
📘 Documentazione completa: API di verifica a due fattori della carta bancaria →

​
Utilizzo di base

Iniziamo a comprendere il modo di utilizzo di base, che consiste nell’inserire le informazioni del numero della carta bancaria per ottenere l’immagine del risultato elaborato; è necessario semplicemente trasmettere un campo bank_card. Possiamo quindi compilare il contenuto corrispondente nell’interfaccia, come mostrato nell’immagine:

Possiamo vedere che qui abbiamo impostato le intestazioni della richiesta, che includono:
  • accept: il formato della risposta desiderato, qui impostato su application/json, ovvero formato JSON.
  • authorization: la chiave per chiamare l’API, che può essere selezionata direttamente dopo la richiesta.
Inoltre, abbiamo impostato il corpo della richiesta, che include:
  • bank_card: le informazioni del numero della carta bancaria da elaborare, è un parametro obbligatorio.
  • name: il nome dell’utente, è un parametro obbligatorio.
  • encryption: opzionale, parametro di crittografia per campi sensibili (se è necessario inviare dati crittografati).
Dopo aver selezionato, possiamo notare che a destra è stato generato il codice corrispondente, come mostrato nell’immagine:

Cliccando sul pulsante “Try” è possibile effettuare un test; come mostrato nell’immagine sopra, abbiamo ottenuto il seguente risultato:
Il risultato restituito ha diversi campi, descritti come segue:
  • result, codice del risultato dell’autenticazione, le condizioni di addebito sono le seguenti.
    • Codici di risultato a pagamento:
      • 0: Autenticazione riuscita
      • -1: Autenticazione non riuscita
      • -4: Informazioni sul titolare della carta errate
      • -5: Pagamento senza carta non attivato
      • -6: Questa carta è stata confiscata
      • -7: Numero di carta non valido
      • -8: Questa carta non ha un emittente corrispondente
      • -9: Questa carta non è stata inizializzata o è una carta dormiente
      • -10: Carta fraudolenta, carta trattenuta
      • -11: Questa carta è stata denunciata come smarrita
      • -12: Questa carta è scaduta
      • -13: Carta limitata
      • -14: Numero massimo di tentativi di password superato
      • -15: L’emittente non supporta questa transazione
    • Codici di risultato non a pagamento:
      • -2: Verifica del nome non riuscita
      • -3: Numero della carta bancaria errato
      • -16: Servizio del centro di verifica occupato
      • -17: Numero massimo di verifiche superato, riprovare il giorno successivo
  • description, descrizione del risultato dell’operazione.
Si può notare che la veridicità e la coerenza del nome e del numero della carta bancaria sono state verificate. Inoltre, se si desidera generare il codice di integrazione corrispondente, è possibile copiarlo direttamente, ad esempio il codice CURL è il seguente:
Il codice di integrazione in Python è il seguente:

​
Gestione degli errori

Quando si chiama l’API, se si verifica un errore, l’API restituirà il codice di errore e le informazioni corrispondenti. Ad esempio:
  • 400 token_mismatched: Richiesta non valida, probabilmente a causa di parametri mancanti o non validi.
  • 400 api_not_implemented: Richiesta non valida, probabilmente a causa di parametri mancanti o non validi.
  • 401 invalid_token: Non autorizzato, token di autorizzazione non valido o mancante.
  • 429 too_many_requests: Troppe richieste, hai superato il limite di frequenza.
  • 500 api_error: Errore interno del server, qualcosa è andato storto sul server.

​
Esempio di risposta di errore

​
Conclusione

Attraverso questo documento, hai appreso come utilizzare l’API di verifica a due fattori della carta bancaria per verificare la veridicità e la coerenza del nome e del numero della carta bancaria. Speriamo che questo documento ti aiuti a integrare e utilizzare meglio questa API. Se hai domande, non esitare a contattare il nostro team di supporto tecnico.