概述
VibeFox PayU India Payment Gateway 通过 PayU India 托管结账页面为 PrestaShop 添加付款功能。在付款步骤中,顾客选择 PayU India,被重定向至 PayU 付款页面,使用信用卡、借记卡、NetBanking、UPI 或电子钱包(根据您 PayU 账户中启用的功能)付款,随后返回您的店铺。银行卡和银行数据绝不会经过您的网站。订单仅在 PayU 发回已签名的结果后才会创建,因此未完成的付款不会留下未付款订单。
本模块适合以卢比结算、希望使用 PayU 付款方式而无需在自有网站构建支付表单的印度店铺。模块仅以 INR 计费,不支持多币种处理。不支持保存银行卡或令牌化、订阅、站内银行卡表单、EMI 分期或优惠管理,也不支持 PayU 一键结账。退款在 PayU 端排队处理;模块不跟踪其最终状态。
主要功能
PayU 托管结账: 在结账页面提供单一的 PayU India 付款方式。付款请求使用您的 Merchant Key 和 Salt 以 SHA-512 签名。
仅在 PayU 确认后视为已付款: 仅当结果附带使用发起付款时所属模式的 Salt 生成的有效 PayU 反向哈希,且交易 ID 是您的店铺为该购物车签发的,结果才会被接受。已付金额必须以 INR 计,与购物车总额精确到派萨(paisa)一致。
服务器端验证: 可选(默认开启),每笔成功付款都会通过 PayU verify_payment API 进行二次校验。若校验失败,订单将被置于保留状态,而不会被标记为已付款。
避免重复处理: 顾客的返回和 Webhook 可能同时到达;重复的结果绝不会创建第二个订单,也不会重复记录付款。已付款或已退款的订单绝不会被重新打开。
UPI 和 NetBanking 待处理付款: 订单保持在 Awaiting PayU India payment 状态,直到最终结果到达。
测试与正式凭据分开: 切换模式会同时切换密钥和 PayU 端点。退款始终发送至付款时所用的模式。
订单页面退款: 在订单的 PayU India payment 区块中进行全额或部分退款,PayU 请求 ID 记录在退款历史中。全额退款会将订单状态设为 Refunded。
订单页面的 PayU 区块: 交易 ID、模式、银行、金额、退款历史以及模块备注。针对关闭浏览器的顾客提供可选 Webhook;日志不记录密钥、Salt 或个人数据。
系统要求
PrestaShop 8.0 至 9.x,PHP 8.0 或更高版本。拥有测试和正式模式的 Merchant Key 与 Merchant Salt (v1) 的 PayU India 账户,且购物车币种为 INR。顾客地址中需填写电话号码。来自 vibefox.net 的 VibeFox 许可证密钥(每个域名一个密钥)。
