Shopify
Este guia descreve os passos para habilitar o PayU em seu site Shopify.
Shopify é uma plataforma de comércio que permite criar e gerenciar facilmente sua loja online com poderosas ferramentas integradas. Para mais informações, visite o site oficial da Shopify.
Pré-requisitos
- Uma conta PayU Latam ativa.
- Um plano válido do Shopify. Note que a funcionalidade de Checkout não está disponível nos planos de teste. Você pode explorar os planos e preços do Shopify aqui.
Gestão de pedidos no Shopify
Tenha em mente as seguintes disposições ao gerenciar pedidos no Shopify:
- All orders (Todos os pedidos): Inclui pedidos com os seguintes 2 estados:
- Approved (Aprovado): Pedidos que estão pagos integralmente ou parcialmente.
- Pending (Pendente): Pedidos aguardando conclusão quando o cliente retorna à loja após processar um pagamento pelo gateway.
- Abandoned checkouts (Pagamentos abandonados): Aplica-se a processos que:
- Permaneceram incompletos porque o usuário não pôde completar o pagamento ou abandonou o site de compras.
- Estão marcados como Rejeitados.
- Permanecem em estado Pendente sem que o cliente retorne ao site de compras após o processamento do pagamento pelo gateway, isso inclui:
3.1. Pagamentos em dinheiro.
3.2. Pagamentos com cartão de crédito que passam por validação devido às regras de proteção contra fraude.
Nota
- O Shopify NÃO reserva inventário para nenhum dos cenários acima.
- Para os processos considerados como pagamento abandonado, o sistema só gera pedidos uma vez que a transação atinja o estado Aprovado.
Configurando o PayU como gateway de pagamento
- Faça login em sua conta do Shopify e baixe o aplicativo PayU Latam v2 na loja de aplicativos clicando aqui e selecionando Instalar.

- Selecione a loja onde deseja instalar o aplicativo. Você será redirecionado para a página de instalação. Clique em Instalar.


- Escolha o ambiente para a instalação do aplicativo — Teste ou Produção — com base no uso desejado:
- Use o Ambiente de Teste se estiver realizando transações de teste com credenciais sandbox.
- Use o Ambiente de Produção apenas se estiver pronto para processar pagamentos reais com credenciais ativas.
Importante
- Certifique-se de não usar credenciais de teste no ambiente de produção, ou vice-versa. Isso pode resultar em erros ou falhas nas transações.
- Encontre suas credenciais do ambiente de produção acessando o Painel de Gestão da PayU, onde você pode localizar o Merchant ID e o Account ID.
- Encontre as credenciais do ambiente de teste aqui.
- Você também pode verificar ou alterar suas credenciais nas configurações da sua conta Shopify.
- Você precisa de um Account ID por loja no Shopify.
Após selecionar o ambiente correto, insira seu Merchant ID e Account ID, e clique em Salvar para confirmar.

- Você será redirecionado para a página de Pagamentos. Para ativar o aplicativo, clique no botão Ativar localizado no canto inferior direito.

Importante
- Para sua informação, você verá vários métodos de pagamento. Para prosseguir, você deve selecionar pelo menos um deles. Isso não alterará os métodos de pagamento disponíveis no Checkout Web da PayU.
- Modo de teste: dentro da mesma seção Pagamentos, você encontrará a opção para usar o modo de teste, permitindo que você conduza testes no ambiente Sandbox.
- Recomendamos que você utilize o ambiente de teste de forma controlada, preferencialmente durante os horários de menor movimento, já que as transações processadas em modo de teste não resultam em pagamentos reais e o ambiente de produção permanece desativado.
- Para desativar o modo de teste, desmarque a caixa:

- Acesse seu Painel de Gestão da PayU, vá para a seção Configurações e clique em Configurações Técnicas. Ative a opção chamada Controlar pagamentos duplicados (Validar referência única) para evitar problemas durante o processamento do pagamento.

- A partir de agora, o PayU está configurado como seu processador de pagamento, permitindo que você inicie suas vendas. Com o Checkout Web da PayU, seus clientes podem fazer compras usando vários métodos de pagamento, incluindo dinheiro, cartões de crédito e transferências bancárias, adaptados ao país onde você está realizando negócios.
Fluxo de pagamento no Shopify
Ao configurar o PayU como portal de pagamento na plataforma, seu cliente pode pagar conforme explicado a seguir.
- Seu cliente seleciona o produto ou serviço que deseja comprar e o adiciona ao carrinho de compras.
- No carrinho de compras, seu cliente segue para a finalização da compra.
- Depois que seu cliente fornece suas informações, ele pode clicar em Finalizar a compra e ser redirecionado para PayU Latam para concluir o pagamento.
- Quando está em nosso portal de pagamento, ele pode ver a descrição da venda e os métodos de pagamento disponíveis para o seu país.
Nota
Se precisar emitir um reembolso total ou parcial, você pode gerenciá-lo diretamente no administrador da loja Shopify. Para obter mais informações, clique aqui.
Última modificação
19 de maio de 2025:
Documentation updates (77db4c5f6)