加载中...

面向直接接口接入的请求与回调文档

优易点 HTTP API 文档

概览

通过直接 HTTP 请求完成订单创建、登录校验与支付状态确认

如果你希望走服务端直连，而不是使用 SDK，这套文档就是给你的。

适用场景

适合以下接入方式：

后端创建支付订单
用户完成支付后，由后端查询订单状态
后端校验登录 token 后再创建本地会话
接收支付回调并刷新你的业务状态

基础地址规则

当文档需要展示完整地址时，请使用：

YOUIDIAN_API_URL + 路由路径

核心接口

${YOUIDIAN_API_URL}/api/v1/pay/orders
${YOUIDIAN_API_URL}/api/v1/pay/orders/:id?appId=...
${YOUIDIAN_API_URL}/api/v1/login/attempts
${YOUIDIAN_API_URL}/api/v1/login/attempts/:attemptId
${YOUIDIAN_API_URL}/api/v1/login/tokens/verify
例如 ${YOUIDIAN_API_URL}/api/v1/pay/notify/stripe 这类支付回调接口

推荐流程

你的后端
  -> POST ${YOUIDIAN_API_URL}/api/v1/pay/orders
  -> 保存返回的 orderId
  -> 把 paymentUrl / qrCode / mobileUrl 返回给前端
  -> 用户支付完成后，GET ${YOUIDIAN_API_URL}/api/v1/pay/orders/:id?appId=...
  -> 确认订单成功后再开通权限

你的前端
  -> 发起 hosted login 或支付流程
  -> 把登录 token 或支付结果回传给后端
  -> 由后端完成 token 校验或订单确认

推荐阅读顺序

优易点 HTTP API 文档