aisplice

API 參考

Xsolla 驗證

POST/v1/xsolla/verify

用這個 API 金鑰上設定的商戶 ID、專案 ID 和 Xsolla API 金鑰（主控台 → API 金鑰 → 編輯 → Xsolla 訂閱驗證），查詢一個 Xsolla 使用者或一個訂閱是否在訂閱中。結果直接來自 Xsolla；閘道不收費，解鎖什麼由你的 App 決定。查到的訂閱快取一分鐘。

#請求參數

  • user_idstring選填

    你的 App 寫進 Xsolla 付款權杖的 user.id。不傳 subscription_id 時必填。

  • subscription_idinteger選填

    Xsolla 訂閱 ID（如果 App 拿得到）。和 user_id 一起傳時，訂閱必須屬於該使用者。

subscribed 表示該使用者在這個專案裡有過真實訂閱（包括已取消的）；active 只在目前可用時為 true。關閉自動續訂後（state 為 non_renewing），訂閱在 expiry_time 之前仍然有效。in_trial 表示還沒扣過款。沒有訂閱的使用者回傳 subscribed false、state not_found，狀態碼 200。使用者有多個訂閱時，回傳到期最晚的那個生效訂閱。

每次呼叫（包括快取結果和失敗）都會出現在主控台 → 請求紀錄裡，記在發起呼叫的金鑰上，是一筆免費的 xsolla-verify 紀錄。這些紀錄不計入請求次數。 在 App 裡串接 Xsolla 訂閱 →

#相關錯誤碼

  • 400 invalid_request請求內容不是 JSON，或 user_id 和 subscription_id 都沒傳。
  • 400 xsolla_not_configured這個 API 金鑰還沒有設定 Xsolla 商戶 ID、專案 ID 和 API 金鑰。
  • 401Bearer 權杖無效或缺失。
  • 429每個金鑰的驗證次數上限：預設每分鐘 120 次，可聯絡客服為單一金鑰調高。請依 Retry-After 等待，並沿用上次的結果。
  • 502 xsolla_credentials_invalidXsolla 拒絕了已儲存的 API 金鑰。請在金鑰上重新填寫。
  • 503 xsolla_unavailableXsolla 沒有及時回應。請過幾秒重試。

完整錯誤碼表 →

#請求範例

curl https://www.aisplice.store/v1/xsolla/verify \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"user_id": "USER_ID_IN_THE_PAYMENT_TOKEN"}'

#回應

response.json
{
  "project_id": 273204,
  "subscribed": true,
  "active": true,
  "in_trial": false,
  "state": "active",
  "subscription_id": 249579,
  "user_id": "user-8f2c",
  "plan_id": 601,
  "plan_external_id": "weekly",
  "expiry_time": 1793000000,
  "auto_renewing": true,
  "checked_at": 1790400000
}

還是沒解決？

把請求 ID 或錯誤訊息傳給我們，我們來查。

上一頁Google Play 訂閱驗證下一頁Google Play 訂閱驗證