PAYWISE
zh
← 全部文章

新闻

镜像域名:一个网站,多个地址

同一家店铺可以在多个域名上运行。客户付款后会返回其付款所在的域名,每个域名也可以接收各自的付款通知。

发布于 05 十月 2026 阅读约 2 分钟

其他语言版本: English, Indonesia

镜像域名:一个网站,多个地址

许多店铺可以通过多个域名访问:备用域名、用于推广的短域名,或在旧域名仍可使用期间启用的新域名。在 PAYWISE 中,这些额外的域名称为镜像域名。只需在网站中添加一次,来自所有域名的付款都会以相同方式处理。

有哪些变化

  • **客户返回其付款所在的域名。**在镜像域名上购物的客户,付款后会返回该镜像域名,而不是主域名。
  • **每个域名都可以接收自己的 Webhook。**在镜像域名上完成的付款,其通知可以发送到同一个镜像域名。
  • **API 接受镜像域名作为网站。**如果请求中填写的是镜像域名,PAYWISE 会识别它属于哪个网站。

客户在镜像域名上付款,返回该镜像域名的感谢页面,Webhook 也发送到同一镜像域名

用路径代替完整地址

网站的返回 URL 和 Webhook URL 现在可以只填写路径,例如 /thank-you 和 /callback/paywise。PAYWISE 会在付款来源的域名上打开或调用该路径:

客户付款所在域名 返回地址 Webhook 发送到
northwindcoffee.com northwindcoffee.com/thank-you northwindcoffee.com/callback/paywise
nwcoffee.store nwcoffee.store/thank-you nwcoffee.store/callback/paywise

完整的 https:// 地址仍然可以使用。如果填写的是其他域名上的完整地址,则所有付款都使用该地址。

PAYWISE 如何判断域名

PAYWISE 使用 API 请求中填写的域名,或客户打开付款页面时的来源页面。只有该网站已登记的域名才有效,并且每笔付款只判断一次。

如何设置

  1. 在控制台中打开支付页面,找到您网站的卡片。
  2. 在镜像域名中添加您的其他域名,每行一个(最多十个),其子域名也包含在内。
  3. 将支付后的返回 URL 和此网站的 Webhook 中的 URL 设置为路径,例如 /thank-you 和 /callback/paywise。
  4. 查看网站卡片:其中显示每个域名的客户和通知将去往何处。

注意事项

  • 请确保所有域名上都存在相同的路径。
  • 所有域名使用同一个 Webhook 密钥,因此一次签名验证即可适用于所有域名。参见验证 PAYWISE Webhook 签名。
  • Webhook 路径在保存时会作为公网地址进行检查,并在每次发送前再次检查。

刚开始在线收款?请先阅读如何在网站上收款。

更多文章

今天就从沙盒密钥开始。

创建账户、生成沙盒密钥,几分钟内即可在调试台发送第一笔交易。