Wix Velo 网关

概述

MakePay Wix Velo 网关通过 Velo 后端文件创建托管 MakePay 结账链接，并接收签名 Webhook 更新订单状态。它适用于需要在 Wix 中自定义支付流程的商户。

开始之前

• Wix 站点启用 Velo。
• 可编辑后端代码和站点 secrets。
• MakeCrypto 公司已配置 MakePay 结算。
• 站点域名和回调函数可从公网访问。

创建 MakePay 凭据

在 MakeCrypto 中创建 MakePay API 密钥，记录 key ID 和一次性 secret。配置默认结算资产、费用策略和必要的重定向 URL。

添加 Wix Velo 文件

将 MakePay Velo 支付提供方文件添加到 Wix 后端。文件会使用 API 密钥创建支付链接，并为订单返回托管结账 URL。

添加 Wix 密钥

在 Wix Secrets Manager 中保存 MakePay API key ID、API secret、公司 ID、Webhook secret 和 MakeCrypto/MakePay URL。不要把 secret 写入前端代码。

在 Wix 中连接 MakePay

把支付提供方连接到 Wix 结账或自定义订单流程。创建订单后调用后端函数生成 MakePay 支付链接，并把客户重定向到返回的 URL。

配置 Webhook

在 MakeCrypto 中把 callback URL 设置为 Wix 后端函数，例如：

https://your-wix-domain.com/_functions/makepay_notify

确保 Webhook secret 与 Wix secret 匹配，并验证签名后再更新订单。

测试结账

创建小额测试订单，确认 Wix 后端创建支付链接、客户进入 MakePay、付款后 Webhook 到达，并且订单状态更新。

安全说明

所有 API secret 和 Webhook secret 必须放在 Wix Secrets Manager 中。前端只能调用后端函数，不能直接访问 MakePay API secret。

故障排查

如果无法创建支付链接，请确认 API key 拥有 makepay:payment-links:write。如果订单不更新，请确认 MakeCrypto callback URL 是 https://your-wix-domain.com/_functions/makepay_notify，Webhook secret 匹配，并且 MakeCrypto Webhook 投递日志显示 2xx 响应。