VibeFox Square for PrestaShop

Visão geral

O VibeFox Square Gateway adiciona ao PrestaShop pagamentos com cartão de crédito e débito pela Square. Na etapa de pagamento, o cliente digita o cartão em um formulário seguro da Square exibido abaixo do método de pagamento (Square Web Payments SDK). Seu servidor recebe apenas um token de uso único e cobra por meio da API de pagamentos da Square. Os dados do cartão nunca chegam à sua loja, e o pedido só é criado depois que a Square confirma o pagamento.

Ele é indicado para vendedores Square nos Estados Unidos, Canadá, Austrália, Japão, Reino Unido, Irlanda, França e Espanha que querem aceitar pagamentos com cartão na própria página de pagamento. O módulo aceita pagamentos únicos com cartão, capturados imediatamente. Não há cartões salvos, assinaturas, Apple Pay, Google Pay, Cash App Pay, Afterpay ou cartões-presente Square, não há pagamentos somente com autorização e não há webhooks da Square.

Principais recursos

3-D Secure / SCA: a verificação do comprador é feita na tokenização do cartão, com o total do carrinho, a moeda e o endereço de cobrança enviados à Square.

Pago somente quando a Square confirma: o pedido recebe Payment accepted apenas para um pagamento COMPLETED com valor exatamente igual ao total do carrinho, na mesma moeda, com a mesma referência do carrinho e o mesmo local. Qualquer coisa inesperada coloca o pedido em Square payment on hold com uma nota.

Sem cobranças duplicadas: uma tentativa de pagamento por carrinho por vez, requisições idempotentes, e uma tentativa cuja resposta se perdeu é consultada na Square em vez de cobrar o cartão de novo.

Verificação de credenciais e moeda: o Access Token e o local são verificados com a Square ao salvar. O método de pagamento fica oculto para carrinhos em uma moeda que o local Square não pode cobrar.

Reembolsos pela página do pedido: reembolsos totais e parciais no bloco Square do pedido, sempre no ambiente, local, valor e moeda do pagamento real. Um reembolso total coloca o pedido em Refunded.

Bloco Square na página do pedido: ID do pagamento com link para o Square Dashboard, cartão, recibo, histórico de reembolsos e notas.

Mensagens claras: os clientes veem mensagens curtas (cartão recusado, CVV incorreto, 3-D Secure exigido). Os erros são sempre registrados, sem chaves nem dados de cartão.

Requisitos

PrestaShop 8.0 a 9.x, PHP 8.0 ou superior. Uma conta Square com um aplicativo no Square Developer Dashboard (Application ID, Access Token, Location ID). A moeda do carrinho deve ser a moeda do seu local na Square: USD, CAD, AUD, JPY, GBP ou EUR. Uma chave de licença VibeFox obtida em vibefox.net (uma chave por domínio).