VibeFox Yoco for PrestaShop

Visão geral

O VibeFox Yoco Pay Gateway adiciona ao PrestaShop pagamentos com cartão e Instant EFT em rands sul-africanos (ZAR) pela API de Checkout da Yoco. Na etapa de pagamento, o cliente escolhe a Yoco, é enviado à página de pagamento hospedada pela Yoco, paga ali e volta para a sua loja. Os dados do cartão nunca passam pelo seu site, e pagamentos abandonados não deixam pedidos sem pagamento.

Ele é indicado para lojas sul-africanas que vendem em ZAR e têm uma conta na Yoco com pagamentos online. O módulo aceita apenas pagamentos únicos. Não há cartões salvos, assinaturas, formulário de cartão no próprio site nem autorização e captura separadas; ele funciona somente em ZAR e exige um valor mínimo de pedido de R2,00.

Principais recursos

Página de pagamento hospedada pela Yoco: um checkout da Yoco é criado pelo valor total do carrinho em centavos. Uma solicitação repetida após um clique duplo ou um tempo limite recebe o mesmo checkout, não um segundo.

Pago somente quando a Yoco confirma: o módulo consulta a Yoco sobre o status do checkout quando o cliente volta e quando chega um webhook assinado. O pedido só é criado quando a Yoco informa que o checkout foi concluído.

Webhooks configurados para você: ao salvar uma chave secreta, o módulo registra a URL do seu webhook na Yoco para esse modo e armazena o segredo de assinatura. Webhooks sem assinatura válida são recusados.

Verificação de valor e moeda: um pagamento com valor ou moeda diferentes coloca o pedido em Yoco payment on hold com uma nota. Um pagamento de um pedido cancelado ou reembolsado não o reabre.

Sem processamento duplicado: um webhook e o retorno do cliente que chegam ao mesmo tempo são tratados um após o outro. Um carrinho, um pedido e um pagamento registrado.

Reembolsos pela página do pedido: reembolsos totais e parciais no bloco Yoco payment do pedido, sobre o valor cobrado pela Yoco e com a chave do modo em que o pagamento foi feito. Reembolsos feitos no portal da Yoco são registrados automaticamente.

Modos de teste e de produção: chaves secretas e segredos de webhook separados para cada modo. Uma chave com prefixo errado não é salva.

Bloco da Yoco na página do pedido: o pagamento, todas as tentativas de pagamento do carrinho, o histórico de reembolsos e as notas do módulo. Registro com chaves e e-mails mascarados.

Requisitos

PrestaShop 8.0 a 9.x, PHP 8.0 ou superior. Moeda da loja: rand sul-africano (ZAR). Uma conta na Yoco com pagamentos online e as suas chaves secretas. Uma chave de licença VibeFox obtida em vibefox.net (uma chave por domínio).