跳转到内容

店铺支付

部署后的店铺内结账支付。模版:store-cay-starter。

网关 浏览器 服务端 说明
Stripe Payment Element PUBLIC_STRIPE_KEY STRIPE_SECRET_KEY Webhook:STRIPE_WEBHOOK_SECRET
PayPal Checkout PUBLIC_PAYPAL_CLIENT_ID PAYPAL_CLIENT_SECRET PAYPAL_ENV=sandbox|live

本地可无支付密钥开发;结账可能走手动 / mock 路径(视配置而定)。

  1. 在 Stripe Dashboard 创建密钥。
  2. 配置环境变量 — 见 环境变量。
  3. Webhook:
https://<你的店铺域名>/api/stripe/webhook
  1. 事件:payment_intent.succeeded、payment_intent.payment_failed、charge.refunded。
  1. 在 PayPal Developer 创建 REST 应用。
  2. 设置 PUBLIC_PAYPAL_CLIENT_ID + PAYPAL_CLIENT_SECRET。
  3. PAYPAL_ENV 与沙箱 / 正式凭据一致。
  1. 购物车 → /checkout
  2. 地址 → 运费(/api/shipping-options)→ 可选优惠码
  3. Stripe / PayPal 或配置的回退方式支付
  4. /api/orders 写单并确认支付
  5. 跳转 /order/confirmed(带 guest token);之后可在 /order/lookup 查询

运费与优惠码在 Admin → Settings(D1)编辑,不在环境变量里。