支付配置:Pay2S、SePay、PayOS 与银行转账
填写收款银行账户,连接 Pay2S、SePay 或 PayOS 以自动激活套餐,设置注册、宽限期和卖方信息,并监控 webhook。
支付页面有什么用?#
管理 › 设置 › 支付 是平台的收款中心:至少有一种收款方式时客户才能购买套餐。LDPage 支持银行转账(客户扫描二维码)以及三个网关:Pay2S 和 SePay 监控您的银行账户,到账时发送 webhook,系统自动对账;PayOS 将客户跳转到 PayOS 支付页并自动激活。
1. 查看状态栏和“完成设置”清单#
- 1
打开账户菜单 › SaaS 管理 › 设置,在左侧“平台”分组中选择支付(Thanh toán)。
- 2
顶部四张卡片:收款方式(0 = 客户暂时无法购买套餐)、自动激活套餐(运行中、未运行或已关闭)、30 天收入、24 小时 webhook。点击卡片可跳到相关部分。
- 3
已开启自动对账网关但尚未填写收款账户时,自动激活显示“未运行”(Chưa chạy),此时订单仍需手动确认。
- 4
“完成设置”(Hoàn tất thiết lập)区块有 4 步:收款账户、启用支付网关、收到首个 webhook、卖方信息。点击某一步可打开缺失的部分;4 步完成后区块自动隐藏。
- 5
下方有 4 个部分:支付网关(附已启用数量,如 1/3)、转账、政策和 webhook 日志。
2. 网关卡片#
- 1
支付网关部分为每个网关显示一张卡片:Pay2S 和 SePay(标签为自动核对转账),PayOS(标签为支付页面)。
- 2
卡片右上角开关可快速启停网关。关闭运行中的网关时会再次确认:该网关的 webhook 将被拒绝,转账订单需手动确认直至重新开启(PayOS 关闭后客户将看不到该支付选项)。
- 3
三项数据:24h webhook、24h 激活数(被激活的订单数)和最近一次(最近 webhook 时间)。若有 webhook 被拒,卡片会提示 key/token 不匹配,并附查看按钮。
- 4
状态标签:运行中、已关闭(配置完整但未启用)、配置不完整(已启用但缺字段)或未配置。
- 5
卡片底部三个按钮:日志(打开按该网关筛选的 webhook 日志)、文档(打开服务商的集成文档)和配置(打开配置对话框)。
3. 配置 Pay2S、SePay 或 PayOS#
- 1
点击网关卡片上的配置。对话框顶部的 Webhook URL 形如 <您的域名>/api/v1/payments/<网关>/webhook;点击复制按钮后粘贴到网关后台。
- 2
“连接检查”(Kiểm tra kết nối)区块是自检清单:必填字段已齐全(或缺少 n 个)、webhook URL 是否公开(HTTPS)以及最近 webhook 状态(尚未收到、某时有效,或因 key/token 不匹配被拒)。网关服务器只能调用公开的 HTTPS 地址。
- 3
展开“配置指南”(Hướng dẫn khai báo)查看在网关网站上的操作步骤,其中已填入您的 webhook URL。
- 4
Pay2S:在 pay2s.vn 绑定与“转账”部分收款账户相同的银行账户;进入 Webhooks › 添加 webhook,选择账户、事件“收款”,Endpoint = webhook URL。将 Pay2S 显示的 token(只显示一次)复制到“Hook 的 Token”(Token của Hook)。当 Pay2S 绑定多个银行时使用“仅接收转入该账号的交易”;留空 = 接收所有已绑定账户。
- 5
SePay:在 my.sepay.vn 绑定收款银行账户;进入 Webhooks 集成 › 添加 webhook,事件“有款项转入”,URL = webhook URL;选择 API Key 认证方式,并在 SePay 和“API Key webhook”字段中填写同一个密钥字符串。
- 6
PayOS:在 my.payos.vn 创建支付渠道,将 Client ID、API Key 和 Checksum Key 复制到对应字段;在支付渠道中设置 Webhook URL = webhook URL,然后在 PayOS 端点击检查。
- 7
机密字段(token、key)保存时会加密;保存后字段显示已存值的提示,留空即保持不变。眼睛按钮可显示或隐藏正在输入的内容。
- 8
打开“启用 <网关>”开关(需填齐必填字段),然后点击保存(Lưu)。
- 9
以订单号作为转账备注小额试转一笔;结果会显示在 webhook 日志中。
4. 填写收款银行账户#
- 1
打开转账(Chuyển khoản)部分。“收款账户”卡片显示哪些网关正在自动对账;若已开启 SePay/Pay2S 但未填写账户,会出现黄色提示。
- 2
银行:输入名称或 BIN 在列表中搜索。若找不到您的银行,点击“输入 BIN”(Nhập mã BIN)自行填写 6 位 BIN 和银行显示名称。BIN 是 VietQR 标准的银行代码,用于生成二维码。
- 3
填写账号和户名(与银行登记一致,大写无声调)。
- 4
订单号与期限:订单号前缀(最多 10 位大写字母和数字,默认 PF)是客户填写在转账备注中的订单号开头;旁边会显示示例订单号。若仍有使用旧前缀的待付订单,修改前缀后这些订单需手动确认。
- 5
待付订单过期时间:1–168 小时(默认 48),快捷按钮为 24 小时、48 小时、72 小时、7 天。过期后订单转为已过期;迟到的款项仍可在 管理 › 订单 中确认。
- 6
右侧“客户将看到”(Khách sẽ thấy)栏预览客户的付款区块:示例二维码、银行、账号、户名、金额和转账备注。正式开售前请用银行 App 扫码测试。
- 7
如需暂停接收转账,点击“收款账户”卡片上的停止接收(Ngừng nhận);保存后生效。
5. 注册、宽限期与卖方信息#
- 1
打开政策(Chính sách)部分。注册与验证:允许客户自行注册账户(如只想手动开户可关闭)和强制验证邮箱。
- 2
套餐续期:宽限期 0–60 天(默认 3;快捷按钮 无宽限、3、7、14 天)。宽限期结束后,系统会自动下线页面并暂停超出套餐限额的域名。
- 3
推荐计划:此处仅显示状态;点击配置跳转到 管理 › 推荐。
- 4
卖方信息:卖方名称、税号、地址。这些信息会打印在付款收据上;右侧收据预览随输入实时更新。
6. 保存更改并查看 webhook 日志#
- 1
转账和政策两部分共用一个表单:来回切换不会丢失更改,有未保存更改的标签会被标记。通过屏幕底部的浮动保存栏(保存、取消)或 Ctrl/⌘ + S 保存。带着未保存更改离开页面会弹出提醒。
- 2
网关配置单独保存,使用各网关配置对话框中的保存按钮。
- 3
webhook 日志列出网关发来的所有消息,列为时间、网关、结果、订单、备注。可按网关、按结果(已激活订单、有效但未激活、被拒(认证失败))筛选,或按订单号、交易号搜索。
- 4
有效但未激活订单的 webhook(备注错误、少付等)会进入 管理 › 订单 的“未匹配交易”,供您手动分配。
常见问题#
- 1
webhook 被拒(认证失败):Pay2S token、SePay API Key 或 PayOS Checksum Key 不匹配。请在两端重新填写后保存。
- 2
连接检查提示 webhook URL 未公开:服务器在本地运行或没有 HTTPS,网关无法访问。请部署到带 HTTPS 的正式域名。
- 3
已到账但订单未激活:客户备注错误(缺订单号)、少付,或“转账”中的收款账户与网关绑定的账户不同。请查看 webhook 日志,并在“未匹配交易”中处理。
- 4
已启用网关但自动激活仍显示未运行:Pay2S/SePay 需要在“转账”中填写收款账户。
- 5
字段显示“正在使用 env 值”:该值来自服务器环境变量(如 SEPAY_WEBHOOK_KEY、PAYOS_CLIENT_ID)。