VibeFox KOMOJU for PrestaShop

Présentation

VibeFox KOMOJU Payment ajoute les paiements KOMOJU à PrestaShop. À l’étape de paiement, le client choisit KOMOJU, est redirigé vers la page de paiement hébergée par KOMOJU et y choisit un moyen : carte de crédit ou de débit, paiement en supérette (konbini), PayPay, virement bancaire et autres moyens locaux, selon votre compte KOMOJU et la devise du panier. Les données de carte ne transitent jamais par votre site. La commande n’est créée qu’après la confirmation du paiement par KOMOJU, donc les paiements abandonnés ne laissent aucune commande impayée.

Il convient aux boutiques au Japon, en Asie et en Europe souhaitant proposer des moyens de paiement locaux avec un compte marchand KOMOJU. Le module n’accepte que les paiements ponctuels. Il ne propose ni formulaire de carte sur votre site, ni cartes enregistrées, ni abonnements, ni action de capture manuelle dans PrestaShop.

Principales fonctionnalités

Page hébergée par KOMOJU : une session de paiement est créée pour le total du panier dans la devise du panier. JPY, KRW et VND sont envoyés sans décimales. Le moyen n’est proposé que pour les 20 devises prises en charge par KOMOJU.

Payée seulement après confirmation de KOMOJU : la commande est créée après un webhook signé avec votre jeton secret de webhook, ou après la lecture de la session de paiement via l’API KOMOJU lorsque le client revient. Le simple retour du client ne paie jamais une commande.

Contrôle du montant et de la devise : un écart place la commande dans KOMOJU payment on hold avec une note. Les paiements que KOMOJU a convertis dans une autre devise sont vérifiés via la session de paiement.

Konbini et virement bancaire : la commande attend dans Awaiting KOMOJU payment lorsque le bordereau de paiement est émis, et passe à Payment accepted lorsque le client paie. Un bordereau expiré annule la commande.

Aucun traitement en double : les webhooks et retours répétés ou simultanés ne confirment un paiement qu’une seule fois. Une nouvelle tentative réutilise la session ouverte, et un paiement issu d’une session plus ancienne est toujours reconnu.

Modes test et production : clés secrètes et jetons secrets de webhook distincts. Chaque paiement mémorise son mode, afin que les remboursements et les contrôles de statut utilisent la bonne clé après un changement.

Remboursements depuis la page de commande : remboursements totaux et partiels dans le bloc KOMOJU payment, jusqu’au montant effectivement encaissé par KOMOJU. Un remboursement total place la commande en Refunded. Les remboursements effectués dans le tableau de bord KOMOJU sont enregistrés automatiquement.

Bloc KOMOJU sur la page de commande : le paiement avec un lien vers le tableau de bord KOMOJU, l’historique des remboursements et les notes du module. Le journal ne contient ni clés ni données clients.

Prérequis

PrestaShop 8.0 à 9.x, PHP 8.0 ou ultérieur. Un compte marchand KOMOJU avec une clé secrète et un jeton secret de webhook. Une clé de licence VibeFox de vibefox.net (une clé par domaine).