Taria Pay 文档

Appearance

测试与上线准备 ​

正式上线前，建议先用 test key 跑通完整链路：创建订单、跳转结账页、完成付款、接收 webhook、更新你的订单系统。

测试目标 ​

你需要确认：

  • 服务端可以成功创建 payment intent。
  • 前端能拿到 checkoutUrl 并跳转。
  • 买家完成付款后，你的 webhook 能收到事件。
  • 你的订单系统能按 paymentId 或 orderId 幂等更新。
  • 失败、取消、过期和重复事件不会导致错误履约。

推荐测试顺序 ​

  1. 在商家后台 Developers 创建 test API key。
  2. 创建 webhook endpoint，并保存 signing secret。
  3. 用服务端创建一笔小额测试订单。
  4. 前端跳转到 Taria Pay 结账页。
  5. 完成付款或模拟失败路径。
  6. 在 Delivery Logs 查看 webhook 投递结果。
  7. 在你的系统确认订单状态。

本地 webhook ​

如果你的服务端还在本地开发，需要让 Taria Pay 能访问你的 webhook endpoint。常见做法是使用公网转发工具，把本地地址临时暴露为 HTTPS URL。

上线前请把 webhook URL 换成正式域名。

测试清单 ​

  • API key 没有暴露在前端代码。
  • orderId 在你的系统里稳定且唯一。
  • successUrl 和 cancelUrl 都能正常打开。
  • webhook handler 会先验签。
  • webhook 处理逻辑是幂等的。
  • confirmed 后才触发发货、开通权益或记账。
  • 客服或运营知道如何用 paymentId、orderId、txHash 排查问题。

下一步 ​