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

Guia de Segurança e Conformidade PCI

A segurança nas transações financeiras é essencial para proteger tanto as empresas quanto os consumidores no ambiente digital. Abaixo, exploramos as práticas e normas que ajudam a garantir transações seguras e atender aos padrões de segurança internacionais. Essas medidas não apenas fortalecem a confiança na plataforma, mas também protegem contra ameaças e mitigam riscos econômicos e de reputação.

API de Pagamentos - Argentina

A API de Pagamentos para a Argentina permite que você integre de forma eficiente as capacidades de processamento de pagamentos da PayU na sua plataforma de compras online. Por meio dessa API, as lojas podem oferecer aos seus clientes uma ampla variedade de métodos de pagamento, incluindo dinheiro, cartões de crédito e cartões de débito.

API de Pagamentos - Brasil

A API de Pagamentos para o Brasil permite que você integre de forma eficiente as capacidades de processamento de pagamentos da PayU na sua plataforma de compras online. Por meio dessa API, as lojas podem oferecer aos seus clientes uma ampla variedade de métodos de pagamento, incluindo aplicativos móveis, transferência eletrônica, dinheiro, transferência bancária e cartões de crédito.

API de Pagamentos - Chile

A API de Pagamentos para o Chile permite que você integre de forma eficiente as capacidades de processamento de pagamentos da PayU na sua plataforma de compras online. Por meio dessa API, as lojas podem oferecer aos seus clientes uma ampla variedade de métodos de pagamento, incluindo dinheiro, cartões de crédito, débito ou pré-pagos, e cartões de débito ou pré-pagos através do WebPay Plus.

API de Pagamentos - Colômbia

A API de Pagamentos para a Colômbia permite a integração eficiente das capacidades de processamento de pagamentos da PayU em sua plataforma de compras online. Com esta API, as lojas podem oferecer diferentes métodos de pagamento por meio de cartões de crédito ou débito, carteiras digitais, dinheiro e transferências bancárias.

API de Pagamentos - México

A API de Pagamentos para o México permite que você integre de forma eficiente as capacidades de processamento de pagamentos da PayU na sua plataforma de compras online. Por meio dessa API, as lojas podem oferecer aos seus clientes uma ampla variedade de métodos de pagamento, incluindo dinheiro, cartões de crédito, cartões de débito, transferências bancárias e referências bancárias.

API de pagamentos - Panamá

A API de Pagamentos para o Panamá permite que você integre de forma eficiente as capacidades de processamento de pagamentos da PayU com cartões de crédito na sua plataforma de compras online.

API de Pagamentos - Peru

A API de Pagamentos para o Peru permite que você integre de forma eficiente as capacidades de processamento de pagamentos da PayU na sua plataforma de compras online. Por meio dessa API, as lojas podem oferecer aos seus clientes uma ampla variedade de métodos de pagamento, incluindo aplicativos móveis, dinheiro, cartões de crédito e cartões de débito.

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

Esta ferramenta interativa permite aos desenvolvedores testar e ajustar sua integração com o Google Pay.

Atualmente, o Google Pay está disponível apenas para a API de Pagamentos do Brasil.

Última modificação 8 de novembro de 2024: Documentation updates (cb34649dc)