Skip to content

跳转到结账页

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

推荐流程

  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。买家回到成功页,只说明浏览器完成了跳转,不代表你的订单系统已经可以发货或开通权益。

下一步