Skip to main content
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 de verificación de los tres elementos de la tarjeta bancaria, primero dirígete a Ace Data Cloud Console para obtener tu API Token, que debes guardar como respaldo. Si aún no has iniciado sesión o registrado, serás redirigido automáticamente a la página de inicio de sesión que te invitará a registrarte e iniciar sesión, y después volverás automáticamente a la página actual. Un API Token es suficiente para acceder a todos los servicios de la plataforma, no es necesario solicitar uno por cada servicio. La primera solicitud incluirá un crédito gratuito para que puedas probarlo; si el crédito es insuficiente, puedes recargar el saldo general en la consola.
📘 Documentación completa: API de verificación de los tres elementos de la tarjeta bancaria →

​
Uso básico

Primero, debes entender 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, necesitas pasar un campo bank_card. Luego, puedes 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 deseas recibir, aquí se establece como application/json, es decir, formato JSON.
  • authorization: la clave para llamar a la API, que puedes seleccionar directamente después de solicitarla.
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 del 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 para campos sensibles (si se necesita enviar encriptado).
Después de seleccionar, puedes notar que también se ha generado el código correspondiente a la derecha, como se muestra en la imagen:

Haz clic en el botón “Try” para realizar la prueba, como se muestra en la imagen anterior, aquí hemos obtenido el siguiente resultado:
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 tragadora
      • -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, por favor intenta de nuevo 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 deseas generar el código de integración correspondiente, puedes copiarlo directamente, por ejemplo, el código de CURL es el siguiente:
El código de integración en Python es el siguiente:

​
Manejo de errores

Al llamar a la API, si encuentras 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, has superado el límite de tasa.
  • 500 api_error: Error interno del servidor, algo salió mal en el servidor.

​
Ejemplo de respuesta de error

​
Conclusión

A través de este documento, has aprendido 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 te ayude a integrar y utilizar mejor esta API. Si tienes alguna pregunta, no dudes en contactar a nuestro equipo de soporte técnico.