直连下单
站点 Key 直连创建支付订单,支持微信 NATIVE 扫码、微信 JSAPI 内联、支付宝网页。
POST
/api/v1/payments/open/ordersX-Api-Key · payments创建支付订单
| 字段 | 必填 | 说明 |
|---|---|---|
provider | 是 | wechat 或 alipay |
amount_cents | 是 | 金额(分),>0 |
subject | 是 | 订单标题 |
user_id | 二选一 | Rekit 登录用户 ID(接了 Rekit 登录时用) |
external_customer_id | 二选一 | 站点自管的客户标识(未接 Rekit 登录时用) |
jsapi | 否 | 微信内联支付置 true(付款人须已通过 Rekit 微信登录,平台按 user_id 的 mp_openid 解析) |
付款方双轨,不必接登录
user_id 与 external_customer_id 二选一:接了 Rekit 登录就传 user_id;自管用户、没接登录的站点传自己的 external_customer_id 即可下单。微信 NATIVE(扫码)
provider:"wechat" 不带 jsapi → 返回 code_url,前端生成二维码。
响应(截选)
{
"order_id": 8890,
"out_trade_no": "...",
"provider": "wechat",
"status": "pending",
"code_url": "weixin://wxpay/bizpayurl?pr=...",
"expires_at": "..."
}微信 JSAPI(公众号内联)
provider:"wechat" + jsapi:true + user_id → 返回 prepay_params,传给 WeixinJSBridge.invoke('getBrandWCPayRequest', …)。
json
{ "provider": "wechat", "amount_cents": 100, "subject": "会员", "user_id": 123, "jsapi": true }JSAPI 需微信身份,外部客户走扫码
JSAPI 付款人 openid 只能来自 Rekit 微信登录(平台按
user_id 的 mp_openid 解析,含静默登录)。用 external_customer_id 的外部客户拿不到公众号 openid,JSAPI 不可用,请走 NATIVE 扫码 / 支付宝 / 托管收银台。解析不到 → 409 payer_mp_openid_missing;支付 appid 与公众号 appid 不一致 → 409 jsapi_appid_mismatch。