Guías
Inicia sesión en Prometeo

Colombia - AV (v2)

Cobertura del 80% de las cuentas bancarias del país.

Parámetros de entrada

FormatoInputs
Local
  • country_code = "CO" (requerido)
  • account_identifier = Número de cuenta en formato local (requerido)
  • bank_code o swift_code = Código de la institución bancaria (requerido)
  • account_type = Tipo de cuenta (CACC o SVGS) (requerido) (*)
  • owner_id = Número de CC/NIT asociado a la cuenta (requerido)
  • owner_id_type = Tipo de documento asociado a la cuenta (CC o NIT) (requerido)
  • owner_name = Nombre asociado a la cuenta (opcional para match_verdict)
  • account_currency = Moneda de la cuenta (opcional para match_verdict)
(*) Siendo CACC = Cuenta Corriente, SVGS = Cuenta Ahorro.
Billetera Nequi
  • country_code = "CO" (requerido)
  • account_identifier = Número de billetera Nequi (requerido)
  • account_identifier_type = "NEQUI_WALLET" (requerido)
  • owner_id = Número de CC/NIT asociado a la billetera (requerido)
  • owner_id_type = Tipo de documento asociado a la billetera (CC, NIT, CD, CE, TI, PAS, IEPN, IEPJ, FD o RC) (requerido)
  • owner_name = Nombre asociado a la cuenta (opcional para match_verdict)
  • account_currency = Moneda de la cuenta (opcional para match_verdict)
Llave Bre-B

  • country_code = "CO" (requerido)

  • account_identifier = Llave Bre-B de la cuenta (requerido)

  • account_identifier_type = "BREB_KEY" (requerido)

Para ver más detalles visita la sección de referencia: Referencia de la API

✅

En Colombia se encuentra disponible únicamente para cuentas en moneda local.


Contenido de la respuesta

ServicioInformación
account_validation
  • Existencia de la cuenta
  • Estado operativo de la cuenta
  • Particularidades asociadas al estado de la cuenta
account_owner_name
  • Nombre asociado a la cuenta
  • Grado de coincidencia (match) con el input ingresado
account_owner_id

  • Número y tipo de documento asociado a la cuenta

  • Grado de coincidencia (match) con el input ingresado

account_currency

  • Moneda asociada a la cuenta

  • Grado de coincidencia (match) con el input ingresado

account_details

  • Tipo de cuenta

  • Detalles sobre el banco de la cuenta

⚠️

Esta suele ser la respuesta general de la API para este país. Puede haber ocasiones en las que el banco destinatario no proporcione toda la información listada anteriormente. En ese caso, el campo será devuelto en blanco.


Códigos y subcódigos de respuestas para CO

HTTP codeSub-codeDescripción
200CO000"Cuenta reportada como activa"
200CO001"Cuenta identificada, sin estado operacional reportado"
200CO003"Cuenta reportada como inactiva"
200CO007"No hay coincidencia para los datos proporcionados"
200CO008"Cuenta reportada como cerrada"
200CO009"Cuenta reportada como embargada"
200CO010"No hay coincidencia para la llave proporcionada"
200CO026"El nombre se encuentra parcialmente enmascarado debido a restricciones"
422CO032"El número de cuenta proporcionado no cumple con el formato requerido. Debe contener solo dígitos"
422CO034"El número de cuenta proporcionado no cumple con la longitud requerida para el banco seleccionado"
422CO040"El número de documento proporcionado no cumple con el formato requerido. Debe contener solo dígitos"
422CO041"El número de documento proporcionado no cumple con la longitud requerida para un documento válido"
422CO042"El número de documento proporcionado no supera el algoritmo de validación de NIT"
422CO043"El número de cuenta proporcionado no corresponde a un formato válido para la institución seleccionada"

Códigos y subcódigos de respuestas generales

HTTP codeSub-codeDescripción
200XX000"Información no disponible"
202XX202"Validación pendiente"
400XX400"Parámetro faltante: XXXX"
400XX400"Parámetro inválido: XXXX"
401XX401"API key faltante"
401XX401"API key inválida"
403XX403"La funcionalidad solicitada (XXX) no está habilitada para esta API key"
403XX403"El servicio solicitado (XXX) no está habilitado para esta API key"
403XX403"El país solicitado (XX) no está habilitado para esta API key"
403XX403"Validación no permitida para este identificador"
500XX500"Error interno"
503XX503"Error de comunicación"

Datos mock para pruebas en Sandbox

CasoDatos
Cuenta activa (Local)"country_code": "CO"
"account_identifier": "000000001"
"bank_code": "999" o "swift_code": "PROMCO99XXX"
"account_type": "CACC"
"owner_id": "123456789"
"owner_id_type": "CC"

"owner_name": "Carlos Rodríguez"
"account_currency": "COP"
Cuenta sin estado operacional (Local)"country_code": "CO"
"account_identifier": "000000002"
"bank_code": "999" o "swift_code": "PROMCO99XXX"
"account_type": "CACC"
"owner_id": "123456789"
"owner_id_type": "CC"
Cuenta inactiva (Local)"country_code": "CO"
"account_identifier": "000000003"
"bank_code": "999" o "swift_code": "PROMCO99XXX"
"account_type": "CACC"
"owner_id": "123456789"
"owner_id_type": "CC"
Cuenta cerrada (Local)"country_code": "CO"
"account_identifier": "000000004"
"bank_code": "999" o "swift_code": "PROMCO99XXX"
"account_type": "CACC"
"owner_id": "123456789"
"owner_id_type": "CC"
Cuenta embargada (Local)"country_code": "CO"
"account_identifier": "000000005"
"bank_code": "999" o "swift_code": "PROMCO99XXX"
"account_type": "CACC"
"owner_id": "123456789"
"owner_id_type": "CC"
Cuenta activa (Nequi)"country_code": "CO"
"account_identifier": "3134292422"
"account_identifier_type": "NEQUI_WALLET_TEST"
"owner_id": "123456789"
"owner_id_type": "CC"

"owner_name": "Carlos Rodríguez"
"account_currency": "COP"
Cuenta activa (Bre-b)"country_code": "CO"
"account_identifier": "@key1234"
"account_identifier_type": "BREB_KEY_TEST"

"owner_id": "123456789"
"owner_id_type": "CC"
"owner_name": "Carlos Rodríguez"
"account_currency": "COP"
Cuenta sin coincidencia (Bre-b)"country_code": "CO"
"account_identifier": "@key4321"
"account_identifier_type": "BREB_KEY_TEST"