VibeFox Tpay for OpenCart

Visão geral

O VibeFox Tpay Payment adiciona o Tpay ao OpenCart 3 e ao OpenCart 4 para lojas na Polônia. Na última etapa da finalização da compra, o cliente clica em Confirm Order e é enviado à página de pagamento segura do Tpay, onde são oferecidos BLIK, transferências bancárias online, cartões e os demais métodos ativados na sua conta do Tpay. A extensão usa a Tpay Open API. O OpenCart cria o pedido antes do pagamento, mas o pedido só recebe um status depois que o Tpay confirma o pagamento; por isso, as tentativas não pagas permanecem como pedidos ausentes.

Ela é indicada para lojas polonesas que vendem em złoty e querem um único método de pagamento para BLIK, transferências bancárias e cartões. A extensão funciona somente em PLN. O cliente escolhe o banco ou digita o código BLIK na página do Tpay, e não na sua loja. Não há cartões salvos, assinaturas, botões de Apple Pay ou Google Pay na loja, nem calculadoras de parcelamento.

Principais recursos

Página de pagamento do Tpay: BLIK, transferências bancárias online, cartões e outros métodos do Tpay na página segura do Tpay, em polonês, inglês ou ucraniano.

Pago somente quando o Tpay confirma: o pedido recebe o status após uma notificação do Tpay que passa na verificação do checksum MD5 com o seu código de segurança, na verificação do Merchant ID e da assinatura JWS, ou após uma consulta de status no servidor quando o cliente retorna. O valor precisa corresponder ao do pedido; caso contrário, o pedido vai para um status de revisão com uma observação.

Pagamento repetido com segurança: cada tentativa de pagamento tem sua própria referência. Uma nova tentativa cancela as transações não pagas anteriores do Tpay do pedido e do mesmo carrinho, e um pagamento feito por um link anterior continua sendo aceito.

Sem processamento duplicado: notificações repetidas ou simultâneas nunca aplicam um pagamento duas vezes, e um carrinho já pago não é cobrado de novo. Um segundo pagamento de um pedido já pago apenas é registrado.

Reembolsos pela página do pedido: reembolsos totais e parciais na aba VibeFox Tpay Payment do pedido, sempre no ambiente (sandbox ou produção) em que o pedido foi pago, até o valor recebido pelo Tpay.

Sandbox e produção: chaves separadas para cada ambiente; o modo sandbox troca tanto as chaves quanto o host da API.

Seus próprios status de pedido e condições do OpenCart: escolha o status para um pedido pago, em revisão e reembolsado; zona geográfica, valor mínimo do pedido e ordem de classificação. Log opcional, sem chaves nem dados de clientes.

Requisitos

OpenCart 3.0.x (testado na versão 3.0.5.0) ou OpenCart 4.0.2 ou superior (testado na versão 4.1.0.3), PHP 8.0 ou superior com a extensão OpenSSL (para a verificação da assinatura JWS). Um único download contém os pacotes para as duas versões. A moeda PLN configurada na loja. Uma conta de comerciante no Tpay com Merchant ID, Open API Client ID e Client secret, além do código de segurança das notificações. Uma chave de licença VibeFox obtida em vibefox.net (uma chave por domínio).