Placetopay Docs

A NOTICE

Since this page is not yet available in English, you will see it in Spanish.

Este es el servicio para obtener información de una transacción que utilizó el flujo de autenticación del tarjetahabiente con el 3DS Server.

Los siguientes pasos le darán una guía para la utilización del mismo:

1. Cree una solicitud HTTP de tipo GET en su servidor y con el endpoint /api/v2x/transactions/transactionID

2. Adjunte al final de la url, como parámetro, el identificador de la transacción, el cual corresponde al campo transactionID que se obtiene en la respuesta del servicio con el endpoint api/threeds/v2x/sessions

3. En el encabezado de la petición, ingrese el Bearer token, el cual puede crear dirigiéndose al comercio y luego a la sección de Tokens. Este le permitirá registrarse como un usuario autorizado y es obligatorio.

4. El encabezado deberá contener también, en el Content-Type, el valor de "application/json".

5. Esta petición no requiere que se pasen datos en el cuerpo de la misma.

6. Envíe la petición y obtenga una respuesta.

La descripción de los campos de la respuesta, el tipo de dato, longitud y demás especificaciones, puede visualizarse en el apartado de respuestas, en el esquema de datos.

Ver más detalle en Valores devueltos en la respuesta API

GET/v2x/transactions/{transactionID}

Consultar una transacción

Este endpoint te permite obtener la información de una transacción específica.

Params

Name
transactionID
Type
transactionID
is Required
REQUIRED
Description
Identificador de la transacción obtenido en la respuesta del endpoint api/threeds/v2x/sessions

Solicitud

GET

/v2x/transactions/{transactionID}

curl -X "GET" https://3dss-test.placetopay.com/v2x/transactions/9099 \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "Accept: application/json"

Response

Respuesta recibida: 200 Ok Esta es una respuesta satisfactoria para el servicio de consulta de información de transacciones.

Name
enrolled
Type
string
is Required
REQUIRED
Description
Indica si la tarjeta con la cual se realizó la transacción está enrolada (está registrada en los rangos de tarjeta para el emisor específico).
Allowed values:YN
Example:Y
Name
transStatus
Type
string
is Required
REQUIRED
Description
Indicador del estado de autenticación de una transacción.
Allowed values:YNUACR
Example:Y
Max length:1
Min length:1
Name
transStatusReason
Type
string
is optional
Description
Proporciona información sobre por qué el campo Estado de la transacción (transStatus) tiene el valor especificado.
Allowed values:010203040506070809101112131415161718192021
Max length:2
Min length:2
Nullable:Yes
Name
eci
Type
string
is Required
REQUIRED
Description
Indicador del resultado de la autenticación generado por el comercio electrónico.
Example:07
Max length:2
Min length:2
Name
acsTransID
Type
string
is Required
REQUIRED
Description
Identificador único de transacción generado por el ACS.
Example:c83f3f5d-1a47-4eff-9fd0-6b63090a89c6
Format:uuid
Max length:36
Min length:36
Name
dsTransID
Type
string
is Required
REQUIRED
Description
Identificador único de transacción generado por el DS.
Example:c83f3f5d-1a47-4eff-9fd0-6b63090a89c6
Format:uuid
Max length:36
Min length:36
Name
threeDSServerTransID
Type
string
is Required
REQUIRED
Description
Identificador único de transacción generado por el 3DS Server.
Example:c83f3f5d-1a47-4eff-9fd0-6b63090a89c6
Format:uuid
Max length:36
Min length:36
Name
sdkTransID
Type
string
is optional
Description
Identificador de transacción único universal asignado por 3DS SDK para identificar una transacción.
Example:569c905d-b7cc-4f46-aad9-d6bedadbd2fc
Format:uuid
Max length:36
Min length:36
Name
authenticationValue
Type
string
is optional
Description
Valor de autenticación para la franquicia generado por el ACS. Este valor se debe pasar en el proceso de autorización a la red financiera.
Example:AJkBABIWcQAAAAM5FwIzdGiYeHM=
Max length:28
Min length:28
Name
messageVersion
Type
string
is Required
REQUIRED
Description
Es el número de versión del protocolo 3DS que utiliza el sistema para ejecutar el flujo de autenticación. Esta versión la establece el servidor 3DS con el mensaje AReq y no cambia durante todo el flujo de una transacción.
Allowed values:2.2.0
Example:2.2.0
Max length:8
Min length:5
Name
messageCategory
Type
string
is Required
REQUIRED
Description
Indica la categoria del mensaje.
Allowed values:PA - 'Payment (01-PA)'NPA - 'Non-Payment (02-NPA)'
Example:2
Max length:2
Min length:2
Name
authMethod
Type
string
is Required
REQUIRED
Description
Indica si la transacción tuvo o no desafío.
Allowed values:FRICTIONLESS_AUTHENTICATION (01)CARDHOLDER_CHALLENGE_OCCURRED (02)AVS_VERIFIED (03)OTHER_ISSUER_METHODS (04)
Example:2
Max length:2
Min length:2
Name
authTimestamp
Type
string
is Required
REQUIRED
Description
Indica el timestamp de la autenticacion.
Example:2020-04-21T01:44:54.000Z
Max length:30
Name
authInd
Type
string
is Required
REQUIRED
Description
Define el tipo de autenticación aplicada según el canal utilizado.
Example:RECURRING_TRANSACTION
Name
deviceChannel
Type
string
is optional
Description
Canal a través del cual se realiza la transacción.
Example:BRW
Name
challengeInd
Type
string
is optional
Description
Indicador de desafío del solicitante 3DS.
Example:NO_PREFERENCE

Respuesta

{
   "transStatus":"Y",
   "transStatusReason":null,
   "eci":"05",
   "acsTransID":"bdce535e-6811-43c2-a569-5cb0cd7b7738",
   "dsTransID":"fd1be924-1f02-4b62-8f23-c211f84413e1",
   "threeDSServerTransID":"1ed95a50eee5-48a8-91fa-6a1ee6378dba",
   "sdkTransID":null,
   "authenticationValue":"AJkBAmBANQAAACcPhAI0dAJBQVk=",
   "messageVersion":"2.2.0",
   "authMethod":"FRICTIONLESS_AUTHENTICATION",
   "authTimestamp":"2020-04-21T01:44:54+00:00",
   "enrolled":null,
   "messageCategory":"PA",
   "authInd": "PAYMENT_TRANSACTION",
   "deviceChannel":"BRW",
   "challengeInd": "NO_PREFERENCE"
}

Importante: Vea con mas detalle los Valores devueltos en la respuesta API