Validação da variável OrderId

Introdução

Devido ao crescimento exponencial do comércio eletrônico e dos pagamentos online, o tamanho dos tokens que retornamos do nosso processador de pagamentos aumentou.

Nossas estimativas mostram que em breve passaremos a barreira de 10 dígitos para o parâmetro orderId. Isso nos faz alterar o tipo numérico atual do parâmetro para permitir um número maior de dígitos nos identificadores retornados; portanto, o tipo de dados atual não será mais suportado e essa alteração pode afetar sua integração com nossa plataforma.

Para evitar problemas devido a essa alteração, você deve verificar se o novo tipo retornado corresponde à sua integração atual. Siga as diretrizes explicadas neste artigo para verificar se sua integração requer uma atualização.

Perguntas frequentes

• Como posso verificar se a alteração do tipo de dados afeta minha integração?
  Veja a seção Procedimento de validação para saber como validar com base no tipo de integração que você tem conosco.

• Minha integração é através de uma plataforma de comércio digital (como VTEX, Shopify, etc), preciso implementar a mudança?
  Não, sua plataforma de comércio digital implementará a mudança silenciosamente. No entanto, você deve verificar se possui conexões externas à plataforma para relatórios ou consultas.

• Qual é a alteração do tipo de dados?
  Atualmente, o parâmetro orderId é retornado usando o tipo Integer, o novo tipo de dados para este parâmetro será Long.

• Essa alteração é necessária?
  Se após verificar sua integração, você descobriu que o orderId é uma variável do tipo Integer, sim. Caso contrário, você não precisa alterar sua integração.

• Essa alteração afeta apenas o fluxo de pagamento?
  Não, essa alteração também pode afetar seus relatórios ou consultas relacionadas a transações. Tenha cuidado ao realizar a validação.

• O que acontece se eu não aplicar essa alteração?
  Se você não fizer essa alteração e isso afetar sua integração, você não poderá receber a confirmação do procedimento de pagamento. Além disso, você não poderá consultar novas transações depois que começarmos a retornar o parâmetro orderId com mais de 10 dígitos.

• A equipe de suporte da PayU pode fazer essa alteração para mim?
  Não, você decide como se integra aos nossos serviços. PayU não se responsabiliza por erros devido a integrações incorretas.

• Essa alteração precisa ser reimplementada?
  Não em um futuro próximo. A alteração do tipo de dados permite-nos ter uma maior capacidade na geração de identificadores. Essa alteração nos permite gerar até 9.223.372.036.854.775.807 tokens.

Procedimento de validação

A validação de orderId depende da sua integração.

Integração API

Se sua loja é integrada por meio da API e você usa uma linguagem tipada para sua integração, você deve validar como declarou a variável numérica orderId.

• Se a variável orderId for do tipo int ou Integer, você deve alterá-la para o tipo long ou Long.
• Se você estiver usando a API de Consultas e estiver mapeando a variável orderId para o tipo int ou Integer, você deve alterá-la para o tipo long ou Long.
• Você deve verificar com sua equipe técnica se a variável orderId está sendo armazenada em um banco de dados. Em caso afirmativo, valide se a coluna em seu banco de dados suporta valores do tipo Long.

Integração SDK

Se você estiver integrando com nossos serviços usando o SDK, altere o arquivo .jar da versão atual.

Faça download do SDK Java 1.4.0

Integração WebCheckout

Se sua loja é integrada por meio do WebCheckout e você usa uma linguagem tipada para sua integração, você deve validar como declarou a variável numérica orderId.

• Se a variável orderId usada na página de confirmação estiver configurada para o tipo int ou Integer, você deve alterá-la para o tipo long ou Long.
• Se você estiver usando a Query API e estiver mapeando a variável orderId para o tipo int ou Integer, você deve alterá-la para o tipo long ou Long.
• Você deve verificar com sua equipe técnica se a variável orderId está sendo armazenada em um banco de dados. Em caso afirmativo, valide se a coluna em seu banco de dados suporta valores do tipo Long.

Suporte

Para solicitar suporte ou fazer perguntas relacionadas a essa alteração, entre em contato com nossa equipe de suporte em seu país: