VibeFox KOMOJU for PrestaShop

Overview

VibeFox KOMOJU Payment adds KOMOJU payments to PrestaShop. At the payment step the customer chooses KOMOJU, is sent to the KOMOJU hosted payment page and chooses a method there: credit or debit card, convenience store payment (konbini), PayPay, bank transfer and other local methods, depending on your KOMOJU account and the cart currency. Card data never touches your site. The order is created only after KOMOJU confirms the payment, so abandoned payments leave no unpaid orders.

It suits shops in Japan, Asia and Europe that want local payment methods with a KOMOJU merchant account. The module takes one-time payments only. It has no card form on your site, saved cards, subscriptions or manual capture action in PrestaShop.

Key features

KOMOJU hosted page: a payment session is created for the cart total in the cart currency. JPY, KRW and VND are sent without decimals. The method is offered only for the 20 currencies KOMOJU supports.

Paid only when KOMOJU confirms: the order is created after a webhook signed with your webhook secret token or after the payment session is read from the KOMOJU API when the customer returns. The return alone never pays an order.

Amount and currency check: a mismatch puts the order in KOMOJU payment on hold with a note. Payments that KOMOJU converted into another currency are verified through the payment session.

Konbini and bank transfer: the order waits in Awaiting KOMOJU payment when the payment slip is issued and becomes Payment accepted when the customer pays. An expired slip cancels the order.

No double processing: repeated or simultaneous webhooks and returns confirm a payment once. A new attempt reuses the open session, and a payment of an older session is still recognised.

Test and live modes: separate secret keys and webhook secret tokens. Every payment remembers its mode, so refunds and status checks use the right key after you switch.

Refunds from the order page: full and partial refunds in the KOMOJU payment block, up to the amount KOMOJU actually charged. A full refund sets the order to Refunded. Refunds made in the KOMOJU dashboard are recorded automatically.

KOMOJU block on the order page: the payment with a KOMOJU dashboard link, refund history and the module's notes. Log without keys or customer data.

Requirements

PrestaShop 8.0 to 9.x, PHP 8.0 or later. A KOMOJU merchant account with a secret key and a webhook secret token. A VibeFox license key from vibefox.net (one key per domain).