Appearance
跳转到结账页
前端只需要调用你自己的服务端,拿到 checkoutUrl 后跳转。它不需要知道 Taria Pay API key,也不应该直接创建支付订单。
推荐流程
- 买家点击你网站上的付款按钮。
- 前端请求你的服务端接口。
- 你的服务端创建 payment intent。
- 服务端返回
checkoutUrl。 - 前端跳转到
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);成功页和取消页
successUrl 和 cancelUrl 用来改善买家体验:
successUrl:买家完成付款后返回你的网站cancelUrl:买家取消或离开结账流程后返回你的网站
它们不能替代 webhook。买家回到成功页,只说明浏览器完成了跳转,不代表你的订单系统已经可以发货或开通权益。