概述
VibeFox Cashfree Payments 通过 Cashfree Payments(印度)为 PrestaShop 添加付款功能。在付款步骤中,顾客选择 Cashfree,随即打开 Cashfree 托管结账页面,顾客可通过银行卡、UPI、网上银行、电子钱包或您 Cashfree 账户中启用的任何其他方式付款,付款完成后返回您的店铺。银行卡数据绝不会经过您的网站。订单只会在 Cashfree 确认付款后才创建,因此放弃的付款不会留下未付款的订单。
本模块适合希望通过一个 Cashfree 账户同时覆盖银行卡、UPI 和网上银行付款的印度店铺。本模块仅支持一次性付款。不支持保存银行卡、订阅或定期付款,不支持单独的授权与扣款,不支持 Cashfree 优惠组件、付款链接或通过 Cashfree 的货到付款(COD),也不支持货币换算。
主要功能
Cashfree 托管结账页面:按购物车币种为购物车总额创建 Cashfree 订单,金额精度采用 Cashfree 对该币种的要求,并为顾客打开 Cashfree 付款页面。
仅在 Cashfree 确认后才付款成功:订单在收到使用您的 Secret Key 签名的 Webhook 后,或在顾客返回店铺时经服务器端核对付款后,才会创建为已付款订单。仅凭返回链接绝不会创建已付款订单。
金额和币种核对:已付金额和币种必须与购物车完全一致。若不一致,订单将进入 Cashfree payment on hold 状态并附带备注。
避免重复处理:重复或同时到达的 Webhook 和返回请求绝不会创建第二个订单。若购物车已在 Cashfree 付款成功但未被记录,则会在下一次付款尝试时被识别,而不会再次扣款。
重试:顾客再次尝试时,会复用仍处于打开状态的 Cashfree 付款。若购物车总额已变更或会话即将过期,旧的 Cashfree 订单将被关闭,并创建新订单。
测试环境和正式环境:每种模式各有独立的密钥,结账时会显示测试环境提示。Webhook、付款核对和退款始终使用付款时所在的模式。
从订单页面退款:可在订单的 Cashfree payment 区块中进行全额或部分退款,退款金额不超过 Cashfree 实际扣款的金额。全额退款会将订单设为 Refunded。Cashfree 返回的退款状态更新会添加到备注中。
订单页面的 Cashfree 区块:Cashfree 付款信息、退款记录和模块备注。同一 Cashfree 账户下的多家店铺可使用订单号前缀加以区分。可选日志不包含密钥或顾客数据。
系统要求
PrestaShop 8.0 至 9.x,PHP 8.0 或更高版本。需要一个 Cashfree 账户,并分别持有测试环境和正式付款所用的 App ID 与 Secret Key。Webhook 需要 HTTPS。还需要一个来自 vibefox.net 的 VibeFox 许可证密钥(每个域名一个密钥)。
