VibeFox KOMOJU for PrestaShop

Visão geral

O VibeFox KOMOJU Payment adiciona pagamentos KOMOJU ao PrestaShop. Na etapa de pagamento, o cliente escolhe a KOMOJU, é enviado à página de pagamento hospedada pela KOMOJU e escolhe lá o método: cartão de crédito ou débito, pagamento em loja de conveniência (konbini), PayPay, transferência bancária e outros métodos locais, conforme a sua conta KOMOJU e a moeda do carrinho. Os dados do cartão nunca passam pelo seu site. O pedido só é criado depois que a KOMOJU confirma o pagamento, então pagamentos abandonados não deixam pedidos sem pagamento.

É indicado para lojas no Japão, na Ásia e na Europa que querem métodos locais com uma conta de comerciante KOMOJU. O módulo aceita apenas pagamentos avulsos. Não oferece formulário de cartão no seu site, cartões salvos, assinaturas nem ação de captura manual no PrestaShop.

Principais recursos

Página hospedada pela KOMOJU: uma sessão de pagamento é criada para o total do carrinho na moeda do carrinho. JPY, KRW e VND são enviados sem casas decimais. O método só é oferecido para as 20 moedas aceitas pela KOMOJU.

Pago somente quando a KOMOJU confirma: o pedido é criado após um webhook assinado com o seu token secreto de webhook ou após a leitura da sessão de pagamento pela API da KOMOJU quando o cliente retorna. O simples retorno do cliente nunca paga um pedido.

Conferência de valor e moeda: uma divergência coloca o pedido em KOMOJU payment on hold com uma nota. Pagamentos que a KOMOJU converteu para outra moeda são verificados pela sessão de pagamento.

Konbini e transferência bancária: o pedido fica em Awaiting KOMOJU payment quando a guia de pagamento é emitida e passa para Payment accepted quando o cliente paga. Uma guia vencida cancela o pedido.

Sem processamento duplicado: webhooks e retornos repetidos ou simultâneos confirmam um pagamento uma única vez. Uma nova tentativa reutiliza a sessão aberta, e um pagamento de uma sessão anterior continua sendo reconhecido.

Modos de teste e produção: chaves secretas e tokens secretos de webhook separados. Cada pagamento guarda o seu modo, para que reembolsos e verificações de status usem a chave correta após a troca.

Reembolsos pela página do pedido: reembolsos totais e parciais no bloco KOMOJU payment, até o valor que a KOMOJU efetivamente cobrou. Um reembolso total coloca o pedido em Refunded. Os reembolsos feitos no painel da KOMOJU são registrados automaticamente.

Bloco KOMOJU na página do pedido: o pagamento com um link para o painel da KOMOJU, o histórico de reembolsos e as notas do módulo. O log não contém chaves nem dados de clientes.

Requisitos

PrestaShop 8.0 a 9.x, PHP 8.0 ou superior. Uma conta de comerciante KOMOJU com chave secreta e token secreto de webhook. Uma chave de licença VibeFox de vibefox.net (uma por domínio).