概述
VibeFox Kushki Payment 为厄瓜多尔和哥伦比亚的商店在 PrestaShop 中添加通过 Kushki 进行的银行卡付款。在付款步骤，顾客在 Kushki 托管的表单中输入卡信息，该表单显示在您的结账页面中，但由 Kushki 提供。表单返回一次性令牌，您的商店通过 Kushki API 在服务器端扣款。银行卡号绝不会到达您的网站。只有在 Kushki 批准扣款后才会创建订单，因此被拒绝或放弃的付款不会留下未付款订单。
本模块适合以 USD 或 COP 收款、希望在自己的结账页面提供银行卡表单而无需处理卡数据的商店。模块仅支持一步完成的银行卡付款。不支持部分退款、保存的银行卡、订阅、现金付款、银行转账（PSE）、借记卡跳转付款，也不支持单独授权和扣款。
主要功能
Kushki 托管银行卡表单：PrestaShop 结账付款步骤中的 Kushki 银行卡表单。表单中选择的分期付款（diferido）会传递给扣款。
仅在 Kushki 确认后标记为已付款：只有 Kushki 批准扣款并返回票据号后，才会创建订单。Kushki 报告的金额或币种不符时，订单会以备注形式进入 Kushki payment on hold 状态。
税款作为 IVA：金额和币种始终取自购物车。购物车税额会以 IVA 报告给 Kushki，不含税的商品行单独报告。
签名的 Webhook：可选的 Webhook 会为 API 响应丢失的付款创建订单，并为在 Kushki Console 中进行的作废和退款添加备注。签名无效的通知会被拒绝。
无重复扣款：按购物车的锁定机制可防止双击或第二个标签页导致的重复扣款，重复的 Webhook 也绝不会创建第二个订单。
测试与正式模式：每种模式各有独立的商户 ID 和 Webhook 签名。退款始终使用付款时所用的模式。
从订单页面全额退款：订单中的 Kushki payment 区块会退还 Kushki 扣款的全部金额。订单状态设为 Refunded。
订单页面的 Kushki 区块：票据号、参考号、环境、退款历史以及订单的 Kushki 备注。日志不包含商户 ID、卡令牌或顾客邮箱。
系统要求
PrestaShop 8.0 至 9.x，PHP 8.0 或更高版本。购物车币种为 USD 或 COP。需要一个 Kushki 账户，并具备测试和正式环境的 Public 与 Private Merchant ID；正式付款需要 HTTPS。需要一个来自 vibefox.net 的 VibeFox 许可证密钥（每个域名一个密钥）。