Validación de la variable OrderId

Introducción

Debido al crecimiento exponencial del comercio electrónico y los pagos en línea, el tamaño de los identificadores que devolvemos desde nuestro procesador de pagos se ha incrementado.

Nuestras estimaciones muestran que sobrepasaremos la barrera de los 10 dígitos del parámetro orderId. Esto hace que cambiamos el tipo numérico actual del parámetro para permitir un mayor número de dígitos en los identificadores retornados; por lo tanto, el tipo de datos actual ya no será compatible y este cambio puede afectar tu integración con nuestra plataforma.

Para evitar problemas debido a este cambio, debes validar si el nuevo tipo retornado coincide con tu integración actual. Sigue las pautas explicadas en este artículo para verificar si tu integración requiere una actualización.

Preguntas frecuentes

• ¿Cómo puedo comprobar si el cambio del tipo de datos afecta mi integración?
  Consulta la sección Procedimiento de validación para saber cómo validar según el tipo de integración que tengas con nosotros.

• Mi integración es a través de una plataforma de comercio digital (como VTEX, Shopify, etc), ¿Necesito implementar el cambio?
  No, tu plataforma de comercio digital implementará el cambio de forma silenciosa. Sin embargo, debes verificar si tienes conexiones externas a la plataforma para reportes o consultas.

• ¿Cuál es el cambio en el tipo de datos?
  Actualmente, el parámetro orderId se retorna utilizando el tipo Integer, el nuevo tipo de datos para este parámetro será Long.

• ¿Este cambio es obligatorio?
  Si después de haber verificado tu integración, encontraste que el orderId es una variable de tipo Integer, sí. De lo contrario, no tienes que cambiar tu integración.

• ¿Este cambio solo afecta el flujo de Pago?
  No, este cambio también puede tener impacto en tus reportes o consultas relacionadas con transacciones. Ten cuidado cuando realices la validación.

• ¿Qué sucede si no aplico este cambio?
  Si no realizas este cambio y este afecta tu integración, no podrás recibir la confirmación del procedimiento de pago. Además, no podrás consultar nuevas transacciones a partir de que empecemos a retornar el parámetro orderId con más de 10 dígitos.

• ¿El equipo de Soporte de PayU puede hacer este cambio por mí?
  No, tú decides cómo te integras con nuestros servicios. PayU no se hace responsable por errores debido a integraciones incorrectas.

• ¿Es necesario volver a implementar este cambio?
  No en un futuro cercano. El cambio del tipo de dato nos permite tener una mayor capacidad en la generación de identificadores. Este cambio nos permite generar hasta 9.223.372.036.854.775.807 identificadores.

Procedimiento de validación

La validación de orderId depende de tu integración.

Integración API

Si tu tienda está integrada a través de API y utilizas un lenguaje tipado para tu integración, debes validar cómo declaraste la variable numérica orderId.

• Si la variable orderId es de tipo int o Integer, debes cambiarla a tipo long o Long.
• Si usas el API de consultas y estás mapeando la variable orderId con el tipo int o Integer, debes cambiarlo al tipo long o Long.
• Debes validar con tu equipo técnico si la variable orderId está siendo almacenada en una base de Datos. Si es así, valida que la columna en tu base de datos admita valores de tipo Long.

Integración SDK

Si te estás integrando con nuestros servicios usando el SDK, cambia el archivo .jar de la versión actual.

Descarga el SDK Java 1.4.0

Integración WebCheckout

Si tu tienda está integrada a través de WebCheckout y utilizas un lenguaje tipado para tu integración, debes validar cómo declaraste la variable numérica orderId.

• Si la variable orderId utilizada en la página de confirmación está definida como tipo int o Integer, debe cambiarla al tipo long o Long.
• Si usas el API de consultas y estás mapeando la variable orderId con el tipo int o Integer, debes cambiarlo al tipo long o Long.
• Debes validar con tu equipo técnico si la variable orderId está siendo almacenada en una base de Datos. Si es así, valida que la columna en tu base de datos admita valores de tipo Long.

Soporte

Para solicitar soporte o hacer preguntas relacionadas con este cambio, comunícate con nuestro equipo de soporte en tu país: