概述
VibeFox KOMOJU Payment 为 PrestaShop 添加 KOMOJU 付款功能。在付款步骤中，顾客选择 KOMOJU，并跳转到 KOMOJU 托管的付款页面，在那里选择付款方式：信用卡或借记卡、便利店付款（konbini）、PayPay、银行转账及其他本地付款方式，具体取决于您的 KOMOJU 账户和购物车币种。银行卡数据绝不会经过您的网站。只有在 KOMOJU 确认付款后才会创建订单，因此未完成的付款不会留下未付款订单。
本模块适合日本、亚洲及欧洲的店铺，帮助拥有 KOMOJU 商户账户的店铺提供本地付款方式。本模块仅接受一次性付款。在 PrestaShop 中，它不提供站内银行卡表单、保存银行卡、订阅或手动扣款操作。
主要功能
KOMOJU 托管页面：按购物车总额和购物车币种创建付款会话。JPY、KRW 和 VND 以无小数位的形式发送。仅对 KOMOJU 支持的 20 种币种提供此付款方式。
仅在 KOMOJU 确认后付款：订单会在收到使用您的 Webhook 密钥令牌签名的 Webhook 之后创建，或在顾客返回时从 KOMOJU API 读取付款会话之后创建。仅仅是顾客返回并不会为订单付款。
金额和币种核对：不一致时，订单会进入 KOMOJU payment on hold 状态并附带备注。KOMOJU 转换为其他币种的付款会通过付款会话进行核实。
Konbini 和银行转账：付款凭单开具时，订单进入 Awaiting KOMOJU payment 状态；顾客付款后，订单变为 Payment accepted。凭单过期会取消订单。
避免重复处理：重复或同时到达的 Webhook 和返回请求只会确认一次付款。新的尝试会复用未关闭的付款会话，旧会话的付款仍会被识别。
测试和正式模式：各自使用独立的密钥和 Webhook 密钥令牌。每笔付款都会记住其模式，因此切换之后，退款和状态检查仍会使用正确的密钥。
在订单页面退款：在 KOMOJU payment 区块中进行全额或部分退款，最多可退至 KOMOJU 实际收取的金额。全额退款会将订单设为 Refunded。在 KOMOJU 控制面板中进行的退款会自动记录。
订单页面的 KOMOJU 区块：付款信息（含 KOMOJU 控制面板链接）、退款记录以及模块备注。日志中不包含密钥或顾客数据。
系统要求
PrestaShop 8.0 至 9.x，PHP 8.0 或更高版本。需要一个带密钥和 Webhook 密钥令牌的 KOMOJU 商户账户。来自 vibefox.net 的 VibeFox 许可证密钥（每个域名一个密钥）。