osCommerce

Este artigo mostra o procedimento para habilitar PayU em seu site osCommerce.

O osCommerce é uma plataforma desenvolvida em PHP que facilita a criação de uma loja online. Para permitir que seus clientes paguem com PayU de seu site, você precisa instalar o plugin para osCommerce, que integra PayU Latam como um portal de pagamento válido. Para obter mais informações sobre osCommerce, consulte o site oficial.

Pré-requisitos

  • Você precisa de uma conta ativa no PayU Latam.
  • Ter instalado osCommerce version 2.3.
  • Ter o plugin osCommerce do PayU baixado e armazenado em local acessível. Clique aqui para fazer o download.

Instalação

Siga o próximo procedimento para instalar o plugin em seu site.

  1. Descompacte o arquivo do plugin em um local de sua escolha. A partir de agora, vamos direcionar este local para [PLUGIN_PATH].
    Neste caminho, você encontra a pasta oscommerce-plugin-1.0.

PrintScreen

  1. Usando FTP ou fazendo login como Administrador no servidor onde o osCommerce está instalado, inclua os arquivos de plug-in no servidor da seguinte maneira:
  • No caminho do servidor /[servidor]/apache/[publication_path]/oscommerce/catalog, copie os arquivos de plugin confirmation_payu.php e response_payu.php. Esses arquivos estão localizados no caminho [PLUGIN_PATH]\oscommerce-plugin-1.0\oscommerce-payu-latam-1.0\catalog.

PrintScreen

  • No caminho do servidor /[servidor]/apache/[publication_path]/oscommerce/catalog/includes/languages/english/modules/, copie o arquivo do plugin ‘payu_latam.php localizado no caminho [PLUGIN_PATH]\oscommerce-plugin-1.0\oscommerce-payu-latam-1.0\catalog\includes\languages\english\modules\payment.

    PrintScreen
    Repita esta etapa para espanhol e português se você os instalou em seu site osCommerce. Esses arquivos estão localizados no caminho:
    • ES: [PLUGIN_PATH]\oscommerce-plugin-1.0\oscommerce-payu-latam-1.0\catalog\includes\languages\espanol\modules\payment
    • PT: [PLUGIN_PATH]\oscommerce-plugin-1.0\oscommerce-payu-latam-1.0\catalog\includes\languages\portugues\modules\payment
  • No caminho do servidor /[servidor]/apache/[publication_path]/oscommerce/catalog/includes/modules/payment/, copie o arquivo do plugin ‘payu_latam.php localizado no caminho [PLUGIN_PATH]\oscommerce-plugin-1.0\oscommerce-payu-latam-1.0\catalog\includes\modules\payment. Este arquivo não é o mesmo que o mencionado anteriormente.

PrintScreen

  1. No painel de administração do osCommerce, expanda o menu Modules no painel esquerdo e selecione a opção Payment.

PrintScreen

  1. Na seção Pagamento, clique no botão Install Module localizado no canto superior direito.

PrintScreen

  1. Encontre o plugin Payu Latam e clique nele. Depois, clique no botão Install Module no painel direito.

PrintScreen

  1. Depois de instalar o plugin, a lista de módulos instalados do plugin Payu Latam aparece no painel direito.

PrintScreen

Configuração

  1. Na seção Payment, selecione o método de pagamento Payu Latam e clique no botão Edit no painel direito.

PrintScreen

  1. O seguinte formulário de configuração aparece
PrintScreen

Configure-o usando as informações de sua conta PayU da seguinte forma:

Campo Valor
Enable / Disable Selecione True para habilitar o portal de pagamento no osCommerce.
Merchant ID ID da sua loja no PayU Latam
Account ID ID da conta PayU de acordo com o país onde você quer vender.
API key Chave única do seu comércio, que você encontra no Módulo PayU.
Gateway URL URL do Gateway.
Para teste, você pode usar https://sandbox.gateway.payulatam.com/ppp-web-gateway e para produção https://gateway.payulatam.com/ppp-web-gateway/
Transaction Mode Selecione Test se você deseja processar no ambiente de teste. Caso contrário, selecione Live.
Response page URL da página de resposta.
Por padrão, a URL é http://your.domain.com/yourOscommerceFolder/catalog/response_payu.php, você deve substituir http://your.domain.com com o domínio do seu site.
Confirmation page URL da página de resposta.
Por padrão, a URL é http://your.domain.com/yourOscommerceFolder/catalog/confirmation_payu.php, você deve substituir http://your.domain.com com o domínio do seu site.
  1. Salve as alterações usando o botão na parte inferior do painel.

  2. Finalmente, expanda o menu Localization e clique em Order Status. Verifique se o status da ordem foi criado de acordo com os idiomas instalados (inglês, espanhol e português) em seu site osCommerce.

PrintScreen

Os estados válidos são:

  • Para inglês: Approved, Rejected, Failed e Pending.
  • Para espanhol: Aprobada, Rechazada, Fallida e Pendiente.
  • Para Portuguese: Aprovado, Recusada, Falha e Pendente.

Nesta etapa seus clientes podem pagar com PayU Latam quando fizerem o checkout com o carrinho de compras do osCommerce.

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