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).

Você pode conectar sua loja online à plataforma PayU e o processo de checkout será feito em seu site. 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.

API integration

Configurações iniciais

PayU permite que você integre com o portal de transações, ferramentas de pagamento disponíveis e Consultas, programando um cliente HTTPS para enviar as informações da transação através de SSL. É 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).

A transmissão das transações é protegida através de uma conexão TLS (Transport Layer Security) de 256 bits do servidor da loja nosso portal de pagamento. A troca de mensagens é feita por meio de strings JSON ou XML e as operações são diferenciadas por um comando incluído na solicitação. Confira os seguintes exemplos de JSON e XML:


POST /payments-api/4.0/service.cgi HTTP/1.1
Host: sandbox.api.payulatam.com
Content-Tipo: application/json; charset=utf-8
Accept: application/json
Content-Length: length
{
   "test": false,
   "language": "en",
   "command": "GET_PAYMENT_METHODS",
   "merchant": {
      "apiLogin": "xxxxxxxxxxxxx",
      "apiKey": "xxxxxxxxxxxxx"
   }
}

POST /payments-api/4.0/service.cgi HTTP/1.1
Host: sandbox.api.payulatam.com
Content-Tipo: application/json; charset=utf-8
Accept: application/xml
Content-Length: length
<request>
   <language>en</language>
   <command>GET_PAYMENT_METHODS</command>
   <merchant>
      <apiLogin>xxxxxxxxxxxxx</apiLogin>
      <apiKey>xxxxxxxxxxxxx</apiKey>
   </merchant>
   <isTest>false</isTest>
</request>

Você pode definir o idioma que deseja usar na solicitação por meio dos cabeçalhos HTTP Content-type e Accept. Você pode usar todas as combinações possíveis:

CONTENT-TYPE ACCEPT
application/xml application/xml
application/json application/json
application/xml application/json
application/json application/xml

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 suas ordens 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


Tópicos nesta seção

API de pagamentos - Argentina

A API de pagamentos da Argentina permite que sua loja processe diferentes tipos de transações com vários métodos de pagamento.

API de pagamentos - Brasil

A API de pagamentos do Brasil permite que sua loja processe diferentes tipos de transações com vários métodos de pagamento.

API de pagamentos - Chile

A API de pagamentos do Chile permite que sua loja processe diferentes tipos de transações com vários métodos de pagamento.

API de pagamentos - Colômbia

A API de pagamentos da Colômbia permite que sua loja processe diferentes tipos de transações com vários métodos de pagamento.

API de pagamentos - México

A API de pagamentos do México permite que sua loja processe diferentes tipos de transações com vários métodos de pagamento.

API de pagamentos - Panamá

A API de pagamentos do Panamá permite que sua loja processe diferentes tipos de transações com vários métodos de pagamento.

API de pagamentos - Peru

A API de pagamentos do Peru permite que sua loja processe diferentes tipos de transações com vários métodos de pagamento.

API de Consultas

A API de consultas permite verificar o status das ordens feitas e suas transações.

API de Tokenização

API 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.

API de promoções para a Argentina e o México

PO recurso de promoções permite que você consulte as promoções válidas, seus custos associados, características e outras informações relevantes disponíveis para seus clientes. A API de promoções está disponível somente na Argentina e no México (MSI - Meses Sin Intereses).

API de Cancelamentos e Reembolsos

Este recurso permite solicitar o cancelamento ou o reembolso das transações autorizadas ou cobradas. Você pode criar a solicitação de reembolso usando o método Reembolso (Refund) ou Cancelamento (Void) de acordo com o status da transação.

API de Payouts

Este recurso permite que você crie pagamentos múltiplos e seguros para beneficiários (usuários, vendedores, provedores, clientes, etc.) usando os fundos que você tem em sua conta PayU.

Token Simulator

Token Simulator

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