Integração SDK

Assim como qualquer integração de API, você pode personalizar seu checkout de acordo com as necessidades de sua loja e o cliente permanece em seu site durante o processo de compra e pagamento. Para integrar esta opção, você deve ter uma conta PayU Business e habilidades de programação avançadas.

Você pode acessar vários métodos de pagamento (varia por país), incluindo cartões de crédito, transferências bancárias e pagamentos em dinheiro.

Configurações iniciais

PayU permite que você integre com o portal de transações, ferramentas de pagamento disponíveis e Consultas através da programação de um site em Java ou PHP. É fundamental que os dados confidenciais da transação, como número do cartão de crédito e data de validade, não sejam armazenados. Recomenda-se seguir as Melhores práticas do PCI DSS (Payment Card Industry Data Security Standard).

Java

Para se integrar com a API, o SDK depende da biblioteca do Apache HttpClient que também depende das bibliotecas HttpCore, CommonsLoggin e CommonsCodec.

Em geral, você precisa das seguintes bibliotecas em seu classpath:

• HttpClient-4.4.1.jar
• HttpCore-4.4.4.jar
• Commons-loggin-1.1.1.jar
• Commons-codec-1.6.jar
• Commons-lang3-3.5.jar

Faça download do SDK Java 1.5.0

Antes de realizar qualquer operação com o SDK, você precisa atribuir alguns valores à classe PayU, que se aplica a todas as operações do SDK e deve ser configurada com os dados da sua loja. A tabela a seguir mostra os valores que você precisa configurar.

Exemplo

PayU.apiKey = "xxxxxxxxxxxx"; // Insira aqui sua API key
PayU.apiLogin = "xxxxxxxxxxxx"; // Insira aqui sua API Login
PayU.language = Language.en; // Insira o idioma aqui
PayU.isTest = false; // atribua true se você estiver no modo de teste
LoggerUtil.setLogLevel(Level.ALL); // Inclua-o apenas se desejar ver o rastreamento completo do log. Caso contrário, você pode removê-lo.
PayU.PaymentUrl = "https://api.payulatam.com/payments-api/"; // Inclua se quiser testar em um servidor de pagamento específico e atribuir sua URL.
PayU.reportsUrl = "https://api.payulatam.com/reports-api/"; // Inclua se quiser testar em um servidor de relatório específico e atribuir sua URL.

Para executar as operações fornecidas pelo SDK do PayU, deve-se enviar ao método um mapa de parâmetros como argumento. Este mapa contém todas as informações necessárias para processar uma transação. Exemplo:

Map<String, String>  parameters = new HashMap <String, String>();
parameters.put(PayU.PARAMETERS.TRANSACTION_ID, transactionId);
parameters.put(PayU.PARAMETERS.ORDER_ID, orderId.toString());

Para facilitar o uso, você encontra um conjunto de constantes na interface PayU.PARAMETERS, que contém os nomes dos parâmetros usados nos métodos SDK.

PHP

Para integração com a API, o SDK pode ser executado em máquinas com versão PHP maior ou igual a 5.2.1. Além disso, as seguintes extensões PHP são necessárias em seu servidor:

• curl
• xml
• mbstring
• json

Faça download do SDK PHP 4.5.8

Para ter acesso aos recursos do SDK, você precisa incluir a classe PayU localizada em [PayU-php-sdk-Path]/lib/PayU.php.

<?php
require_once '[PayU-php-sdk-Path]/lib/PayU.php';
..
?>

Antes de realizar qualquer operação com o SDK, você precisa atribuir alguns valores à classe PayU, que se aplica a todas as operações do SDK e deve ser configurada com os dados da sua loja. A tabela a seguir mostra os valores que você precisa configurar.

Exemplo

<?php
PayU::$apiKey = "xxxxxxxxxxxx"; // Insira aqui sua API key
PayU::$apiLogin = "xxxxxxxxxxxx"; // Insira aqui sua API Login
PayU::$merchantId = "1"; // Insira seu Merchant Id aqui
PayU::$language = SupportedLanguages::ES; // Insira o idioma aqui
PayU::$isTest = false; // atribua true se você estiver no modo de teste
..
?>

lém disso, você precisa configurar a API para redirecionar as solicitações usando a classe Environment:

<?php
// Payments URL
Environment::setPaymentsCustomUrl("https://sandbox.api.payulatam.com/payments-api/4.0/service.cgi");
// Reports URL
Environment::setReportsCustomUrl("https://sandbox.api.payulatam.com/reports-api/4.0/service.cgi");
..
?>

Observações

• Você deve ter uma conta PayU ativa.
• Você deve instalar um certificado SSL válido em seu servidor e seu site deve ser capaz de fazer conexões SSL. Por isso, a máquina virtual deve ter extensões de segurança adequadas.
• Temporariamente, não use certificados de segurança de curva elíptica ou que tenham o pacote de criptografia TLS_ECDHE_ECDSA_WITH_RC4_128_SHA em seus ordems de pagamento.
• Você deve ter CGI ou linguagens de servidor como Java, C #, VB, PHP, etc.
• Você deve ser capaz de armazenar suas credenciais de autenticação (API Key e API Login) com segurança.
• A codificação das mensagens deve ser UTF-8.
• As datas devem ter formato yyyy-MM-ddTHH:mm:ss, o formato da hora é 24 horas. Exemplo: 2015-08-22T21:35:12.
• Normalmente a conexão garante tempos de resposta de três segundos em média. Se houver uma situação incomum, o tempo máximo de resposta é de um minuto. É altamente recomendável que você defina timeouts quando se conectar com PayU.
• É importante validar a duração e o número dos cartões de crédito por franquia, juntamente com os códigos de segurança.

Recursos disponíveis