카탈로그 UI 생성하기
카탈로그 UI를 생성하는 3가지 방법:
자체 인터페이스 사용하기
자체 인터페이스에서 디렉터리를 사용할 경우 사용 가능:
- 자체 데이터 저장소 및 모든 인증 옵션. 이 경우 자체적으로 카탈로그 UI를 구현해야 합니다.
- 자체 인증 방식 및 플랜 가져오기 서버 메소드. 플랜 목록 가져오기를 수행한 후에 자체적으로 카탈로그 UI를 구현해야 합니다.
- 엑솔라 로그인 및 클라이언트 측 API 호출입니다.
엑솔라 로그인 및 클라이언트 측 API 호출
카탈로그를 구현하는 방법:- 클라이언트 메소드를 사용하여 정기 결제 플랜 목록 가져오기:
- 프로젝트에 정기 결제 기반 제품이 구성되어 있는 경우 클라이언트 측 메소드를 사용하여 제품별로 정기 결제 플랜을 가져옵니다.
- 프로젝트에 정기 결제 기반 제품이 구성되어 있지 않은 경우 클라이언트 측 메소드를 사용하여 플랜 목록을 가져옵니다.
- 인터페이스에서 수신한 플랜 목록 표시를 구현합니다.
제품별로 정기 결제 플랜을 가져오는 클라이언트 측 메소드
애플리케이션의 클라이언트 측에서 HTTP GET 요청을 사용하여 플랜 목록 가져오기를 구현하는 방법: https://subscriptions.xsolla.com/api/user/v1/projects/{project_id}/products/{productId}/plans를 사용합니다.
요청에 Authorization: Bearer <client_user_jwt> 헤더를 포함해야 합니다. 여기서 <client_user_jwt>는 사용자의 JSON 웹 토큰(JWT)으로 Base64 표준에 따라 인코딩한 고유한 토큰입니다. 토큰을 받는 방법:
- 애플리케이션에서 로그인과 암호 인증을 사용하는 경우
Register new user 와Auth by username 을 사용합니다. 애플리케이션에서 소셜 네트워크를 통한 인증을 사용하는 경우
Auth via social network API 호출을 사용합니다.
projectId- 프로젝트 ID입니다. 이 매개 변수는 관리자 페이지의 프로젝트 이름 옆에서 확인할 수 있습니다.
productID- 구독 기반 제품 ID입니다. 이 ID를 가져오려면 고객 성공 매니저에게 문의하거나 csm@xsolla.com으로 이메일을 보내주세요.
| 매개 변수 | 유형 | 설명 |
|---|---|---|
plan_id | array of integers | 요금제 ID입니다. |
| array of strings | 플랜의 외부 ID입니다. 정기 결제 > 구독 플랜 > 내 플랜 섹션의 관리자 페이지이나 플랜 가져오기 API 호출을 통해 확인할 수 있습니다. |
| integer | 페이지 요소 개수 한도입니다. 기본적으로 15개의 아이템이 표시됩니다. |
| integer | 목록이 생성된 요소의 개수입니다. 개수는 기본적으로 0부터 세기 시작합니다. |
| string | 두 글자 소문자로된 인터페이스 언어. ISO 639-1 값 허용. 이 매개 변수가 전달되지 않으면 사용자의 IP 주소에 따라 언어가 결정됩니다. 사용 가능한 값:
|
| string | ISO 3166-1 alpha-2에 따라 사용자의 국가를 식별하는 데 사용하는 두 글자 코드입니다. 이 매개변수는 로케일 및 통화 선택에 영향을 미칩니다. 이 매개변수를 전달하지 않으면 사용자의 IP 주소로 국가를 결정합니다. |
- curl
1curl -X 'GET' \
2'https://subscriptions.xsolla.com/api/user/v1/projects/{project_id}/products/{productId}/plans?country=RU ' \
3 -H 'accept: application/json' \
4 -H 'Authorization: Bearer client_user_jwt'
- javascript
1{
2 "items": [
3 {
4 "plan_id": 54321,
5 "plan_external_id": "PlanExternalId",
6 "plan_group_id": "TestGroupId",
7 "plan_type": "all",
8 "plan_name": "Localized plan name",
9 "plan_description": "Localized plan description",
10 "plan_start_date": "2021-04-11T13:51:02+03:00",
11 "plan_end_date": "2031-04-11T13:51:02+03:00",
12 "trial_period": 7,
13 "period": {
14 "value": 1,
15 "unit": "month"
16 },
17 "charge": {
18 "amount": 4.99,
19 "setup_fee": 0.99,
20 "currency": "USD"
21 },
22 "promotion": {
23 "promotion_charge_amount": 3.99,
24 "promotion_remaining_charges": 3
25 }
26 }
27 ],
28 "has_more": false
29}
플랜 목록을 가져오는 클라이언트 측 메소드
애플리케이션의 클라이언트 측에서 HTTP GET 요청을 사용하여 플랜 목록 가져오기를 구현하는 방법: https://subscriptions.xsolla.com/api/user/v1/projects/{project_id}/plans를 사용합니다.
요청에 Authorization: Bearer <client_user_jwt> 헤더를 포함해야 합니다. 여기서 <client_user_jwt>는 사용자의 JSON 웹 토큰(JWT)으로 Base64 표준에 따라 인코딩한 고유한 토큰입니다. 토큰을 받는 방법:
- 애플리케이션에서 로그인과 암호 인증을 사용하는 경우
Register new user 와Auth by username 을 사용합니다. 애플리케이션에서 소셜 네트워크를 통한 인증을 사용하는 경우
Auth via social network API 호출을 사용합니다.
projectId 경로 매개변수로 지정합니다. 이 매개 변수는 관리자 페이지의 프로젝트 이름 옆에서 찾을 수 있습니다.쿼리 매개변수로 지정하기:
| 매개 변수 | 유형 | 설명 |
|---|---|---|
plan_id | array of integers | 요금제 ID입니다. |
| array of strings | 플랜의 외부 ID입니다. 정기 결제 > 구독 플랜 > 내 플랜 섹션의 관리자 페이지이나 플랜 가져오기 API 호출을 통해 확인할 수 있습니다. |
| integer | 페이지 요소 개수 한도입니다. 기본적으로 15개의 아이템이 표시됩니다. |
| integer | 목록이 생성된 요소의 개수입니다. 개수는 기본적으로 0부터 세기 시작합니다. |
| string | 두 글자 소문자로된 인터페이스 언어. ISO 639-1 값 허용. 이 매개 변수가 전달되지 않으면 사용자의 IP 주소에 따라 언어가 결정됩니다. 사용 가능한 값:
|
| string | ISO 3166-1 alpha-2에 따라 사용자의 국가를 식별하는 데 사용하는 두 글자 코드입니다. 이 매개변수는 로케일 및 통화 선택에 영향을 미칩니다. 이 매개변수를 전달하지 않으면 사용자의 IP 주소로 국가를 결정합니다. |
- curl
1curl -X 'GET' \
2'https://subscriptions.xsolla.com/api/user/v1/projects/{project_id}/plans?country=RU ' \
3 -H 'accept: application/json' \
4 -H 'Authorization: Bearer client_user_jwt'
- javascript
1{
2 "items": [
3 {
4 "plan_id": 54321,
5 "plan_external_id": "PlanExternalId",
6 "plan_group_id": "TestGroupId",
7 "plan_type": "all",
8 "plan_name": "Localized plan name",
9 "plan_description": "Localized plan description",
10 "plan_start_date": "2021-04-11T13:51:02+03:00",
11 "plan_end_date": "2031-04-11T13:51:02+03:00",
12 "trial_period": 7,
13 "period": {
14 "value": 1,
15 "unit": "month"
16 },
17 "charge": {
18 "amount": 4.99,
19 "setup_fee": 0.99,
20 "currency": "USD"
21 },
22 "promotion": {
23 "promotion_charge_amount": 3.99,
24 "promotion_remaining_charges": 3
25 }
26 }
27 ],
28 "has_more": false
29}
엑솔라 페이 스테이션 사용하기
- 서버 측 토큰 생성하기 API 호출을 통해 토큰 가져오기를 구현합니다. 요청에서 다음 매개변수를 전달합니다.
- 결제 UI 열기를 구현하는 방법:
- javascript
1{
2 "user": {
3 "name": {
4 "value": "j.smith@email.com"
5 },
6 "id": {
7 "value": "123a345b678c091d"
8 }
9 },
10 "settings": {
11 "project_id": 177226
12 }
13}
엑솔라 페이 스테이션에 정기 결제 카탈로그를 표시하는 예시:
엑솔라 웹사이트 빌더 사용하기
엑솔라 웹사이트 빌더를 사용하여 정기 결제 판매용 사이트를 생성하고 설정할 수 있습니다. 이렇게 하려면 웹샵 솔루션 템플릿을 사용하여 사이트를 생성해야 합니다. 사용자 인증을 사용하는 웹샵 솔루션 지침에서 역할 설정에 대한 자세한 내용을 확인할 수 있습니다.
오자 또는 기타 텍스트 오류를 찾으셨나요? 텍스트를 선택하고 컨트롤+엔터를 누르세요.
