概述
VibeFox Niubiz Payment 通过 Niubiz 官方付款表单（Botón de pago web）为 PrestaShop 添加在秘鲁的银行卡付款功能。在付款步骤中，顾客选择 Niubiz 后会进入店铺的付款页面，Niubiz 表单会在该页面打开。顾客在 Niubiz 表单中输入银行卡信息，店铺在服务器端完成付款授权。银行卡数据永远不会经过您的网站。只有在 Niubiz 响应之后才会创建订单，因此中途放弃或被拒绝的付款不会留下未付款的订单。
本模块适合在秘鲁以秘鲁索尔（PEN）或美元（USD）销售、并持有 Niubiz 商户关联的店铺。模块仅接受一次性银行卡付款。不支持从 PrestaShop 退款或撤销，也不支持保存银行卡、订阅或分期付款（cuotas），以及 PagoEfectivo、Yape 或二维码付款。
主要功能
Niubiz 付款表单：根据您的 Niubiz 商户关联所支持的卡种，可使用 Visa、Mastercard、American Express 和 Diners Club。表单会显示您的店铺名称或您自己的徽标。
仅在 Niubiz 批准后才标记为已付款：只有当 Niubiz 批准授权，且响应与购物车一致（购买编号、金额和币种）时，订单才会转为 Payment accepted。若不一致，订单将转为 Niubiz payment on hold 并附带备注。
响应丢失时同样安全：Niubiz 出现超时或无法读取的响应时，会创建 Niubiz payment on hold 状态的订单，并附上需要核对的购买编号，同时提醒顾客不要重复付款。
卡被拒绝：不会创建订单。顾客可以在付款页面看到 Niubiz 给出的拒绝原因，并可立即换一张卡重试。每次尝试都会获得新的购买编号。
避免重复处理：表单的重复或并行提交绝不会重复授权，也不会创建第二个订单。如果表单打开后购物车发生变化，银行卡不会被扣款。
沙盒与正式环境：每个环境使用独立的凭据。沙盒模式会同时切换 API 端点和凭据，进行中的付款始终保留在发起时所处的环境中。
订单页面上的 Niubiz 区块：购买编号、环境、交易 ID、授权码、脱敏后的银行卡信息以及订单的 Niubiz 备注。可选日志不包含凭据、令牌或银行卡及顾客数据。
系统要求
PrestaShop 8.0 至 9.x，PHP 8.0 或更高版本。购物车货币为 PEN 或 USD。需要 Niubiz 沙盒和正式环境凭据（merchant ID、API user、API password）。无需设置 webhook。还需要一个来自 vibefox.net 的 VibeFox 许可证密钥（每个密钥对应一个域名）。