概述
VibeFox Khipu Gateway 为智利、阿根廷和秘鲁的商店向 PrestaShop 添加 Khipu 银行转账支付。在结账时,客户选择 Khipu,被重定向到 Khipu 支付页面,通过自己开户的银行完成银行转账,然后返回您的商店。只有在 Khipu 确认转账后才会创建订单,因此中途放弃的付款不会留下未付款的订单。
它适合以智利比索、阿根廷比索或秘鲁索尔销售,并希望通过 Khipu 收款账户接受银行转账的商店。该模块仅支持一次性银行转账付款。退款不会从 PrestaShop 发送到 Khipu,模块也不提供订阅、保存的支付方式或预授权功能。
主要功能
Khipu 支付页面: 按购物车币种为购物车总额创建一笔付款:CLP 不带小数,ARS 和 PEN 带 2 位小数。
仅在 Khipu 确认后才视为已付款: Khipu 通知必须带有有效的 HMAC-SHA256 签名,随后模块会向 Khipu 查询付款状态。只有当 Khipu 报告转账已完成、对应您的 Receiver ID、对应本购物车,且金额与币种完全一致时,才会创建订单。
返回时检查: 当客户从 Khipu 返回时,模块会向 Khipu 查询状态,因此丢失或延迟的通知不会让已付款的购物车缺少订单。
金额与币种检查: 金额或币种不一致,或订单取消后才到账的款项,都会使订单进入 Khipu payment on hold 状态,并附上供人工核查的备注。
不会重复处理: 重复或同时到达的通知和返回操作,绝不会创建第二个订单,也不会重复记录付款。
安全重试: 新的付款尝试会删除上一笔未支付的 Khipu 付款,因此旧链接无法再付款。如果 Khipu 已收到上一笔付款,则会创建订单,而不会再次扣款。
自选状态: 付款后设为 Payment accepted 或 Delivered,只进行一次状态变更。
订单页面上的 Khipu 区块: 该订单的 Khipu 付款尝试(含付款 ID 和状态)以及模块备注。可选日志,不包含密钥或付款人数据。
环境要求
PrestaShop 8.0 至 9.x,PHP 8.0 或更高版本。购物车币种为 CLP、ARS 或 PEN。一个具有 Receiver ID、API key 和 Secret key 的 Khipu 收款账户,以及一个可从互联网访问的商店。来自 vibefox.net 的 VibeFox 许可证密钥(每个域名一个密钥)。
