Saltar al contenido principal
Este documento presentará una verificación de los cuatro elementos de la tarjeta bancaria API, que se puede utilizar para ingresar el número de la tarjeta bancaria, nombre, número de documento de apertura y número de teléfono de apertura, para verificar la autenticidad y consistencia de la información.

​
Proceso de solicitud

Para utilizar la API, primero debe ir a la página correspondiente de Verificación de los cuatro elementos de la tarjeta bancaria API para solicitar el servicio correspondiente. Una vez en la página, haga clic en el botón “Adquirir”, 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, volverá 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 la tarjeta bancaria para 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 encabezados de la solicitud, que incluyen:
  • accept: el formato de respuesta que desea recibir, aquí se llena 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 configuró el cuerpo de la solicitud, que incluye:
  • bank_card: la información del número de la 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.
  • phone: número de teléfono reservado.
  • cert_type: tipo de documento de apertura, debe coincidir con el documento de apertura.
  • encryption: opcional, parámetro de cifrado de campos sensibles (si se necesita enviar encriptado).
Después de seleccionar, se puede ver que también se generó el código correspondiente a la derecha, como se muestra en la imagen:

Haga clic en el botón “Probar” para realizar la prueba, como se muestra en la imagen anterior, aquí obtuvimos el siguiente resultado: 
{
  "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 está 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 el número de la tarjeta bancaria, el nombre, el número de documento de apertura y el número de teléfono de apertura de esta tarjeta bancaria tienen autenticidad y consistencia. 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: 
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": "***"
}'
El código de integración en Python es el siguiente: 
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)

​
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

{
  "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 aprendido cómo utilizar la API de verificación de los cuatro elementos de la tarjeta bancaria para ingresar el número de la tarjeta bancaria, nombre, número de documento de apertura y número de teléfono de apertura, para verificar la autenticidad y consistencia de la información. 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.