VibeFox ECPay for OpenCart

Visão geral

O VibeFox ECPay Payment Gateway adiciona ao OpenCart 3 e ao OpenCart 4 o ECPay (綠界), o serviço de pagamento de Taiwan. No último passo da finalização de compra, o cliente clica em Confirm Order, é enviado à página de pagamento hospedada pelo ECPay e paga com cartão de crédito, conta virtual de caixa eletrônico (ATM), código de pagamento em loja de conveniência ou código de barras de loja de conveniência. Os dados do cartão nunca passam pelo seu site. O OpenCart cria o pedido antes do pagamento, mas o pedido só recebe um status quando o ECPay confirma o pagamento com uma notificação assinada; assim, as tentativas não pagas continuam sendo pedidos sem status.

Ela é indicada para lojas de Taiwan que vendem em novos dólares taiwaneses (TWD). A extensão aceita apenas pagamentos únicos. Não há reembolsos pelo OpenCart (os reembolsos são feitos no back-office do ECPay), nem cartões salvos, assinaturas ou pagamentos recorrentes, parcelamento, Apple Pay, notas fiscais eletrônicas ou logística.

Principais recursos

Quatro métodos do ECPay: cartão de crédito, conta virtual de ATM, código CVS (loja de conveniência) e código de barras. Com vários métodos ativados, o cliente escolhe um no passo Confirm Order.

Pago somente quando o ECPay confirma: um pedido recebe seu status somente pela notificação do servidor do ECPay com assinatura CheckMacValue válida, para um número de transação emitido por esta loja e com um valor pago compatível com o pedido. O simples retorno do cliente nunca altera um pedido. Depois, o OpenCart envia os e-mails habituais do pedido.

Instruções de pagamento para métodos offline: para ATM, CVS e código de barras, o pedido aguarda em um status de pendente, e a conta, o código ou os códigos de barras com o prazo de pagamento são exibidos na página de sucesso do pedido e nas informações do pedido do cliente.

Tentativas seguras: cada tentativa de pagamento recebe um novo número de transação do ECPay, então as novas tentativas após um pagamento recusado funcionam. Um segundo pagamento de um pedido já pago é registrado para reembolso.

Sem surpresas: notificações repetidas são ignoradas, pagamentos simulados no back-office do ECPay nunca marcam um pedido como pago, e divergências de valor, pagamentos de sandbox depois de passar para o modo real ou pagamentos de pedidos cancelados vão para um status de revisão.

Teste sem conta: o modo de teste usa o comerciante público de sandbox do ECPay, então você pode testar antes de ter as chaves do ECPay.

Aba do ECPay na página do pedido: as tentativas de pagamento com os números de transação do ECPay, o status delas e as notas do ECPay do pedido.

Seus próprios status de pedido e condições do OpenCart: escolha o status para pagamento concluído, pendente, em espera e recusado; zona geográfica, valor mínimo do pedido e ordem de exibição. Registro opcional, sem chaves nem dados de clientes; erros são sempre registrados.

Requisitos

OpenCart 3.0.x (testado na versão 3.0.5.0) ou OpenCart 4.0.2 e superior (testado na versão 4.1.0.3), PHP 8.0 ou superior. Um único download contém os pacotes das duas versões. A moeda TWD na sua loja. Uma conta de comerciante do ECPay (MerchantID, HashKey, HashIV) para pagamentos reais. Uma loja acessível pela internet na porta 80/443. Uma chave de licença do VibeFox obtida em vibefox.net (uma chave por domínio).