정기 결제 기반 제품 및 플랜 그룹을 설정하는 방법

정기 결제 기반 제품은 사용자가 정기 결제 제품을 구매하면 제공되는 서비스 또는 서비스 세트입니다. 서로 다른 서비스에 대한 별도의 정기 결제 판매를 설정하거나 사용자가 동시에 여러 정기 결제 제품을 신청할 수 있는 기능을 제공하려면 제품을 생성해야 합니다. 스트리머의 채널, 게임 또는 유니크 아이템/유니크 능력에 대한 정기 결제 기반 제품 액세스의 예시입니다.

플랜 그룹은 group_id 매개변수 값이 동일한 플랜 세트입니다. group_id 매개변수는 플랜 그룹을 구성하고 이 그룹을 정기 결제 기반 제품과 연결하는 데 사용됩니다. 플랜 그룹을 생성하면 다음을 수행할 수 있습니다.

• 제품을 구독할 때 사용할 수 있는 플랜 수 제한
• 사용자가 그룹 내에서 다른 플랜으로 전환하도록 허용

그룹, 플랜 및 제품은 다음 규칙에 따라 서로 상호 작용합니다.

• 하나의 플랜은 하나의 그룹에만 속할 수 있습니다.
• 하나의 제품은 하나의 그룹만 기반으로 생성할 수 있습니다.
• 하나의 그룹을 여러 제품에 연결할 수 있습니다.

정기 결제 기반 제품 및 플랜 그룹을 생성하려면 다음 매개변수를 상품 생성 API 호출에 전달합니다.

• 제품의 이름이 포함된 name
• 플랜 그룹의 이름이 포함된 group_id

모든 제품 목록을 변경하거나 삭제하거나 가져오려면 다음과 같은 해당 API 호출을 사용하세요.

• 제품 업데이트
• 제품 삭제

• 제품 가져오기

플랜 그룹과 제품에 플랜을 연결하려면 플랜 그룹의 이름과 group_id 매개변수를 플랜 업데이트 API 호출에 전달합니다. 플랜을 제거하려면 “group_id”:null를 전달합니다.

제품과 연결된 플랜을 구매할 때 결제 인터페이스를 열려면 토큰 생성 API 호출에 다음 매개 변수를 전달합니다.

• 플랜 ID가 있는 purchase.subscription.plan_id

• group_id를 통해 플랜과 연결된 제품의 ID가 있는 purchase.subscription.product_id

예시

• 하나의 정기 결제 옵션으로 게임 액세스 권한을 판매하려면 정기 결제 플랜을 설정해야 하지만 제품은 구성하지 않아도 됩니다.
• 예를 들어, 1개월 및 3개월과 같이 서로 다른 조건으로 게임 액세스 권한을 판매하려면 적절한 조건으로 2개의 정기 결제 플랜을 설정해야 합니다. 제품을 구성할 필요도 없습니다. 플랜에는 기본적으로 “group_id”:null 매개변수가 있습니다. 즉, 플랜은 일반 그룹에 속합니다. 사용자는 정기 결제을 구매할 때 이들 중 하나를 선택할 수 있을 뿐만 아니라 한 플랜에서 다른 플랜으로 전환할 수도 있습니다.
• 1개월 및 3개월 동안의 게임 액세스 권한뿐만 아니라 6개월 동안 검 업그레이드와 같은 추가 정기 결제 제품도 판매하려고 합니다. 이 경우:
  1. 각 제품에 대한 유니크한 name과 group_id 매개변수를 상품 생성 API 호출에 전달하여 “게임”(game)과 “검”(sword)이라는 2개의 제품을 생성합니다.
  2. 다음 방법 중 하나를 사용하여 1개월, 3개월, 6개월 플랜을 생성합니다.
     • 관리자 페이지에서 플랜을 설정한 후 플랜 업데이트 API 호출을 사용하여 제품 group_id 매개변수인 “게임"을 게임 판매용 정기 결제 플랜으로 전달하고 제품 group_id 매개변수인 “검"을 검 판매용 정기 결제 플랜으로 전달합니다.
     • 요금제 생성 API 호출을 사용합니다. 여기서 플랜에 대한 데이터와 “게임” 제품의 group_id 매개변수를 게임 판매용 정기 결제 플랜에 전달하고, “검” 제품의 group_id 매개변수를 검 판매용 정기 결제 플랜에 전달합니다.
  3. 스토어 인터페이스에서 “게임 정기 결제"과 “검 업그레이드 정기 결제” 제품의 표시를 구현합니다.

마지막 업데이트: 2024년 7월 31일