Saltar al contenido principal

🧩 Funcionalidades Validación e Identificación

📘 Descripción general​

El servicio de validación de Debi permite crear métodos de pago, tokenizarlos, validar que cumplan las reglas de validación correspondientes, y utilizarlos en futuros pagos. A su vez, nos permite clasificarlos según sus propiedades para tomar decisiones de negocio informadas.

Adicionalmente se puede extender este servicio, con la identificación del medio de pago, lo cual nos permite acceder a funcionalidades API Banking adicionales, como identificación de cbu a partir de un alias, identificación de titulares de un medio de pago, tipo de cuenta, etc.

🎯 Funcionalidades principales​

  • Creación de métodos de pago: Permite registrar diferentes tipos de medios de pago (tarjetas, CBU, alias, IBAN)
  • Tokenización: Convierte los datos sensibles en tokens seguros para uso posterior
  • Validación: Verifica que los datos cumplan con las reglas de validación correspondientes
  • Clasificación: Permite categorizar los métodos según sus propiedades para análisis de negocio
  • Identificación bancaria: Para CBU, permite identificar al propietario de la cuenta

🔍 Identificación de cuentas bancarias (CBU)​

Para el tipo de método de pago CBU, agregando el parámetro identification con el valor true, podemos:

  • Identificar la cuenta bancaria para determinar su propietario y su tipo de cuenta
  • Enviar un alias y determinar cuál es su CBU correspondiente y quién es su propietario
  • Cuentas empresariales: El objeto creado contendrá un array con los co-propietarios correspondientes
  • Búsqueda por alias: Si envías un parámetro alias en el payload, no es necesario indicar el número de CBU, y como respuesta obtendremos el CBU correspondiente a ese alias

Este servicio es especialmente útil para validar datos ingresados por usuarios y confirmar su validez antes de procesar cobros, así como para obtener información detallada sobre los titulares de las cuentas bancarias.

🎯 Casos de uso frecuentes​

  • Validar un método de pago antes de aceptarlo: Aplicar los algoritmos propios de cada tipo de método de pago para evitar errores de tipeo y asegurar la validez de los datos ingresados por el usuario.

  • Identificar propietarios de un CBU para implementar barreras anti-fraude: Buscar coincidencia entre el CBU y el CUIL/CUIT del propietario para verificar la identidad y prevenir fraudes en transacciones bancarias.

  • Clasificar el método de pago (débito, crédito, prepaga) para tomar decisiones de negocio: Decidir aceptar o no un tipo de método de pago, o tratarlo de manera distinta de acuerdo a su clasificación para optimizar procesos y estrategias comerciales.

🔑 Autenticación​

Para consumir el servicio se utilizan API Keys disponibles en el dashboard de Debi:

  • Clave pública:
    Se puede usar desde el frontend para crear métodos de pago o realizar validaciones básicas.
    👉 Disponible en: https://debi.pro/dashboard/developers

  • Clave privada (secreta):
    Requerida para obtener información sensible, como datos de titularidad o tipo de cuenta.
    Los requests realizados con esta clave deben hacerse desde el backend, ya que contienen datos protegidos y con costo asociado.

⚠️ Los datos de identificación bancaria (titulares, tipo de cuenta, estado) solo se devuelven cuando se utiliza la clave privada.

📡 Crear un método de pago​

Para crear un método de pago, se utiliza el endpoint:

POST https://api.debi.pro/v1/payment_methods

Documentación oficial:
👉 https://debi.pro/docs/spa/api#tag/Metodos-de-Pago/operation/PaymentMethodsCreatePaymentMethod

Dependiendo del tipo de método de pago (tarjeta, CBU o alias), se envía un payload distinto.

🧾 Ejemplos de requests​

Validar tarjeta sin identificar​

Basta enviar en el header la public key y puede hacerse desde el front end

{
  "type": "card",
  "card": {
    "number": "4111111111111111"
  }
}

Validar e identificar alias​

Requiere secret key en el header

{
  "type": "cbu",
  "cbu": {
    "alias": "usuarioejemplo",
    "identification": true
  }
}

Validar e identificar CBU​

Requiere secret key en el header

{
  "type": "cbu",
  "cbu": {
    "number": "2859363672283668188432",
    "identification": true
  }
}

💬 Ejemplo de respuesta​

Ejemplo del objeto Payment Method de tipo CBU

{
  "data": {
    "id": "PMRAbc123xyz",
    "object": "payment_method",
    "type": "cbu",
    "cbu": {
      "last_four_digits": "9876",
      "bank": "Banco de Galicia y Buenos Aires S.A.",
      "country": "AR",
      "identification": {
        "owners": [
          {
            "id": "20300123456",
            "display_name": "MARIANO GONZÁLEZ",
            "id_type": "CUIT",
            "is_physical_person": true
          }
        ],
        "is_active": true,
        "type": "CA",
        "currency": "ARS"
      }
    }
  }
}

⚙️ Consultar información de un método creado​

Una vez creado un payment_method, podés obtener los detalles con: GET https://api.debi.pro/v1/payment_methods/{id}

Ejemplo

GET https://api.debi.pro/v1/payment_methods/PMRAbc123xyz

Este request devolverá los datos del medio de pago, incluyendo titularidad y tipo de cuenta si se utiliza la clave privada.

💳 Sobre la validación de tarjetas​

  • El servicio puede validar el número de tarjeta y determinar su red emisora.
  • No se devuelven datos de vencimiento a menos que el cliente los haya enviado explícitamente en el payload (Debi no puede inferir esa información por seguridad).

🔍 Demo pública​

Podés probar el servicio en el entorno de demostración:
👉 https://validation.debi.pro/

🧠 Notas importantes​

  • Las consultas con clave pública solo devuelven datos no sensibles.
  • Las consultas con clave privada exponen información de titulares de la cuenta.
  • Las respuestas pueden tener costo asociado según el tipo de validación.
  • La API devuelve errores claros en caso de medios inválidos o cuentas inexistentes.