Perú - AV (v2)

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

Parámetros de entrada

FormatoInputs
CCI
  • country_code = "PE" (requerido)
  • account_identifier = Número de CCI (requerido)
  • owner_name = Nombre asociado a la cuenta (opcional para match_verdict)
  • owner_id = Número de documento asociado a la cuenta (opcional para match_verdict)
  • account_currency = Moneda de la cuenta (opcional para match_verdict)
Local
  • country_code = "PE" (requerido)
  • account_identifier = Número de cuenta en formato local (requerido)
  • bank_code o swift_code = Código de la institución bancaria (requerido)
  • owner_name = Nombre asociado a la cuenta (opcional para match_verdict)
  • owner_id = Número de documento asociado a la cuenta (opcional para match_verdict)
  • account_currency = Moneda de la cuenta (opcional para match_verdict)

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

❗️

En Perú se validan únicamente cuentas de ahorro y cuentas corrientes en Dólares (USD) y en Soles (PEN); la posibilidad de validar cuentas CTS está sujeta a las políticas de cada entidad.


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 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
  • Número de cuenta en sus diferentes formatos

  • 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 PE

HTTP codeSub-codeDescripción
200PE001"Cuenta identificada, sin estado operacional reportado"
200PE004"No hay coincidencia para la cuenta proporcionada"
200PE007"No hay coincidencia para los datos proporcionados"
200PE008"Cuenta reportada como cerrada"
200PE013"Cuenta reportada como inactiva o bloqueada"
200PE015"Cuenta reportada como bloqueada"
200PE026"El nombre se encuentra parcialmente enmascarado debido a restricciones"
422PE032"El número de cuenta proporcionado no cumple con el formato requerido. Debe contener solo dígitos"
422PE034"El número de cuenta proporcionado no cumple con la longitud requerida para el banco seleccionado"
422PE035"El número de cuenta proporcionado no supera el algoritmo de validación de CCI"
422PE036"El valor proporcionado no corresponde a un formato válido. El CCI debe tener 20 dígitos y el teléfono 11 dígitos"
422PE044"El valor proporcionado no corresponde a un formato válido para número de teléfono"
400PE999"El banco consultado no existe o no está soportado"
503PE503"La cuenta no puede ser validada en formato local en este momento. Por favor, envíe la cuenta en formato CCI"

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