Skip to content

跳转到结账页

前端只需要调用你自己的服务端,拿到 checkoutUrl 后跳转。它不需要知道 Taria Pay API key,也不应该直接创建支付订单。

这是 Hosted Checkout 路径。如果你只想在自己页面放一个支付按钮,可以使用 Checkout Button 打开同一个 hosted checkout URL;如果你希望买家不离开你的网站,请使用 Checkout Panel。

推荐流程

  1. 买家点击你网站上的付款按钮。
  2. 前端请求你的服务端接口。
  3. 你的服务端创建 payment intent。
  4. 服务端返回 checkoutUrl
  5. 前端跳转到 checkoutUrl

React 示例

ts
async function handleCheckout() {
  const response = await fetch("/api/tariapay/create-payment", {
    method: "POST",
  });

  const payload = await response.json();

  if (!response.ok || !payload.checkoutUrl) {
    throw new Error(payload.error ?? "Failed to create checkout");
  }

  window.location.assign(payload.checkoutUrl);
}

使用 SDK browser helper

如果你使用 @tariapay/sdk/browser,也可以这样跳转:

ts
import { redirectToCheckout } from "@tariapay/sdk/browser";

redirectToCheckout(payload.checkoutUrl);

成功页和取消页

successUrlcancelUrl 用来改善买家体验:

  • successUrl:买家完成付款后返回你的网站
  • cancelUrl:买家取消或离开结账流程后返回你的网站

它们不能替代 webhook。买家回到成功页,只说明浏览器完成了跳转,不代表你的订单系统已经可以发货或开通权益。

下一步