구독자 계정

작동 방식

구독자 계정은 사용자가 엑솔라 프로젝트에서 구성한 정기 결제를 보고 관리할 수 있는 서비스입니다.

• 정기 결제 세부 정보 보기
• 정기 결제 관리 - 즉시 취소, 자동 갱신 비활성화 또는 재활성화(프로젝트 설정에 따라 다름)
• 정기 결제 요금제 변경
• 결제 방식 업데이트

• 인게임 결제 페이지의
• 엑솔라 정기 결제 관련 이메일 알림 클릭

• 서버 측 API 호출 사용
• 클라이언트 측 API 호출 사용

API를 통해 구독자 계정 링크 가져오기

서버 측 호출

이 호출을 사용하면 애플리케이션의 서버 측에서 HTTP POST 요청을 통해 구독자 계정으로 연결되는 링크를 생성할 수 있습니다.

URL 주소:

https://subscriptions.xsolla.com​/api/user/v1/projects/{project_id}/subscriptions/user_account

인증:

호출 시 기본 액세스 인증을 사용합니다. 모든 API 요청에는 Authorization: Basic <your_authorization_basic_key> 헤더가 있어야 합니다. 여기에서, <your_authorization_basic_key>는 Base64 표준에 따라 인코딩된 merchant_id:api_key 쌍입니다. 이러한 매개 변수를 찾으려면 관리자 페이지로 이동하십시오:

• merchant_id 표시 위치:
  • 회사 설정 > 회사 섹션.
  • 관리자 페이지의 브라우저 주소 표시줄에 있는 URL에서 URL 형식은 다음과 같습니다: https://publisher.xsolla.com/<merchant_id>.
• api_key는 생성 시 관리자 페이지에 한 번만 표시되며 사용자가 직접 저장해서 보관해야 합니다. 다음 섹션에서 새로운 키를 생성할 수 있습니다:
  • 회사 설정 > API 키
  • 프로젝트 설정 > API 키

매개 변수:

경로 매개 변수로 project_id 프로젝트 ID를 지정합니다. 이는 프로젝트 이름 바로 옆에 있는 관리자 페이지 또는 프로젝트 페이지의 브라우저 주소 표시줄에서 지정합니다. URL의 형식은 다음과 같습니다: https://publisher.xsolla.com/<merchantId>/projects/<projectId>.

본문 매개 변수:

 1curl -v https://subscriptions.xsolla.com​/api/v1/projects/{projectId}/subscriptions/user_account \
 2-X POST \
 3-u your_merchant_id:merchant_api_key \
 4-H 'Content-Type:application/json' \
 5-H 'Accept: application/json' \
 6-d '
 7{
 8  "user_v1": "user123",
 9  "locale": "en"
10}'

응답 예제:

1{
2  "redirect_url": "https://subscriptions-user-account.xsolla.com/?token=<access_token>&projectId=<project_id>&merchantId=<merchant_id>&locale=<locale>"
3}

클라이언트 측 호출

이 호출을 사용하면 프로젝트에 엑솔라 로그인이 설정되어 있는 경우 HTTP GET 요청을 통해 애플리케이션의 클라이언트 측에서 구독자 계정으로 연결되는 링크를 생성할 수 있습니다.

URL 주소:

https://subscriptions.xsolla.com​/api/user/v1/projects/{project_id}/subscriptions/user_account

인증:

요청에는 Authorization: Bearer <client_user_jwt> 헤더가 포함되어 있어야 합니다. 여기에서, <client_user_jwt>는 사용자의 JSON 웹 토큰(JWT)으로 Base64 표준에 따라 인코딩한 고유한 토큰입니다. 토큰을 받는 방법:

• 애플리케이션에서 로그인과 암호 인증을 사용하는 경우 Register new user와 Auth by username을 사용합니다.
• 애플리케이션에서 소셜 네트워크를 통한 인증을 사용하는 경우 Auth via social network API 호출을 사용합니다.

매개 변수:

경로 매개 변수로 project_id 프로젝트 ID를 지정합니다. 이는 프로젝트 이름 바로 옆에 있는 관리자 페이지 또는 프로젝트 페이지의 브라우저 주소 표시줄에서 지정합니다. URL의 형식은 다음과 같습니다: https://publisher.xsolla.com/{merchantId}/projects/{projectId}.

쿼리 매개 변수로 locale을 지정합니다. ISO 639-1에 따른 두 글자 소문자로 되어 있는 인터페이스 언어입니다. 이 매개 변수를 전달하지 않으면 사용자의 IP 주소에 따라 언어가 결정됩니다. 전달된 로케일이 엑솔라 목록에 없는 경우 영어가 기본적으로 사용됩니다.

요청 예제:

1curl -v https://subscriptions.xsolla.com​/api/user/v1/projects/{project_id}/subscriptions/user_account \
2-X GET \
3-u your_merchant_id:merchant_api_key \
4-H 'Content-Type:application/json' \
5-H 'Accept: application/json' \

응답 예제:

1{
2  "redirect_url": "https://subscriptions-user-account.xsolla.com/?token=<access_token>&projectId=<project_id>&merchantId=<merchant_id>&locale=<locale>"
3}