PromptPay 二维码支付 – 适用于 PrestaShop 8.x 的 PromptPay 二维码收款模块

PromptPay QR 支付

在 PrestaShop 中实现完整的 PromptPay 二维码收款流程，覆盖从结账到下单后的各个环节。客户无需再询问银行账户信息，可随时返回订单页面扫描二维码完成付款。

主要功能

• 根据订单总金额自动生成 PromptPay 二维码，确保二维码中的支付金额与订单金额一致。

• 订单创建后将设置为 “等待 PromptPay 二维码付款” 状态，而不会直接标记为已付款。

• 在等待付款期间，客户可以通过以下方式查看二维码：

  • 订单确认邮件（自动在邮件末尾附加二维码）。

  • 订单确认页面。

  • 我的账户 > 订单历史记录 > 订单详情。

  • PDF 发票（可从订单详情页面下载）。

• 管理员可以在后台订单页面查看二维码。

• 订单状态变更为已付款后，二维码会自动从网站页面中隐藏，新生成的 PDF 文件也不会再显示二维码。

• 支持 PromptPay 手机号码（10 位数字）和泰国国民身份证号码（13 位数字）。

• 部分隐藏 PromptPay 号码，在订单详情页面、PDF 发票和后台仅显示最后 4 位数字。

• 二维码由模块内部的 PHP 代码直接生成，无需调用外部服务，也不需要 Node.js。

• 面向客户显示的文字会根据客户选择的语言自动切换为泰语或英语。

使用流程

1. 客户在结账页面选择 PromptPay QR 支付方式。

2. 客户提交订单，订单进入等待付款状态。

3. 客户通过网站页面或 PDF 发票扫描二维码，并使用银行应用程序完成付款。

4. 商家核实到账金额后，将订单状态更改为 “付款已确认”。

系统要求

• PrestaShop 1.7.6 或更高版本 / 8.x。

• 已启用 PHP GD 扩展。

• 商店货币必须为泰铢（THB）。如果购物车使用其他货币，该支付选项将不会显示。

• PDF 使用的字体必须支持泰语，与发票其他部分使用的字体要求一致。

安装方法

1. 通过模块管理器上传 ZIP 安装包。

2. 启用模块，并在模块配置页面填写 PromptPay 号码。

3. 进入 设计 > 位置（Design > Positions），根据需要调整支付方式的显示顺序。

从 1.1.0 版本升级： 可以直接上传新版 ZIP 文件覆盖现有安装。模块会自动创建新的订单状态并注册所需的 Hook。

注意事项

• 模块不支持自动验证付款。 管理员必须手动核实到账情况，并更新订单状态以确认已收到付款。

• 等待付款状态已配置为生成发票，以便客户下载包含二维码的 PDF。因此，发票号码会在付款前生成。如需关闭此功能，可修改订单状态的 invoice 设置。

• 二维码仅支持带指定金额的转账，不会在二维码中嵌入订单参考编号。

常见问题

客户付款后，订单状态会自动更新吗？
不会。商家需要手动核实付款并更新订单状态。

客户离开结账页面后，还能查看二维码吗？
可以。只要订单仍处于等待付款状态，客户就可以通过订单历史记录或 PDF 发票再次查看二维码。

模块支持其他货币吗？
不支持，目前仅支持泰铢（THB）。

模块支持 PromptPay 电子钱包或纳税人识别号码吗？
当前版本仅支持 10 位手机号码和 13 位泰国国民身份证号码。

当前版本： 1.2.2
技术支持： [商店联系渠道]