托管收银台
对齐 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_id 与 external_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拿到
url后把浏览器跳过去。 - 2用户付完回到
success_url(带session_id)。 - 3服务端
GET /api/v1/payments/open/checkout/sessions/{id}核验payment_status=="paid"再履约。
GET
/api/v1/payments/open/checkout/sessions/{id}X-Api-Key · payments查询会话(履约核验)