Respuesta OrderTransactions

Transacciones vinculadas a una referencia de pedido (orderId). Atención, como singularidad de orderIdes responsabilidad del vendedor, es posible que la lista de transacciones corresponda a dos pedidos.

Referencia de la respuesta

Referencia de pedido definida por el vendedor. No admite los caracteres UTF-8.

Formato

Identificación de la tienda.

Formato

Monto del pago en su fracción monetaria más pequeña (el céntimo para el sol peruano).

Ejemplo: 30050 para 300,50 PEN.

Formato

Fecha y hora de registro de la transacción.

Formato

Moneda del pago. Código alfabético un mayúsculas según ISO 4217 alpha-3.

Ejemplo: Ej: "PEN" para el sol peruano.

Formato

Valores posibles

. Los valores posibles son:

Identificador del comprador en el sitio web comercial.

Formato

E-mail del comprador.

• Especificaciones de la estructura del correo electrónico: RFC-2822

Formato

Dirección de facturación.

Atención: Los caracteres > y < no están permitidos.

Formato

Información adicional sobre la dirección de facturación.

Atención: Los caracteres > y < no están permitidos.

Formato

Tipo de cliente.

Formato

Valores posibles

Teléfono móvil del comprador.

Acepta todos los formatos:

Ejemplos:

• 0623456789
• +33623456789
• 0033623456789
• (+34) 824 65 43 21
• 87 77 12 34

Formato

Ciudad de facturación.

Formato

País del comprador (en letras mayúsculas, según la norma ISO 3166-1 alfa-2).

Formato

Valores posibles

Ejemplos de valores posibles:

Barrio de la dirección de facturación.

Formato

Nombre del comprador.

Formato

Identificación nacional. Identifica de manera única a cada ciudadano en un país.

Formato

Tipo del documento de identidad.

Valores posibles:

Formato

Código del idioma del comprador según la norma ISO 639-1.

Permite especificar el idioma en el que se envían los e-mails de confirmación de pago.

Formato

Valores posibles

Ejemplos de valores posibles:

Nombre del comprador.

Formato

Razón social.

Formato

Número de teléfono del comprador.

Acepta todos los formatos:

Ejemplos:

• 0123456789
• +33123456789
• 0033123456789
• (00.571) 638.14.00
• 40 41 42 42

Formato

Región (estado) de la dirección de facturación. Es recomendable pero no obligatorio transmitir el valor ISO-3166-2.

Formato

Número de calle de la dirección de facturación.

Carácteres aceptados:

• Caracteres alfabéticos (de la "A" a la "Z" y desde la "a" hasta la "z")
• Espacio

Formato

Tratamiento del comprador.

Ejemplos:

• Sr.
• Sr.
• Sra.

Formato

Código postal de la dirección de facturación.

Formato

Dirección de entrega.

Atención: Los caracteres > y < no están permitidos.

Formato

Segunda línea de la dirección de facturación.

Atención: Los caracteres > y < no están permitidos.

Formato

Tipo de cliente.

Formato

Valores posibles

Ciudad de entrega.

Formato

País de entrega (en letras mayúsculas, según la norma ISO 3166-1 alfa-2).

Formato

Valores posibles

Ejemplos de valores posibles:

Nombre de la empresa emisora del producto.

Formato

Barrio de la dirección de facturación.

Formato

Nombre del destinatario.

Formato

Identificación nacional. Identifica de manera única a cada ciudadano en un país.

Formato

Nombre del comprador.

Formato

Razón social en caso de entrega a una empresa.

Formato

Número de teléfono del comprador.

Acepta todos los formatos:

Ejemplos:

• 0123456789
• +33123456789
• 0033123456789
• (00.571) 638.14.00
• 40 41 42 42

Formato

Modo de entrega.

Formato

Valores posibles

Plazo de entrega.

Formato

Valores posibles

Ejemplos de valores posibles:

Región de la dirección de facturación.

Formato

Número de calle de la dirección de facturación.

Carácteres aceptados:

• Caracteres alfabéticos (de la "A" a la "Z" y desde la "a" hasta la "z")
• Espacio

Formato

Código postal de la dirección de facturación.

Formato

Dirección IP del comprador.

Formato

Formato

Encabezado “User-Agent” del navegador del comprador (HTTP/1.1 - RFC. 2616).

Formato

Encabezado “Accept” del navegador del comprador (HTTP/1.1 - RFC. 2616).

Formato

Monto del seguro para todo el pedido expresado en su fracción monetaria más pequeña (el céntimo para el sol peruano).

Ejemplo: 30050 para 300,50 PEN.

Formato

Monto de los gastos de envío de todo el pedido expresado en su unidad monetaria más pequeña (el céntimo para el suelo peruano).

Ejemplo: 30050 para 300,50 PEN.

Formato

Monto de los impuestos de todo el orden expresado en su unidad monetaria más pequeña (el céntimo para el sol peruano).

Ejemplo: 30050 para 300,50 PEN.

Formato

cardItemInfo es una lista que contiene objetos Customer/ShoppingCartItemInfo.

Permite describir cada artículo del carrito.

Formato

Cantidad del producto expresada en su unidad monetaria más pequeña (el céntimo para el sol peruano).

Ejemplo: 30050 para 300,50 PEN.

Formato

Nombre del producto.

Formato

Cantidad de producto.

Formato

Referencia del producto.

Formato

Tipo de producto.

Valores posibles

Formato

Tipo de producto.

Monto del impuesto sobre el producto (en la unidad más pequeña de la moneda).

Valores posibles

Para expresar un porcentaje aplicado al monto del producto en cuestión, el valor debe tener un máximo de 4 dígitos después del punto decimal. El decimal es obligatorio para expresar un porcentaje. La posición decimal está marcada por el carácter ".".

Formato

Código de error detallado devuelto por el adquirente, sin filtro ni modificación.

Consulte Lista de códigos de retorno de autorización Para más información.

Formato

Mensaje de error detallado devuelto por la aplicación de pago sin filtro.

Contiene información contextual para ayudar a entender el error.

El valor de este campo puede establecerse en null cuando errorCode es ACQ_001.

Consulte la descripción del campo detailedErrorCode para conocer el motivo del rechazo de la autorización.

Formato

El parámetro "detailedStatus" proporciona información detallada sobre el estado del pago. Cada uno de los estados es específico a los medios de pago utilizados.

Valores posibles

. Los valores posibles son:

Para más información sobre el ciclo de vida de una transacción, consulte: Ciclo de vida de una transacción

Formato

Para más información sobre el ciclo de vida de una transacción, consulte: Ciclo de vida de una transacción

Formato

Indica si el titular se ha autentificado correctamente durante el pago.

Valores posibles

. Los valores posibles son:

Formato

Código de error. Vea Códigos de error Para más información.

Formato

Mensaje de error. Vea Códigos de error Para más información.

Formato

Valores personalizados adjuntos a la transacción, en formato json.

Ejemplo de llamada

Por ejemplo, para transmitir un valor personalizado, agregue a su solicitud:

{
    "metadata": {
        "MyValueKey": "1234"
    }
}

Este valor se devolverá en el objeto de transacción recién creado.

También puede utilizar los metadatos " orderInfo ", " orderInfo2 " y " orderInfo3 " para transmitir la información adicional sobre el pedido.

Estos datos se muestran en el Back Office Vendedor, en la información de la transacción (pestaña Extra ).

Formato

Transmitir los datos para el análisis de riesgos

Las transacciones se someten sistemáticamente a un análisis de riesgo para determinar si se necesita una autentificación 3D-Secure o si presentan un riesgo demasiado elevado para aceptarlas. Para que el análisis sea lo más pertinente posible, usted debe transmitir un máximo de informaciones en su formulario de pago.

Para detallar el análisis, usted puede utilizar los campos descritos a continuación. Se devuelven estos campos en la notificación de fin de pago.

Para ilustrar, aquí hay un ejemplo con el número de teléfono : cybersource_mdd_13.

{
  "amount": 180,
  "currency": "PEN",
  "customer": {
    "email": "[sample@example.com|mailto:sample@example.com]"
  },
  "metadata": {
    "cybersource_mdd_13": "0606060606"
  },
  "orderId": "myOrderId-417842"
}

Valores posibles

Los valores posibles son:

Tipo de operación.

Valores posibles

. Los valores posibles son:

Formato

Referencia única de la transacción generada por la plataforma de pago.

Formato

Token asociado a un medio de pago.

Formato

Tipo de medio de pago. Ejemplo: PAYCONIQ

Formato

Identificación de la tienda.

Formato

Estado simplificado de la transacción. Es común para todos los medios de pago. Le permite implementar un código genérico compatible con todos los medios de pago.

Cada modo de pago tiene estados asignados. Ver la propiedad detailedStatus para más información.

Valores posibles

. Los valores posibles son:

Para más información sobre el ciclo de vida de una transacción, consulte: Ciclo de vida de una transacción

Formato

Define si el pago está garantizado.

Valores posibles

. Los valores posibles son:

Formato

Número de contrato del vendedor. Si este campo es completado, asegúrese de utilizar el contrato correcto en función de la red de la tarjeta.

Un contrato de VISANET no puede utilizarse para una transacción de MASTERCARD.

Formato

Monto original de la transacción en caso de conversión de moneda.

Formato

Número de secuencia de la transacción.

Formato

Divisa original de la transacción en caso de conversión de divisa.

Formato

Especifica el proceso que ha iniciado la transacción.

Valores posibles

. Los valores posibles son:

Formato

UUID de la transacción fuente.

Formato

Origen del pago.

Formato

Valores posibles

. Los valores posibles son:

Modo de validación de la transacción.

Formato

Valores posibles

. Los valores posibles son:

Fecha de la captura bancario expresada en formato ISO 8601 definida por W3C.

Formato

Marca de la tarjeta.

Formato

Número de tarjeta truncado.

Formato

Mes de expiración en 2 dígitos. Ejemplo: "09" por septiembre.

Formato

Año de expiración en 2 dígitos. Ejemplo: "25" por 2025.

Formato

Código de país de la tarjeta.

Formato

Código bancario asociado al banco emisor.

Formato

Nombre del banco asociado al banco emisor.

Formato

Código de producto de la tarjeta utilizada para el pago.

Formato

Permite caracterizar el modo de medio de pago utilizado.

Valores posibles

. Los valores posibles son:

Formato

Identificador de la transacción en 6 caracteres.

Formato

Nombre completo del titular de la tarjeta

Formato

Tipo del documento de identidad.

Valores posibles:

Formato

Número del documento de identidad del comprador.

El formato depende del tipo de documento de identidad: entre 7 y 13 caracteres, números, letras y/o puntos.

En América Latina, este parámetro puede ser obligatorio para algunos adquirentes.

Formato

Fecha y hora de recepción de la solicitud de pago. Utilizada para encontrar las transacciones de id con formato antiguo.

Formato

Categoría del producto de la tarjeta.

El valor proviene de los archivos de rango BIN.

Valores posibles

Formato

Naturaleza de la tarjeta.

Campo vacío si no ha sido facilitado por el adquirente.

Valores posibles

Formato

Monto de la autorización.

Formato

Código de la moneda utilizada en la solicitud de autorización.

Formato

Fecha y hora de la solicitud de autorización.

Formato

Número de la solicitud de autorización.

Formato

Código de retorno de la solicitud de autorización.

Consulte Lista de códigos de retorno de autorización Para más información.

Formato

Especifica cómo realizar la solicitud de autorización.

Valores posibles

Cuando "authorizationMode" está establecido en MARK : Se realizó una autorización de para verificar la validez de la tarjeta. Este caso se presenta cuando la fecha de depósito supera el periodo de validez de una autorización (7 días para VISA / MasterCard / CB / AMEX en Francia por ejemplo).

Formato

Monto de la preautorización.

Formato

Código de la moneda utilizada durante la solicitud de preautorización.

Formato

Fecha y hora de la solicitud de preautorización.

Formato

Número de la solicitud de preautorización.

Formato

Código de retorno de la solicitud de preautorización.

Formato

Fecha y hora de la captura.

Formato

Número de captura.

Formato

Monte reembolsado.

Formato

Moneda del monte reembolsado.

Formato

Formato

Formato

Estado de la autentificación 3-D Secure.

Valores posibles

Estado de la autentificación del titular.

Formato

Estado de registro del titular.

Valores posibles

. Los valores posibles son:

Formato

Estado de la autentificación del titular.

Valores posibles

Estado de la autentificación del titular.

Formato

Indicador de comercio electrónico.

Valores posibles

El valor ECI es función del estado de autentificación 3DS y del tipo de tarjeta. Los valores posibles son:

Formato

Identificador único de la transacción.

Formato

Algoritmo de verificación de la autentificación del titular.

Valores posibles

. Los valores posibles son:

Formato

Cardholder Authentication Verification Value.

Formato

Validez de la firma del mensaje PaRes.

Valores posibles

Estado de la autentificación del titular.

Formato

Marca de la tarjeta.

Formato

ID único de autentificación, en formato UUID.

Formato

Identificador único para la sesión de autentificación.

Formato

Tipo de instrucción a realizar.

Formato

Valores posibles

Nombre de la instrucción.

Valores posibles

Formato

Tipo de respuesta recibida. La interpretación del resto de la respuesta depende de este atributo.

Valores posibles

Formato

Tiempo máximo de espera para la respuesta al ejecutar una instrucción, expresada en segundos. Más allá de este tiempo, es conveniente forzar el retorno al servidor de la plataforma de pago para obtener el resultado final.

Formato

Método (verbo) utilizado para la solicitud.

Valores posibles

Formato

Url para presentar en el formulario http.

Formato

Lista de parámetros del cuerpo de la solicitud, en forma de "nombre": Valor.

Formato

Lista de encabezados de la solicitud http, en forma de "nombre": Valor

Formato

Tipo de elemento destino html en el que se materializará la instrucción.

Valores posibles

Formato

Altura del objetivo html en píxeles.

Formato

Booleano indicando si el objetivo html debe ser visible o no.

Formato

Altura del objetivo html en píxeles.

Formato

Campo técnico para uso interno, que permite mostrar u ocultar la URL del ACS.

Formato

Indica si el vendedor solicita un "challenge" o no.

Valores posibles

Formato

Nombre del protocolo de autentificación del titular de la tarjeta.

Valores posibles

Formato

Booleano que indica si la autentificación debe realizarse en modo de simulación. Si establece el valor de este campo obligatorio en:

• true, se activa el modo de simulación.
• false, no se activa el modo simulación.

El modo de simulación permite lograr una integración comercial sin estar en producción, ni utilizar tarjetas reales.

Formato

Red en la que se autentificó el medio de pago.

Redes compatibles actualmente

Formato

Versión del protocolo de autentificación del titular de la tarjeta.

Versiones actualmente soportadas

Formato

El tipo de autentificación que tuvo lugar.

Valores posibles

Formato

El indicador de comercio, llamado ECI (Electronic Commerce Indicator) para el protocolo 3DS. Indicador devuelto por el ACS para indicar los resultados del intento de autentificación del titular de la tarjeta.

En caso de autentificación sin pago (registro de una tarjeta) Mastercard puede devolver estos 2 valores:

Formato

El estado de autentificación, es decir, el resultado positivo/negativo de la autentificación.

Valores posibles

Formato

El tipo de autentificación que tuvo lugar.

Valores posibles

Formato

Valor del identificador de la transacción de autenticación conocida por la red bancaria.

La longitud del campo varía según el protocolo de autentificación.

Formato

Tipo del valor de autentificación.

Valores posibles

Formato

Valor de autentificación final (según el DS, este valor puede denominarse CAVV, AEVV o AAV). Cadena de caracteres codificada en base 64 con un tamaño de 28 caracteres.

Formato

Tipo de extensión del resultado.

Formato

Valores posibles

Identifiant de transaction de l'ACS. Ce champ concerne uniquement le réseau CB. Voir : Guide d'intégration

Formato

Puntaje CB como se define en la extensión CB del mensaje ARES

Formato

Código del algoritmo utilizado para generar el Valor de autentificación (utilizado durante la autorización)

Valores posibles

Formato

Código adicional informativo sobre el origen del resultado. Ejemplo: DS_TIMEOUT

Formato

Mensaje adicional que proporciona información sobre el origen del resultado.

Formato

Cantidad de cuotas.

Formato

Código de la opción de pago utilizada para el pago.

Formato

Identificador de la recurrencia.

Formato

Nombre del control aplicado en el marco de la gestión de riesgos.

Valores posibles

. Los valores posibles son:

Formato

Nombre del control aplicado en el marco de la gestión de riesgos.

Valores posibles

Resultado del control de riesgo.

Formato

Identificador del análisis para el analizador de riesgo.

Formato

Código de retorno de un analizador de riesgo externo.

Valores posibles

. Los valores posibles son:

Formato

Código de retorno de un analizador de riesgo externo.

Estado del análisis de riesgo.

Valores posibles

. Los valores posibles son:

Formato

Identificador del análisis para el analizador de riesgo.

Formato

Específico de CyberSource. Códigos de retorno del DecisionManager.

Formato

Este campo lo utilizan los vendedores que implementan el analizador de riesgos en su página de pago. Permite transmitir el identificador de la sesión (o fingerPrint Id) a la plataforma de pago para finalizar el análisis de riesgo.

Los analizadores compatibles son:

• NOTO
• Cybersource
• MonitorPlus
• ClearSale

Puede contener mayúsculas, minúsculas, números o guiones ([AZ] [az], 0-9, _, -).

Formato

Lista de acciones realizadas en la transacción, tras la aplicación de las reglas de gestión de riesgo avanzadas activadas en la tienda.

Los valores posibles dependen de las opciones de las tiendas.

Valores posibles

. Los valores posibles son:

Formato

Usado por ciertos medios de pago en América Latina. permite transmitir el tipo de impuesto aplicado a todo el pedido. El valor debe ser el porcentaje a aplicar (21 para 21 %).

Formato

Monto de los impuestos de todo el orden expresado en su unidad monetaria más pequeña (el céntimo para el sol peruano).

Ejemplo: 30050 para 300,50 PEN.

Formato

Permite definir el monto sin impuestos de todo el pedido.

El valor debe expresarse en la fracción monetaria más pequeña de la moneda.

Formato

Referencia externa de la transacción.

Formato

Monto de la transacción expresado en la unidad más pequeña de la moneda elegida por dccCurrency (el céntimo para el euro).

Este campo solo se valora si la tarjeta es elegible para el servicio de conversión dinámica de moneda (DCC) y el comprador ha elegido pagar en la moneda de su tarjeta.

La tasa de conversión se devuelve en el campo vads_change_rate.

Formato

Código numérico según la norma ISO 4217 de la moneda elegida por el comprador cuando la tarjeta es válida para el servicio de conversión dinámica de moneda (DCC).

Este campo solo se valora si la tarjeta es elegible para el servicio de conversión dinámica de moneda (DCC) y el comprador ha elegido pagar en la moneda de su tarjeta.

La tasa de conversión se devuelve en el campo vads_change_rate.

Formato

Tasa de cambio utilizada para calcular el monto real del pago.

Formato

Indica el porcentaje (o tasa) de margen comercial sobre el importe total.

Este campo solo se valora si la tarjeta es elegible para el servicio de conversión dinámica de moneda (DCC) y el comprador ha elegido pagar en la moneda de su tarjeta.

Ejemplo: "3.5" para una tasa de margen de 3.5%.

Formato

Fecha y hora UTC de la obtención de la tasa de conversión ante el servicio de conversión dinámica de moneda (DCC).

Este campo solo se valora si la tarjeta es elegible para el servicio de conversión dinámica de moneda (DCC) y el comprador ha elegido pagar en la moneda de su tarjeta.

La tasa de conversión se devuelve en el campo vads_change_rate.

Formato

Referencia de pago que aparece en el cupón de pago.

Utilizado principalmente por el medio de pago Multibanco.

Formato

ID de la entidad para la que se ha realizado el pago.

Utilizado principalmente por el medio de pago Multibanco.

Formato

Número de secuencia único (América Latina).

Formato

Terminal ID. Identificador del punto de venta definido en la afilación de aceptación.

Este campo solo se utiliza en Colombia para elegir entre REDEBAN y CREDIBANCO.

Formato

Código de la red del adquirente.

Valores posibles:

Formato

Utilisé en Uruguay, ce champ correspond au montant du crédit d'impôt accordé au marchand pour la transaction. La valeur est exprimée dans la plus petite unité monétaire (le centime pour le sol péruvien).

Ejemplo: 30050 para 300,50 PEN.

Formato

Permite identificar si la transacción es parte de una serie de pagos (suscripción o pago en N cuotas).

útil para identificar de forma precisa el primer pago de una serie.

Con la aplicación del soft decline, la plataforma de pago realiza automáticamente un nuevo intento de pago con autentificación 3-D Secure cuando es posible. Esto modifica el número de secuencia de pago. El campo sequenceNumber ya no facilita la identificación del primer pago de una serie.

Valores posibles

Formato

Referencia generada por la plataforma de pago y transmitida al adquirente para el procesamiento de las capturas y la conciliación de las transacciones.

Establecido únicamente para los pagos CB, AMEX y PAYPAL.

Formato

Monto original de la transacción en caso de conversión de moneda.

Formato

Permite definir el modo en el cual se ha creado el pedido.

Valores posibles

. Los valores posibles son:

Formato

Código de la moneda del pedido en formato 4217 alpha-3.

Ejemplo: Ej: "PEN" para el sol peruano.

Formato

Referencia de pedido definida por el vendedor. No admite los caracteres UTF-8.

Formato

Monto total del pedido expresado en su fracción monetaria más pequeña (el céntimo para el sol peruano).

Ejemplo: 30050 para 300,50 PEN.

Formato