Vai al contenuto principale
Questo documento introduce una verifica dei quattro elementi della carta bancaria API, che può essere utilizzata per inserire il numero della carta bancaria, il nome, il numero del documento di apertura e il numero di telefono associato, per verificare la veridicità e la coerenza delle informazioni.

​
Processo di richiesta

Per utilizzare l’API, è necessario prima andare alla pagina corrispondente della verifica dei quattro elementi della carta bancaria API 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 che invita 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 questa API.

​
Utilizzo di base

Innanzitutto, è necessario comprendere il modo di utilizzo di base, ovvero 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, sono state impostate le informazioni del corpo della richiesta, tra cui:
  • bank_card: le informazioni del numero della carta bancaria da elaborare, è un parametro obbligatorio.
  • id_card: il numero del documento di apertura, è un parametro obbligatorio.
  • name: il nome dell’utente, è un parametro obbligatorio.
  • phone: numero di telefono riservato.
  • cert_type: tipo di documento di apertura, deve corrispondere al documento di apertura.
  • encryption: opzionale, parametro di crittografia per i campi sensibili (se è necessario inviare il testo crittografato).
Dopo aver selezionato, si può notare che a destra è stato generato il codice corrispondente, come mostrato nell’immagine:

Fare clic sul pulsante “Try” per eseguire il test, come mostrato nell’immagine sopra, qui abbiamo ottenuto il seguente risultato: 
{
  "result": "0",
  "description": "Autenticazione riuscita"
}
Il risultato restituito ha diversi campi, descritti come segue:
  • result, codice del risultato dell’autenticazione, la situazione dei costi è la seguente.
    • 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 il numero della carta bancaria, il nome, il numero del documento di apertura e il numero di telefono associato presentano veridicità e coerenza. 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-4e' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "name": "***",
  "phone": "***",
  "id_card": "***",
  "bank_card": "***"
}'
Il codice di integrazione Python è il seguente: 
import requests

url = "https://api.acedata.cloud/identity/bankcard/check-4e"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "name": "胡印福",
    "phone": "***",
    "id_card": "***",
    "bank_card": "***"
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

​
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 dei quattro elementi della carta bancaria per inserire il numero della carta bancaria, il nome, il numero del documento di apertura e il numero di telefono associato, per verificare la veridicità e la coerenza delle informazioni. Speriamo che questo documento possa aiutarti a integrare e utilizzare meglio questa API. Se hai domande, non esitare a contattare il nostro team di supporto tecnico.