> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Istruzioni per l'integrazione dell'API di verifica dei tre elementi della carta bancaria
> Identity Authentication 集成指南 - XHuoAPI
Questo documento presenterà un'API di verifica dei tre elementi della carta bancaria, che può essere utilizzata per verificare la veridicità e la coerenza delle informazioni relative al numero della carta bancaria, al nome e al numero del documento di identità.
## Processo di richiesta
Per utilizzare l'API, è necessario prima andare alla pagina corrispondente dell'[API di verifica dei tre elementi della carta bancaria](https://api.xhuoapi.ai/documents/eb9c6677-68db-4549-a207-41f8a1084634) 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 tornerà automaticamente 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.
* `id_card`: il numero del documento di identità, è un parametro obbligatorio.
* `name`: il nome dell'utente, è un parametro obbligatorio.
* `cert_type`: il tipo di documento di identità, deve corrispondere al documento di identità, altrimenti non sarà possibile effettuare la verifica.
* `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:
Cliccando sul pulsante "Try" è possibile effettuare un test, come mostrato nell'immagine sopra, e qui abbiamo ottenuto il seguente risultato:
```json theme={null}
{
"result": "0",
"description": "Autenticazione riuscita"
}
```
Il risultato restituito contiene diversi campi, descritti di seguito:
* `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 commerciale.
Si può notare che la veridicità e la coerenza delle informazioni relative al numero della carta bancaria, al nome e al numero del documento di identità sono state verificate.
Inoltre, se si desidera generare il codice di integrazione corrispondente, è possibile copiarlo direttamente, ad esempio il codice CURL è il seguente:
```shell theme={null}
curl -X POST 'https://api.xhuoapi.ai/v1/identity/bankcard/check-3e' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
"name": "***",
"bank_card": "***",
"id_card": "***"
}'
```
Il codice di integrazione in Python è il seguente:
```python theme={null}
import requests
url = "https://api.xhuoapi.ai/v1/identity/bankcard/check-3e"
headers = {
"accept": "application/json",
"authorization": "Bearer {token}",
"content-type": "application/json"
}
payload = {
"name": "***",
"bank_card": "***",
"id_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
```json theme={null}
{
"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 tre elementi della carta bancaria per verificare la veridicità e la coerenza delle informazioni relative al numero della carta bancaria, al nome e al numero del documento di identità. 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.