托管收银台

对齐 Stripe 的 Checkout Session:创建会话拿 url,浏览器跳平台收银台,成功后回站履约。

推荐方式。平台托管收银台内含微信 NATIVE/JSAPI 与支付宝,产品站无需自己渲染二维码/拉起 JSAPI。

POST/api/v1/payments/open/checkout/sessionsX-Api-Key · payments
创建 Checkout Session
请求
{
  "mode": "payment",
  "success_url": "https://你的站/success?session_id={CHECKOUT_SESSION_ID}",
  "cancel_url": "https://你的站/pricing",
  "user_id": 123,
  "client_reference_id": "本地订单号(可选)",
  "line_items": [
    {
      "quantity": 1,
      "price_data": {
        "currency": "cny",
        "unit_amount": 990,
        "product_data": { "name": "专业版 / 月" }
      }
    }
  ]
}
line_items 目前恰好 1 项。success_url / cancel_url 的 host 须在站点白名单内。付款方同「直连下单」:user_idexternal_customer_id 二选一,未接 Rekit 登录用后者即可。
响应(截选)
{
  "id": "cs_xxx",
  "object": "checkout.session",
  "url": "https://pay.rekitdev.com/c/pay/cs_xxx",
  "status": "open",
  "payment_status": "unpaid",
  "amount_total": 990
}
  1. 1拿到 url 后把浏览器跳过去。
  2. 2用户付完回到 success_url(带 session_id)。
  3. 3服务端 GET /api/v1/payments/open/checkout/sessions/{id} 核验 payment_status=="paid" 再履约。
GET/api/v1/payments/open/checkout/sessions/{id}X-Api-Key · payments
查询会话(履约核验)