API 레퍼런스

Xsolla 확인

POST/v1/xsolla/verify

이 API 키에 설정한 판매자 ID, 프로젝트 ID, Xsolla API 키(콘솔 → API 키 → 편집 → Xsolla 구독 확인)로 Xsolla 사용자 또는 구독 하나가 구독 중인지 확인합니다. 결과는 Xsolla에서 바로 가져오며, 게이트웨이는 요금을 청구하지 않고 무엇을 열지는 앱이 정합니다. 찾은 구독은 1분 동안 캐시됩니다.

#요청 파라미터

user_idstring선택
앱이 Xsolla 결제 토큰에 넣은 user.id. subscription_id를 보내지 않으면 필수입니다.
subscription_idinteger선택
앱이 가지고 있다면 Xsolla 구독 ID. user_id와 함께 보내면 그 구독은 해당 사용자의 것이어야 합니다.

subscribed는 이 프로젝트에서 해당 사용자에게 실제 구독(취소된 구독 포함)이 있으면 true이고, active는 지금 사용할 수 있는 동안만 true입니다. 자동 갱신을 끈 구독(state non_renewing)은 expiry_time까지 활성 상태입니다. in_trial은 아직 결제되지 않은 동안 true입니다. 구독이 없는 사용자는 상태 200으로 subscribed false, state not_found를 반환합니다. 구독이 여러 개면 가장 오래 유지되는 활성 구독을 반환합니다.

캐시된 응답과 실패를 포함한 모든 호출은 콘솔 → 요청 로그에 호출한 키의 무료 xsolla-verify 행으로 표시됩니다. 이 행은 요청 수에서 제외됩니다. 앱에서 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 구독