Validar BIN y Comercio (Versioning)

Antes de generar la Autenticación es necesario primero validar si el Comercio y el bin participa del Protocolo de Autenticación con el API de Validar Bin y Comercio (llamado también Versioning).

Ambiente	EndPoint	Método
Pre-Producción	https://uatalgreq.3dsecurekey.cloud/requestor/versioning	POST
Producción	https://api.alignet.io/requestor/versioning	POST

Headers

Cabecera	Valor	Requerido
Content-Type	application/json	SI
key	(Compartido por Alignet)	SI

Request

Parámetro	Tipo	Long.	Descripción	Req.
acctNumber	String	13-19	Número de cuenta que se usará en la solicitud de autorización para transacciones de pago. Puede ser representado por PAN	SI
acquirerMerchantID	String	35	Identificador del comerciante asignado por el adquiriente.	SI

Ejemplo

JSON

{
    "acctNumber" : "427831******3877",
    "acquirerMerchantID" : "104209"
}

El acctNumber deberá enviarse en claro, sin asteriscos.

Response

Nombre de Campo	Tipo	Long.	Descripción
threeDSServerTransID	String	36	Identificador de transacción único universal asignado por el servidor 3DS para identificar una sola transacción.
acsEndProtocolVersion	String	5-8	La versión más reciente del protocolo activo que se admite para la URL de ACS.
acsStartProtocolVersion	String	5-8	La primera versión del protocolo activo (es decir, la más antigua) que es compatible con el ACS.
dsEndProtocolVersion	String	5-8	La versión más reciente del protocolo activo que se admite para DS.
dsStartProtocolVer sion	String	5-8	La primera versión del protocolo activo (es decir, la más antigua) que es compatible con el DS.
versioningStatus	Boolea n	True/false	Valor que identifica si la tarjeta y el comercio participan o no la autenticación 2.1.0
meta	Array		Valor que detalla el resultado de la consulta al servicio threeDSVersioning, en este campo se envía el código del acquirerMerchantID y el status, este último contendrá el código de respuesta de las validaciones (code) realizadas a los campos enviados en la consulta y el message_ilgn, el cual contiene los campos locale (idioma en el que se devuelve el valor del value) y value (descripción del campo code)
brand_code	String		Código asignado a la marca de la tarjeta: VISA: código correspondiente a Visa MSCD: código correspondiente a Mastercard AMEX: código correspondiente a American Express
vci	String		Campo que identifica como termino la autenticación de manera específica: NPB : Bin no participa NPC : Comercio No Participa NPCB : Comercio y BIN No Participan SPCB : Comercio y BIN Sí Participan

Ejemplo

JSON

{
    "threeDSServerTransID": "f281382d-7757-41d2-9248-d6f4adf242fb",
    "acsEndProtocolVersion": "2.1.0",
    "acsStartProtocolVersion": "2.1.0",
    "dsEndProtocolVersion": "2.1.0",
    "dsStartProtocolVersion": "2.1.0",
    "brand_code": "VISA",
    "vci": "SPCB",
    "versioningStatus": true,
    "meta": {
        "acquirerMerchantID": "104209",
        "status": {
            "code": "00",
            "message_ilgn": [
                {
                    "locale": "es_PE",
                    "value": "Valores obtenidos correctamente"
                }
            ]
        }
    }
}

Si el vci de respuesta es SPCB se debe continuar con el siguiente API Generar Autenticación, de lo contrario no se podrá autenticar al tarjetahabiente con el comercio enviado.