> ## 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.
# Verificación de los tres elementos de la tarjeta bancaria API Documentación de integración
> Identity Authentication 集成指南 - XHuoAPI
Este documento presentará una verificación de los tres elementos de la tarjeta bancaria API, que se puede utilizar para verificar la autenticidad y consistencia de la información del número de tarjeta bancaria, nombre y número de documento de apertura.
## Proceso de solicitud
Para utilizar la API, primero debe ir a la página correspondiente de [Verificación de los tres elementos de la tarjeta bancaria API](https://api.xhuoapi.ai/documents/eb9c6677-68db-4549-a207-41f8a1084634) para solicitar el servicio correspondiente. Una vez en la página, haga clic en el botón "Acquire", como se muestra en la imagen:
Si aún no ha iniciado sesión o registrado, será redirigido automáticamente a la página de inicio de sesión que le invita a registrarse e iniciar sesión. Después de iniciar sesión o registrarse, será redirigido automáticamente a la página actual.
En la primera solicitud, se le otorgará un límite gratuito que le permitirá utilizar la API de forma gratuita.
## Uso básico
Primero, comprenda la forma básica de uso, que consiste en ingresar la información del número de tarjeta bancaria, y podrá obtener la imagen del resultado procesado. Primero, necesita pasar un campo `bank_card`. A continuación, podemos completar el contenido correspondiente en la interfaz, como se muestra en la imagen:
Aquí podemos ver que hemos configurado los Request Headers, que incluyen:
* `accept`: el formato de respuesta que desea recibir, aquí se establece como `application/json`, es decir, formato JSON.
* `authorization`: la clave para llamar a la API, que puede seleccionar directamente después de solicitar.
Además, se ha configurado el Request Body, que incluye:
* `bank_card`: la información del número de tarjeta bancaria que necesita ser procesada, es un parámetro obligatorio.
* `id_card`: el número de documento de apertura, es un parámetro obligatorio.
* `name`: el nombre del usuario, es un parámetro obligatorio.
* `cert_type`: el tipo de documento de apertura, debe coincidir con el documento de apertura, de lo contrario, no se puede verificar.
* `encryption`: opcional, parámetro de cifrado de campos sensibles (si se necesita enviar encriptado).
Después de seleccionar, se puede observar que también se ha generado el código correspondiente a la derecha, como se muestra en la imagen:
Haga clic en el botón "Try" para realizar la prueba, como se muestra en la imagen anterior, aquí hemos obtenido el siguiente resultado:
```json theme={null}
{
"result": "0",
"description": "Autenticación aprobada"
}
```
El resultado devuelto tiene varios campos, que se describen a continuación:
* `result`, código de resultado de autenticación, la situación de cobro es la siguiente.
* Códigos de resultado de cobro:
* 0: Autenticación aprobada
* -1: Autenticación no aprobada
* -4: Información del titular de la tarjeta incorrecta
* -5: No se ha habilitado el pago sin tarjeta
* -6: Esta tarjeta ha sido confiscada
* -7: Número de tarjeta no válido
* -8: Esta tarjeta no tiene un banco emisor correspondiente
* -9: Esta tarjeta no ha sido inicializada o es una tarjeta inactiva
* -10: Tarjeta de trampa, tarjeta tragada
* -11: Esta tarjeta ha sido reportada como perdida
* -12: Esta tarjeta ha expirado
* -13: Tarjeta restringida
* -14: Exceso de intentos de contraseña
* -15: El banco emisor no admite esta transacción
* Códigos de resultado sin cobro:
* -2: Verificación de nombre no aprobada
* -3: Número de tarjeta bancaria incorrecto
* -16: Servicio del centro de verificación ocupado
* -17: Exceso de intentos de verificación, intente nuevamente al día siguiente
* `description`, descripción del resultado del negocio.
Se puede ver que la autenticidad y consistencia de la información del número de tarjeta bancaria, nombre y número de documento de apertura ha sido aprobada.
Además, si desea generar el código de integración correspondiente, puede copiarlo directamente, por ejemplo, el código de CURL es el siguiente:
```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": "***"
}'
```
El código de integración en Python es el siguiente:
```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)
```
## Manejo de errores
Al llamar a la API, si encuentra un error, la API devolverá el código de error y la información correspondiente. Por ejemplo:
* `400 token_mismatched`: Solicitud incorrecta, posiblemente debido a parámetros faltantes o inválidos.
* `400 api_not_implemented`: Solicitud incorrecta, posiblemente debido a parámetros faltantes o inválidos.
* `401 invalid_token`: No autorizado, token de autorización inválido o faltante.
* `429 too_many_requests`: Demasiadas solicitudes, ha superado el límite de tasa.
* `500 api_error`: Error interno del servidor, algo salió mal en el servidor.
### Ejemplo de respuesta de error
```json theme={null}
{
"success": false,
"error": {
"code": "api_error",
"message": "la recuperación falló"
},
"trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}
```
## Conclusión
A través de este documento, ha comprendido cómo utilizar la API de verificación de los tres elementos de la tarjeta bancaria para verificar la autenticidad y consistencia de la información del número de tarjeta bancaria, nombre y número de documento de apertura. Esperamos que este documento le ayude a integrar y utilizar mejor esta API. Si tiene alguna pregunta, no dude en ponerse en contacto con nuestro equipo de soporte técnico.