API para validar CBU y CVU y saber de qué banco es

Antes de transferir o de guardar los datos de cobro de un proveedor, validá el CBU o CVU: la API chequea los dos dígitos verificadores y te dice de qué banco es (o si es una billetera virtual), con la sucursal y la cuenta.

Cuesta 1 crédito por consulta (entre USD 0,02 y USD 0,03, según el pack). La key de prueba es gratis, sin registro ni tarjeta, y trae 50 créditos. La misma key sirve en las tres APIs de la suite (AR Tools, Índices AR y Direcciones AR), con un solo saldo.

Para qué la usan

Empezá en un minuto

1. Pedí una key de prueba

curl -X POST https://ar-tools-api-103907796853.us-east1.run.app/v1/keys -H 'content-type: application/json' -d '{"name": "mi-sistema"}'

Devuelve key (empieza con ak_, guardala: no se vuelve a mostrar), key_id y los créditos.

2. Llamá a validar_cbu

curl -X POST https://ar-tools-api-103907796853.us-east1.run.app/v1/tools/validar_cbu \
  -H 'Authorization: Bearer ak_...' \
  -H 'content-type: application/json' \
  -d '{"cbu":"0070999000004012345672"}'

Respuesta

{
  "result": {
    "valido": true,
    "cbu": "0070999000004012345672",
    "tipo": "CBU",
    "entidad_codigo": "007",
    "entidad_nombre": "Banco de Galicia y Buenos Aires",
    "sucursal": "0999",
    "cuenta": "0000401234567"
  },
  "credits": {
    "cost": 1,
    "balance": 49
  }
}

Python

import requests

r = requests.post(
    "https://ar-tools-api-103907796853.us-east1.run.app/v1/tools/validar_cbu",
    headers={"Authorization": "Bearer ak_..."},
    json={ "cbu": "0070999000004012345672" },
    timeout=30,
)
print(r.json()["result"])

JavaScript

const r = await fetch("https://ar-tools-api-103907796853.us-east1.run.app/v1/tools/validar_cbu", {
  method: "POST",
  headers: { Authorization: "Bearer ak_...", "content-type": "application/json" },
  body: JSON.stringify({"cbu":"0070999000004012345672"}),
});
const { result, credits } = await r.json();

Agentes de IA (MCP)

La misma tool está en el servidor MCP https://ar-tools-api-103907796853.us-east1.run.app/mcp, junto con las demás de AR Tools.

claude mcp add --transport http ar-tools https://ar-tools-api-103907796853.us-east1.run.app/mcp --header "Authorization: Bearer ak_..."
{
  "mcpServers": {
    "ar-tools": {
      "url": "https://ar-tools-api-103907796853.us-east1.run.app/mcp",
      "headers": {
        "Authorization": "Bearer ak_..."
      }
    }
  }
}

n8n

Usá un nodo HTTP Request: método POST, URL https://ar-tools-api-103907796853.us-east1.run.app/v1/tools/validar_cbu, header Authorization con el valor Bearer ak_... (mejor como credencial de tipo Header Auth) y, en Body, JSON con {"cbu":"0070999000004012345672"}. El resultado queda en {{$json.result}}. También podés usar el nodo MCP Client con la URL https://ar-tools-api-103907796853.us-east1.run.app/mcp.

Google Sheets

En Extensiones → Apps Script, pegá esta función. Guardá la key en Configuración del proyecto → Propiedades de la secuencia de comandos con el nombre AR_API_KEY, así no queda en el código. Después usala en una celda: =BANCO_CBU(B2). Cada celda hace una consulta y gasta créditos.

function BANCO_CBU(cbu) {
  const key = PropertiesService.getScriptProperties().getProperty("AR_API_KEY");
  const r = UrlFetchApp.fetch("https://ar-tools-api-103907796853.us-east1.run.app/v1/tools/validar_cbu", {
    method: "post",
    contentType: "application/json",
    headers: { Authorization: "Bearer " + key },
    payload: JSON.stringify({ cbu: cbu }),
  });
  return JSON.parse(r.getContentText()).result.entidad_nombre;
}

Preguntas frecuentes

¿Me dice quién es el titular?

No. El CBU no contiene el nombre ni el CUIT del titular; eso solo lo ve el banco al cargar la transferencia.

¿Funciona con CVU de Mercado Pago, Ualá y otras billeteras?

Sí. Los CVU empiezan con 000 y se validan igual; la respuesta trae tipo: "CVU".

¿Qué pasa si el código de banco no está en la lista?

El CBU se valida igual; entidad_nombre viene como desconocida con el código de 3 dígitos.

¿Qué pasa cuando se terminan los créditos?

La API responde 402 con un checkout_url para recargar. Los packs se pagan una sola vez, sin suscripción, y los créditos no vencen. Ver precios.

Más

Otras APIs de datos argentinos

Privacidad