加载中...

面向直接介面接入的請求與回調文件

優易點 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 文件