Integrações

De acordo com as necessidades do seu negócio, selecione como integrar sua loja com os serviços e ferramentas PayU.

Implemente o PayU com o modelo agregador ou portal, usando os acordos financeiros do PayU ou os seus. Selecione a integração que melhor se adapta às suas necessidades:

PayU Checkout é uma integração que permite a você coletar pagamentos usando um formulário web PayU de qualquer dispositivo, de forma simples, rápida e segura.

  • PayU gerencia o sistema de pagamento
  • Integração mais fácil e igualmente segura
  • Como PayU gerencia a plataforma de pagamento, é mais fácil obter a certificação PCI DSS

Por meio de integrações API ou SDK, você pode receber pagamentos com segurança, de qualquer lugar que desejar, em seu site ou aplicativo móvel.

  • Crie seu checkout e gerencie o sistema de pagamento do seu site.
  • Acesso a serviços adicionais, como tokenização.

Como obter variáveis para integração

Seja qual for a integração selecionada, você pode exigir qualquer uma das seguintes variáveis na solicitação dos métodos

API key e API Login

  1. Faça login em PayU.com e clique na opção de login localizada na parte superior da página. Se preferir, você pode fazer login https://merchants.payulatam.com/.

  2. Clique Configuração e selecione Configuração técnica.

PrintScreen

  1. Nesta janela, você encontra a API key e a API, que permitem autenticar sua loja durante o procedimento de integração.

PrintScreen

Assinatura de autenticação

A variável signature é utilizada para validar os pagamentos realizados por meio da plataforma, garantindo sua autenticidade. Esta variável é um valor de string criptografado usando algoritmos MD5 ou SHA e segue esta estrutura.

ApiKey~merchantId~referenceCode~tx_value~currency

Vamos criar uma signature usando os seguintes valores de teste:

  • ApiKey: 4Vj8eK4rloUd272L48hsrarnUA
  • merchantId: 508029
  • referenceCode: TestPayU
  • tx_value: 3
  • currency: USD

String são esses valores concatenados com o caractere til (~):

4Vj8eK4rloUd272L48hsrarnUA~508029~TestPayU~3~USD

Depois de aplicar o algoritmo MD5, o valor da signature é:

ba9ffa71559580175585e45ce70b6c37

deviceSessionId variável

O deviceSessionId é um código com as informações do dispositivo onde a transação foi gerada e fornece um identificador exclusivo para o dispositivo. Essa variável nos permite identificar invasores.

  1. Para realizar a integração de API ou SDK, você precisa incluir o seguinte script em seu formulário de pagamento:
<script type="text/javascript" src="https://maf.pagosonline.net/ws/fp/tags.js?id=${deviceSessionId}80200"></script>
<noscript>
   <iframe style="width: 100px; height: 100px; border: 0; position: absolute; top: -5000px;" src="https://maf.pagosonline.net/ws/fp/tags.js?id=${deviceSessionId}80200"></iframe>
</noscript>

  1. É importante gerar o deviceSessionId por cada transação. Para gerar o deviceSessionId pegue o session_id do cookie e concatene-o com o carimbo de data/hora atual incluindo os milissegundos. Em seguida, criptografe o resultado usando MD5.

Exemplo em PHP

$deviceSessionId = md5(session_id().microtime())

Por exemplo, se o $deviceSessionId é d66f949f19b33e88c202b579cfc549b3, o script é o seguinte:

<script type="text/javascript" src="https://maf.pagosonline.net/ws/fp/tags.js?id=d66f949f19b33e88c202b579cfc549b380200"></script>
<noscript>
	<iframe style="width: 100px; height: 100px; border: 0; position: absolute; top: -5000px;" src="https://maf.pagosonline.net/ws/fp/tags.js?id=d66f949f19b33e88c202b579cfc549b380200"></iframe>
</noscript>

  1. Finalmente, você deve enviar o $deviceSessionId na variável de acordo com a integração selecionada
  • Para API: transaction.deviceSessionId
  • Para SDK JAVA: PayU.PARAMETERS.DEVICE_SESSION_ID
  • Para SDK PHP: PayUParameters::DEVICE_SESSION_ID

Tópicos nesta seção

Integração Webcheckout

A Integração WebCheckout permite que seus clientes selecionem os itens que desejam adquirir em sua loja e realizem o pagamento em nossa plataforma de pagamento (WebCheckout).

Integração API

A integração API do PayU permite que sua empresa processe transações de diferentes tipos de aplicativos (site, móvel, IVR etc).

Integração SDK

O kit de desenvolvimento de software (Software Development Kit - SDK) do PayU oferece uma solução simples para uma integração complexa.

Última modificação 24 de junho de 2022: clon issue (d73e43fe5)