SDK de Pagamentos - Argentina
SDK de Pagamentos da Argentina permite que sua loja processe diferentes tipos de transações com vários métodos de pagamento.
Nesta página
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.
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).
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:
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.
Parâmetro name | Tamanho | Tipo | Obrigatório | Descrição |
---|---|---|---|---|
language |
2 | Language | Sim | O idioma usado para mensagens de erro no sistema e nos e-mails que são enviados ao comprador e ao vendedor. Atualmente é compatível com en en (inglês), es (Spanish) and pt (português). |
isTest |
boolean | Sim | Atribuir true se for um pedido de teste. Caso contrário, atribua false . Dependendo do tipo de transação ou operação, o comportamento pode variar de acordo com o valor deste campo. |
|
apiLogin |
Mín:12 Máx:32 | String | Sim | Sua API Login. Como faço para obter minha API Login |
apiKey |
Mín:6 Máx:32 | String | Sim | Sua API key. Como faço para obter minha API key |
merchantId |
String | Não | O identificador do vendedor, é usado para gerar as assinaturas para verificar as transações de pagamento. Este parâmetro é obrigatório quando you want to check the transaction, unless you send the signature. |
|
paymentsUrl |
Mín:1 | String | Não | A URL da página para a qual você enviará as solicitações relacionadas a pagamentos. Por padrão, este parâmetro leva a URL de produção. |
reportsUrl |
Mín:1 | String | Não | A URL da página para onde você enviará as solicitações relacionadas aos relatórios. Por padrão, este parâmetro leva a URL de produção. |
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.
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:
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.
Parâmetro name | Tamanho | Tipo | Obrigatório | Descrição |
---|---|---|---|---|
PayU::$language |
2 | Language | Sim | O idioma usado para mensagens de erro no sistema e nos e-mails que são enviados ao comprador e ao vendedor. Atualmente é compatível com en en (inglês), es (Spanish) and pt (português). |
PayU::$isTest |
boolean | Sim | Atribuir true se for um pedido de teste. Caso contrário, atribua false . Dependendo do tipo de transação ou operação, o comportamento pode variar de acordo com o valor deste campo. |
|
PayU::$apiLogin |
Mín:12 Máx:32 | String | Sim | Seu API Login. Como faço para obter minha API Login |
PayU::$apiKey |
Mín:6 Máx:32 | String | Sim | Sua API key. Como faço para obter minha API key |
PayU::$merchantId |
String | Não | O identificador do vendedor, é usado para gerar as assinaturas para verificar as transações de pagamento. Este parâmetro é obrigatório quando you want to check the transaction, unless you send the signature. |
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");
..
?>
TLS_ECDHE_ECDSA_WITH_RC4_128_SHA
em seus ordems de pagamento.UTF-8
.yyyy-MM-ddTHH:mm:ss
, o formato da hora é 24 horas. Exemplo: 2015-08-22T21:35:12
.SDK de Pagamentos da Argentina permite que sua loja processe diferentes tipos de transações com vários métodos de pagamento.
SDK de Pagamentos do Brasil permite que sua loja processe diferentes tipos de transações com vários métodos de pagamento.
SDK de Pagamentos do Chile permite que sua loja processe diferentes tipos de transações com vários métodos de pagamento.
SDK de Pagamentos da Colômbia permite que sua loja processe diferentes tipos de transações com vários métodos de pagamento.
SDK de Pagamentos do México permite que sua loja processe diferentes tipos de transações com vários métodos de pagamento.
SDK de Pagamentos do Peru permite que sua loja processe diferentes tipos de transações com vários métodos de pagamento.
O SDK de consultas permite verificar o status das ordens feitas e suas transações.
SDK de Tokenização permite armazenar com segurança os dados dos cartões de crédito de seus clientes por meio da criação de um token. Este token permite fazer cobranças regulares ou implementar o recurso de pagamento em 1 clique, seguindo os padrões de segurança PCI DSS (Payment Card Industry Data Security Standard) para gerenciar dados de cartão de crédito.
This feature allows you to request the cancellation ou the refund of the transactions authorized ou charged. You can create the refund request using the Refund ou Void method according to the status da transação.