Servicio de consulta de transacción

Esta llamada permite a 3DS Requestor consultar el estado de una transacción. 3DS Requestor debe utilizar esta operación si hay problemas para recibir CR. Devolveremos estado, ECI y CAVV, es decir, lo que se necesita para proceder con una autorización.

Detalles de la llamada#

Recurso: / v2 / transaction / {ID de la transacción 3DS Server}
Método HTTP: GET
Respuesta HTTP OK: 200
Formato de solicitud: no hay parámetros de solicitud
Formato de respuesta: JSON
Parámetros de encabezado:

Parámetro	Descripción	Formato	Obligatorio
`merchant_id`	Código de la tienda en el 3DS Server. Los códigos de producción y certificación serán diferentes.	< 15 AN	SI
`merchant_key`	Clave de autentificación de la tienda en el 3DS Server. Las claves de producción y certificación serán diferentes.	< 80 AN	SI

Ejemplos#

A continuación, se muestran algunos ejemplos de llamadas al servicio de consultas con la herramienta.cURL.

Requisição: Para usar este ejemplo, no olvide definir la variable {{url}} con el valor
esitef-homologacao.softwareexpress.com.br

curl 
--request GET "https://mpi-homolog.softwareexpress.com.br/3ds-server/v2/transaction/123456789-aaaa-bbbb-cccc-ddddddddddd"
--header "merchant_id: xxxxxxxxxxxxxxx" 
--header "merchant_key: xxxxxxxxxxx"
--verbose

Respuesta:

{
    "three_ds_server": {
        "trans_id": "12345678-1234-1234-1234-123456789012",
        "status": "AUY"
    },
    "brand_id": "2",
    "eci": "05",
    "device_channel": "02",
    "authentication": {
        "value": "1234567890123456789012345678"
    },
     "message_version": "2.2.0"
}

Ejemplo con cancelación de desafío#

A continuación se muestra un ejemplo que utiliza la cancelación de desafío en la respuesta.

Requisição:

curl
--request GET "https://mpi-homolog.softwareexpress.com.br/3ds-server/v2/transaction/123456789-aaaa-bbbb-cccc-ddddddddddd"
--header "merchant_id: xxxxxxxxxxxxxxx" 
--header "merchant_key: xxxxxxxxxxx"
--verbose

Respuesta:

{
    "three_ds_server": {
        "trans_id": "12345678-1234-1234-1234-123456789012",
        "status": "AUY"
    },
    "brand_id": "2",
    "challenge_cancel": "01",
    "eci": "05",
    "device_channel": "02",
    "authentication": {
        "value": "1234567890123456789012345678"
    }, 
     "message_version": "2.2.0"
}

Parámetros de respuesta#

Si tiene éxito, el código de respuesta HTTP será "200". Cualquier otro código debe interpretarse como un error. En la siguiente tabla se muestra la descripción de los parámetros de respuesta del servicio de consulta de transacciones:

Parámetro	Descripción	Formato
`brand_id`	ID de la marca de la tarjeta	< 4 N
`eci`	Indicador de comercio electrónico	< 2 N
`device_channel`	Canal de dispositivo. `01` = aplicación (APP) `02` = navegador (BRW)	< 2 N
`challenge_cancel`	Indicador que informa al ACS y DE que la autenticación ha sido cancelada. 01 = El titular de la tarjeta realizó la cancelación 03 = La transacción ha expirado. Flujo desacoplado 04 = Se agotó el tiempo de espera de la transacción en ACS 05 = Se agotó el tiempo de espera de la transacción en ACS. Primer CReq no recibido por ACS 06 =Error de transacción 08 = Se agotó el tiempo de espera de la transacción en el SDK de 3DS 09 = Mensaje de error en respuesta al mensaje CRes enviado por el ACS 10 = Mensaje de error en respuesta al mensaje CREa enviado por ACS	= 2 AN
`message_version`	Versión de transacción (esta versión debe usarse en la solicitud de CRes)	< 8 AN
three_ds_server
`trans_id`	ID de transacción del 3DS Server	= 35 AN
`status`	Estado en el 3DS Server. [Más información.](/es/docs/e-sitef/3ds-server-codigos-da-api # status-de-transacões-do-3ds-server)	= 3 AN
autenticación
`valor`	Valor de autenticación (CAVV)	< 28 AN
error
`code`	Código de error. Más información.	< 3 N
`componente`	Indica qué componente identificó el error. `C` = 3DS SDK `S` = 3DS Server `D` = DS `A` = ACS	= 1 AN
`description`	Descripción del error	< 2048 AN
`detail`	Detalle del error	< 28 AN

Home

Detalles de la llamada#

Ejemplos#

Ejemplo con cancelación de desafío#

Parámetros de respuesta#