·6 min

API para consultar CBU: cómo integrarla en tu sistema

¿Qué es una API de consulta de CBU?

Una API de consulta de CBU es un servicio web que te permite obtener información del titular de una cuenta bancaria argentina de forma programática. En lugar de consultar manualmente cada CBU, tu sistema hace un request HTTP y recibe los datos en formato JSON.

Esto es esencial para empresas que necesitan verificar cuentas bancarias como parte de sus procesos internos: onboarding de clientes, procesamiento de pagos, compliance, facturación y más.

Casos de uso

Fintechs y bancos digitales

Verificar que la cuenta bancaria que un usuario registra realmente le pertenece. Esto es fundamental para procesos de KYC (Know Your Customer) y prevención de fraude.

ERPs y sistemas contables

Automatizar la verificación de CBUs de proveedores y clientes. En lugar de verificar manualmente cada cuenta, el ERP consulta la API y obtiene los datos del titular.

Plataformas de pago

Validar que los CBUs de los comercios son correctos antes de acreditar pagos. Evitar errores de transferencia y devoluciones.

Sistemas de cobranza

Verificar que los datos bancarios de los deudores son correctos antes de iniciar el proceso de cobro.

Cómo funciona la API de Argenapi

La API de Argenapi es una API REST estándar que usa JSON sobre HTTPS.

Autenticación

Todas las requests se autentican con un API key en el header Authorization:

text

Authorization: Bearer ps_live_TU_API_KEY

Generás tu API key desde el dashboard de Argenapi.

Endpoint principal

text

GET https://argenapi.com/api/v1/lookup?identifier={cbu_o_alias}&type={cbu|alias}

Ejemplo con cURL

bash

-cmd">curl -X GET "https://argenapi.com/api/v1/lookup?identifier=0110599930059999999016&type=cbu" \
  -H "Authorization: Bearer ps_live_TU_API_KEY"

Ejemplo con Python

python

import requests

response = requests.get(
    "https://argenapi.com/api/v1/lookup",
    params={"identifier": "0110599930059999999016", "type": "cbu"},
    headers={"Authorization": "Bearer ps_live_TU_API_KEY"}
)

data = response.json()
print(data["data"]["holders"][0]["full_name"])
# Output: LIONEL ANDRES MESSI

Ejemplo con Node.js

javascript

const response = await fetch(
  "https://argenapi.com/api/v1/lookup?identifier=0110599930059999999016&type=cbu",
  { headers: { Authorization: "Bearer ps_live_TU_API_KEY" } }
);

const data = await response.json();
console.log(data.data.holders[0].full_name);
// Output: LIONEL ANDRES MESSI

Respuesta de la API

La API devuelve un objeto JSON con toda la información de la cuenta:

json

{
  "success": true,
  "data": {
    "holders": [
      {
        "tax_id": "20274463158",
        "full_name": "LIONEL ANDRES MESSI",
        "tax_id_type": "CUIT",
        "is_individual": true
      }
    ],
    "account_type": "CA",
    "active": true,
    "currency": "ARS",
    "bank": {
      "name": "BANCO DE LA NACION ARGENTINA",
      "code": "011"
    }
  },
  "credits_remaining": 847
}

Rate limiting

La API tiene límites de rate por defecto:

  • 60 requests por minuto por API key
  • 10.000 requests por día por API key

Si necesitás límites más altos, contactanos para un plan personalizado.

Precios

Cada consulta vía API consume 1 crédito. Los precios arrancan desde $999 por consulta individual, con descuentos de hasta 60% en packs.

Seguridad

  • Todas las comunicaciones son sobre HTTPS (TLS 1.2+).
  • Las API keys se almacenan encriptadas con AES-256-GCM.
  • Podés configurar IPs permitidas para cada API key.
  • Cada request se registra para auditoría.

Primeros pasos

  1. Registrate en Argenapi.
    1. Comprá un pack de créditos.
      1. Generá una API key desde el dashboard.
        1. Hacé tu primera consulta siguiendo la documentación.

        Toda la documentación técnica está disponible en argenapi.com/docs.

¿Necesitás consultar titulares de CBU?

Registrate en Argenapi y empezá a consultar en segundos. Sin suscripción.

Consultar titular de CBU