콘텐츠로 건너뛰기

정기 결제 API (2.0)

개요

  • 버전: 2.0
  • 서버: https://api.xsolla.com/merchant/v2/

본 API 참조는 정기 결제, 쿠폰 및 프로모션 관리 엔드포인트에 관하여 기술하고 있습니다. 정기 결제에 대한 더 자세한 내용은 제품 가이드 및 용어집을 참조하십시오.

OpenAPI 설명 다운로드
index.json
index.yaml
언어
서버
Mock server
https://xsolla.redocly.app/_mock/ko/api/subscriptions/

토큰

작업

Plans

작업

제품

작업

제품 가져오기

요청

Lists all subscription-based products.

보안
basicAuth
경로
project_idinteger필수

Project ID.

쿼리
offsetinteger

Number of the element from which the list is generated (the count starts from 0).

limitinteger필수

Limit for the number of elements on the page.

group_idstring

이러한 요금제가 연결된 그룹의 ID입니다.

product_idinteger

Product ID the plans are linked to.

curl -i -X GET \
  -u <username>:<password> \
  'https://xsolla.redocly.app/_mock/ko/api/subscriptions/projects/{project_id}/subscriptions/products?offset=0&limit=0&group_id=string&product_id=0'

응답

OK(확인).

본문application/jsonArray [
idinteger or null

Product ID the plans are linked to.

descriptionobject

현지화된 아이템 설명입니다.

description.​arstring

아랍어.

description.​bgstring

불가리아어.

description.​cnstring

중국어(간체).

description.​csstring

체코어.

description.​destring

독일어.

description.​enstring

영어.

description.​esstring

스페인어.

description.​frstring

프랑스어.

description.​hestring

히브리어.

description.​itstring

이탈리아어.

description.​jastring

일본어.

description.​kostring

한국어.

description.​plstring

폴란드어.

description.​ptstring

포르투갈어.

description.​rostring

루마니아어.

description.​rustring

러시아어.

description.​thstring

태국어.

description.​trstring

터키어.

description.​twstring

중국어(번체).

description.​vistring

베트남어.

group_idstring

제품이 연결된 그룹의 ID입니다.

namestring

제품 이름입니다.

]
응답
application/json
[
  {
    "description": { … },
    "group_id": "charge",
    "id": 714,
    "name": "Channel"
  },
  {
    "description": { … },
    "group_id": "notify",
    "id": 715,
    "name": "notify"
  },
  {
    "description": { … },
    "group_id": "charge",
    "id": 716,
    "name": "charge2"
  },
  {
    "description": { … },
    "group_id": "charge",
    "id": 486,
    "name": "Channel2"
  }
]

Create Product

요청

Creates a subscription-based product.

보안
basicAuth
경로
project_idinteger필수

Project ID.

본문application/json필수
descriptionobject

현지화된 아이템 설명입니다.

description.​arstring

아랍어.

description.​bgstring

불가리아어.

description.​cnstring

중국어(간체).

description.​csstring

체코어.

description.​destring

독일어.

description.​enstring

영어.

description.​esstring

스페인어.

description.​frstring

프랑스어.

description.​hestring

히브리어.

description.​itstring

이탈리아어.

description.​jastring

일본어.

description.​kostring

한국어.

description.​plstring

폴란드어.

description.​ptstring

포르투갈어.

description.​rostring

루마니아어.

description.​rustring

러시아어.

description.​thstring

태국어.

description.​trstring

터키어.

description.​twstring

중국어(번체).

description.​vistring

베트남어.

group_idstring필수

제품이 연결된 그룹의 ID입니다.

namestring필수

제품 이름입니다.

curl -i -X POST \
  -u <username>:<password> \
  'https://xsolla.redocly.app/_mock/ko/api/subscriptions/projects/{project_id}/subscriptions/products' \
  -H 'Content-Type: application/json' \
  -d '{
    "description": {
      "en": "Kids TV"
    },
    "group_id": "charge",
    "name": "Channel2"
  }'

응답

생성됨.

본문application/json
product_idinteger
응답
application/json
{
  "product_id": 172003
}

Delete Product

요청

Deletes a subscription-based product.

보안
basicAuth
경로
project_idinteger필수

Project ID.

product_idinteger필수

Product ID the plans are linked to.

curl -i -X DELETE \
  -u <username>:<password> \
  'https://xsolla.redocly.app/_mock/ko/api/subscriptions/projects/{project_id}/subscriptions/products/{product_id}'

응답

콘텐츠가 없습니다.

Subscription management

작업

결제

작업

프로모션

작업

쿠폰

작업

Subscription management

작업