FastStar 开发者文档

接入 FastStar 所需的一切：通过 Checkout Session 唤起托管收银台、浏览器与 Flutter SDK、保存卡与 off-session 扣款、带签名的 Webhook——全部以你自己的品牌呈现。

快速开始：五步收到第一笔款

1. 注册商户账户

   注册 FastStar 商户账户并完成入驻。MoR（Merchant of Record）模式在线完成实名认证；Direct/PSP 模式需要平台审核企业资料。

2. 创建 API Key

   在商户后台创建 API Key，并在每个服务端请求中以 X-API-Key 请求头携带。切勿把 Key 暴露在浏览器或移动端 App 中。

3. 服务端创建 Checkout Session

   服务端调用 POST /public/checkout/sessions，传入要售卖的商品，拿到托管收银台 url。

   curl https://api.faststarpay.com/api/v1/public/checkout/sessions \
     -H "X-API-Key: 你的_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "mode": "payment",
       "presentation": "iframe",
       "line_items": [{ "price_id": "price_xxx", "quantity": 1 }],
       "success_url": "https://yoursite.com/success",
       "cancel_url": "https://yoursite.com/cancel"
     }'

4. 前端打开收银台

   引入 FastStar.js，以弹层方式打开会话 URL（presentation: "iframe"），或整页跳转（presentation: "link"）。

   <script src="https://cashier.faststarpay.com/sdk/v1/faststar.min.js" defer></script>
   <script>
     // data.url 来自你的服务端（第 3 步）
     FastStar.checkout.open({ url: data.url });   // 弹层
     // 或：window.location.href = data.url;      // 整页跳转
   </script>

5. 用 Webhook 对账

   在商户后台配置 Webhook 回调地址，并在收到 payment.succeeded 时履约。前端事件（如 checkout.success）仅用于界面交互——履约一律以服务端 Webhook 为准。

浏览文档