VibeFox PayU India for PrestaShop

Visão geral

O VibeFox PayU India Payment Gateway adiciona ao PrestaShop pagamentos por meio da finalização de compra hospedada da PayU India. Na etapa de pagamento, o cliente escolhe PayU India, é redirecionado à página de pagamento da PayU, paga com cartão de crédito ou débito, NetBanking, UPI ou carteira digital (conforme ativado na sua conta PayU) e retorna à sua loja. Os dados do cartão e bancários nunca passam pelo seu site. O pedido só é criado depois que a PayU envia um resultado assinado, então pagamentos abandonados não deixam pedidos sem pagamento.

Ele é indicado para lojas indianas que vendem em rúpias e desejam os métodos de pagamento da PayU sem precisar criar formulários de pagamento no próprio site. O módulo cobra exclusivamente em INR e não possui processamento multimoeda. Não oferece cartões salvos ou tokenização, nem assinaturas, nem formulário de cartão no site, nem gestão de parcelamento (EMI) ou ofertas, nem checkout em um clique da PayU. Os reembolsos são enfileirados na PayU; o módulo não acompanha o status final deles.

Principais recursos

Finalização de compra hospedada PayU: um único método de pagamento, PayU India, na finalização de compra. A solicitação de pagamento é assinada com SHA-512 usando sua Merchant Key e Salt.

Pago somente quando a PayU confirma: um resultado só é aceito com um hash reverso válido da PayU gerado com o Salt do modo em que o pagamento foi iniciado, e somente para um ID de transação emitido pela sua loja para esse carrinho. O valor pago deve ser idêntico ao total do carrinho até o último paisa, em INR.

Verificação no servidor: opcional (ativada por padrão), cada pagamento bem-sucedido é verificado novamente com a API verify_payment da PayU. Se a verificação falhar, o pedido é colocado em espera em vez de ser marcado como pago.

Sem processamento duplo: o retorno do cliente e o webhook podem chegar juntos; resultados repetidos nunca criam um segundo pedido nem registram o pagamento duas vezes. Um pedido pago ou reembolsado nunca é reaberto.

Pagamentos pendentes de UPI e NetBanking: o pedido permanece em Awaiting PayU India payment até que chegue o resultado final.

Credenciais de teste e produção separadas: alternar o modo troca tanto as chaves quanto os endpoints da PayU. Os reembolsos sempre são enviados ao modo em que o pagamento foi feito.

Reembolsos pela página do pedido: reembolsos totais e parciais no bloco PayU India payment do pedido, com o ID da solicitação da PayU no histórico de reembolsos. Um reembolso total coloca o pedido em Refunded.

Bloco da PayU na página do pedido: ID da transação, modo, banco, valores, histórico de reembolsos e notas do módulo. Webhook opcional para clientes que fecham o navegador; o registro não contém chaves, salts ou dados pessoais.

Requisitos

PrestaShop 8.0 a 9.x, PHP 8.0 ou superior. Uma conta PayU India com Merchant Key e Merchant Salt (v1) para os modos de teste e produção, e INR como moeda do carrinho. Um número de telefone no endereço do cliente. Uma chave de licença VibeFox obtida em vibefox.net (uma chave por domínio).