Consultar cuenta por Alias o CBU/CVU

Nivel de seguridad requerida para este servicio

Alto Alto (accessToken + mutual TLS + VPN)

Objetivo

Este servicio permite obtener la información de una cuenta desde su CBU/CVU o Alias.

Request

Method: POST

/v2/apibank/accounts/get-by-address

curl -X POST "https://$env/v2/apibank/accounts/get-by-address" \
    -H 'Authorization: $YOUR_ACCESS_TOKEN'

env: Entorno de la API, como producción o desarrollo.
YOUR_ACCESS_TOKEN: Token obtenido en el servicio de autenticación.

Ejemplo de Request:

JSON

{
    "addressType": "CBU_CVU",
    "address": "0000000000000000000000"
}

addressType: Tipo de identificador. Valores posibles CBU_CVU o ALIAS
address: Número de cuenta o alias a buscar, de acuerdo al tipo indicado en addressType.

Ejemplo de Cuerpo del Mensaje

Búsqueda por CBU o CVU

{
    "addressType": "CBU_CVU",
    "address": "0000000000000000000000"
}

Búsqueda por Alias

{
    "addressType": "ALIAS",
    "address": "TOPO.MOPA.0099"
}

Ejemplo de Respuestas:

JSON

{
    "accountType": "CHECKING_ACCOUNT",
    "accountLabel": "Alias.de.cuenta",
    "accountRouting": [
        {  
        "addressType": "CBU",
        "address": "7159872511100058430757"
        }
    ],
    "entityRouting": {  
        "entityType": "BANK",
        "entityCode": "00432",
        "entityLegalName": "Banco de Comercio S.A.",
        "entityBrandName": NULL,
    },
    "owners": [
        {
            "personId": "3054332001",
            "personIdType": "CUI",
            "personName": "Empresa de Ejemplo S.A.",
            "personType": "LEGAL"
        }
    ],
    "info": {
            "status": "ACTIVE",
            "currencies": ["032"]
        }
}

Listar sub-cuentas Introducción