Vai al contenuto principale
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, è necessario prima andare alla pagina corrispondente dell’API di verifica a due fattori della carta bancaria per richiedere il servizio corrispondente. Una volta entrati nella pagina, fare clic sul pulsante “Acquire”, come mostrato nell’immagine: Se non si è ancora effettuato il login o la registrazione, si verrà automaticamente reindirizzati alla pagina di login per invitare a registrarsi e accedere. Dopo aver effettuato il login o la registrazione, si verrà automaticamente riportati alla pagina corrente. Alla prima richiesta, verrà offerto un credito gratuito, che consente di utilizzare gratuitamente l’API.

​
Utilizzo di base

Innanzitutto, è importante 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:

Si può notare che qui abbiamo impostato le intestazioni della richiesta, tra cui:
  • accept: il formato della risposta desiderata, 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 i campi sensibili (se è necessario inviare dati crittografati).
Dopo aver effettuato la selezione, si può 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, e qui abbiamo ottenuto il seguente risultato: 
{
  "result": "0",
  "description": "Autenticazione riuscita"
}
Il risultato restituito contiene 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’attività.
Si può notare che la veridicità e la coerenza del nome e del numero della carta bancaria sono state verificate con successo. Inoltre, se si desidera generare il codice di integrazione corrispondente, è possibile copiarlo direttamente, ad esempio il codice CURL è il seguente: 
curl -X POST 'https://api.acedata.cloud/identity/bankcard/check-2e' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "name": "***",
  "bank_card": "***"
}'
Il codice di integrazione in Python è il seguente: 
curl -X POST 'https://api.acedata.cloud/identity/bankcard/check-2e' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "name": "***",
  "bank_card": "***"
}'

​
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

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

​
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 possa aiutarti a integrare e utilizzare meglio l’API. Se hai domande, non esitare a contattare il nostro team di supporto tecnico.