VibeFox dLocal for OpenCart

Visão geral

O VibeFox dLocal Payment conecta o OpenCart 3 e o OpenCart 4 ao dLocal Go, o produto de autoatendimento da dLocal. Na última etapa da compra, o cliente clica em Confirm Order, é enviado à página de pagamento do dLocal Go, paga com um método local do seu país (cartões, transferências bancárias, boletos em dinheiro ou carteiras digitais) e volta para a sua loja. 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 depois que o dLocal Go confirma o pagamento, então as tentativas não pagas continuam como pedidos ausentes.

Ela é indicada para lojas que vendem na América Latina, na África e na Ásia e que têm uma conta no dLocal Go. A extensão aceita apenas pagamentos únicos. Não há formulário de cartão no seu site, cartões salvos, assinaturas nem autorização e captura separadas, e ela não funciona com a API corporativa do dLocal Payments (credenciais X-Login / X-Trans-Key).

Principais recursos

Página de pagamento do dLocal Go: um pagamento é criado pelo total do pedido, na moeda do pedido, e para o país do cliente. Os valores seguem as casas decimais de cada moeda, por exemplo valores inteiros para CLP e JPY.

Pago somente quando o dLocal Go confirma: as notificações de pagamento são verificadas pela assinatura, e o status, o valor e a moeda são sempre consultados novamente na API do dLocal Go. O status também é verificado quando o cliente retorna. Depois disso, o OpenCart envia os e-mails habituais do pedido.

Verificação de valor e moeda: um pagamento que não corresponde ao pedido coloca o pedido em um status de análise com uma nota, em vez de marcá-lo como pago.

Sem processamento duplicado: notificações repetidas e retornos nunca aplicam um pagamento duas vezes. Antes de iniciar um novo pagamento, são verificados os pagamentos abertos da mesma sessão do cliente, para que um pagamento já feito seja confirmado em vez de cobrar de novo.

Sandbox e produção: credenciais separadas para cada ambiente. As notificações e os reembolsos de um pagamento sempre usam as credenciais do próprio ambiente.

Reembolsos pela página do pedido: reembolsos totais e parciais na aba VibeFox dLocal Payment do pedido, no valor e na moeda cobrados pelo dLocal Go. Um reembolso total define o status Refunded, e o status final do reembolso informado pelo dLocal Go é adicionado às notas.

Novas tentativas simples para o cliente: um cliente que sai da página do dLocal Go sem pagar vê uma mensagem no checkout e pode tentar novamente ou escolher outro método de pagamento.

Condições e status do OpenCart: zona geográfica, valor mínimo do pedido, ordem de exibição e seus próprios status para pedidos pagos, concluídos, em análise e reembolsados. Registro opcional, sem credenciais nem dados pessoais.

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. Uma conta no dLocal Go com chave de API e segredo de API. Uma loja acessível pela internet via HTTPS para as notificações. Uma chave de licença VibeFox obtida em vibefox.net (uma chave por domínio).