시작하기

통합 절차

구독 통합 방법:

  1. 게임에 사용할 프로젝트를 생성합니다.
  2. 구독 플랜을 설정합니다.
  3. 인증을 설정합니다.
  4. 카탈로그 UI를 생성합니다.
  5. 결제 UI를 엽니다.
  6. 구독 정보 가져오기를 구현합니다.

작동 방식

1단계 — 결제 UI 열기 토큰 가져오기

2단계 — 구매하기

3단계 — 결제하기

사용자 절차

글로서리

정기결제 플랜
사용자가 서비스에 액세스하는 권한을 받기 위한 청구 조건(청구 금액, 통화, 빈도). 플랜 설정은 필수 통합 단계입니다.
정기결제 기반 상품
사용자가 구독을 구매할 때 제공 받는 서비스 또는 서비스 세트입니다. 상품 생성 API 호출은 제품을 생성하는 데 사용됩니다. 서로 다른 서비스에 대한 별도의 구독 판매를 설정하거나 사용자가 동시에 여러 구독을 신청할 수 있는 기능을 제공하려는 경우 제품을 생성해야 합니다. 구독 기반 제품은 스트리머의 채널, 게임 또는 유니크 아이템/유니크 능력에 대한 액세스일 수 있습니다. 이 지침에서 구독 기반 제품 설정 및 사용에 대한 자세한 내용을 읽을 수 있습니다.

정기 결제

제품과 선택한 플랜의 조합. 구독은 사용자가 구독을 선택하여 서비스에 액세스 권한을 얻으면 생성됩니다. 프로젝트의 제품 수에 따라 동시에 사용자가 액세스 권한을 얻을 수 있는 구독 수가 달라집니다. 구독 조건(청구 기간, 가격, 기타)은 선택한 플랜에 따라 달라집니다. 구독이 생성된 후에 플랜 조건이 변경되어도 기존 구독 조건은 변경되지 않습니다.

예시 1

제품: 게임 액세스

  • 정기결제 플랜 Silver: $10/1개월
  • 정기결제 플랜 Gold: $100/년

사용자는 다음 정기결제 중에서 하나를 선택할 수 있습니다.

  • 정기결제 1: $10/1개월 플랜으로 게임에 액세스
  • 정기결제 2: $100/년 플랜으로 게임에 액세스

예시 2

제품 1: 게임1에 액세스

제품 2: 게임2에 액세스

  • 정기결제 플랜: $10/1개월

사용자는 2개의 정기결제를 동시에 이용 가능:

  • 정기결제 1: $10/1개월 플랜으로 게임1에 액세스
  • 정기결제 2: $10/1개월 플랜으로 게임2에 액세스

알림
정기결제 기반 제품이 설정되지 않은 경우 사용자는 한번에 하나의 정기결제만 이용할 수 있습니다. 여러개의 정기결제를 동시에 이용하려면 여러분이 제품을 설정헤야 합니다.
플랜 그룹

А 동일한 group_id 매개변수 값을 갖는 플랜 세트입니다. 그룹을 생성하거나 수정하려면 group_id 매개변수를 API 호출에 전달합니다.

다음을 수행하려면 플랜 그룹을 생성해야 합니다.

  • 구독 기반 제품 생성

  • 제품을 구독할 때 사용할 수 있는 플랜 수 제한

  • 사용자가 그룹 내에서 다른 플랜으로 전환하도록 허용

이 지침에서 그룹 설정 및 사용에 대한 자세한 내용을 읽을 수 있습니다.

평가 기간
구독을 결제하지 않고 사용자가 체험해 볼 수 있는 기간. 기능:
  • 체험 기간이 있는 구독을 구매하면 청구 계좌가 생성되고 인증 결제 진행됩니다. 사용자 계정에서 소액이 결제된 다음 환불됩니다. 비용이 결제되면 결제 웹훅이 웹훅 URL로 전송되지 않습니다.
  • 체험 기간이 끝난 후에는 구독 플랜의 정가로 비용이 청구되며 결제 및 업데이트된 구독 웹훅이 웹훅 URL로 전송됩니다. 구독에 대한 결제가 성공적이지 않을 때는 취소된 구독 웹훅이 전송됩니다. 플랜의 유효 기간에 체험 기간은 포함되지 않으며 해당 기간은 별도로 계산됩니다.
  • 체험 기간은 프로모션에 보너스로 추가될 수 있습니다.
  • 유예 기간
    유예 기간은 정기결제 만료 후 사용자가 게임에 대해 액세스 권한을 가지는 시간의 길이를 정의한 기간입니다. 기능:
    • 유예 기간은 일회성 결제 유형의 정기결제에서만 지원됩니다. 자동 갱신 정기결제에 대한 지불은 자동으로 처리됩니다.
    • 게시자 계정에서 유예 기간의 길이를 변경할 수 있습니다.
    • 사용자가 정기결제에 대한 지불을 완료할 때까지 혹은 유예 기간이 끝날 때까지 시스템이 매일 지불 독촉장을 발송합니다.
    • 사용자는 정기결제를 전액 지불합니다. 사용자가 유예 기간에 사용한 날의 수가 메인 정기결제에 포함되므로 해당 날의 수는 메인 결제 기간에서 배제됩니다.
    • 플랜 설정에서 유예 기간 필드의 값이 0인 경우, 해당 플랜은 유예 기간이 없습니다.
    재시도 기간
    저장된 결제 계정으로 청구 시도가 된 기간. 자동 갱신 구독용으로만 구성할 수 있으며 현금 인출이 실패한 후 활성화됩니다. 기능:
    • 시스템이 결제 계정으로부터 하루에 한 번 현금 인출을 시도합니다.
    • 정기결제가 갱신되거나, 사용자에 의해 취소가 되었거나 결제 재시도 횟수 초과 후에 취소될 때까지 시스템이 현금 인출을 시도합니다.
    • 이 설정이 활성화된 경우 결제 재시도 횟수가 초과될 때까지 사용자는 정기결제에 대한 액세스 권한을 가집니다.
    • 정기결제가 사용자에 의해 갱신된 경우 결제 시도에 시스템이 사용한 날의 수(각 시도당 하루)가 메인 정기결제에 포함되므로 해당 날의 수가 메인 결제 기간에서 배제됩니다.
    자동 결제
    저장된 청구 계정으로 자동으로 비용을 청구하는 구독 갱신 유형. 사용자 액션이 필요하지 않습니다. 청구 계정이 저장되지 않았다면 자동 결제 유형 구독은 Non renewing 상태로 변환됩니다.
    일회성 결제
    이메일로 받은 결제 링크로 사용자가 요금을 결제할 때의 구독 갱신 유형. 자동 결제를 지원하지 않는 결제 방식을 사용자가 선택한 경우에 사용됩니다.

    구독 상태

    구독은 다음 중 하나의 상태를 갖게 됩니다

    • 활성. 기본 상태입니다. 첫 번째 결제가 성공적으로 완료되면 구독이 생성되고 활성화됩니다. 추가 요금은 활성화 상태의 구독에서만 가능합니다.

    주의
    API를 사용하여 수동으로 정기결제를 생성할 수 없습니다. 구매하는 경우에만 자동으로 수행됩니다.

    • 구독 취소됨. 다음과 같은 사유로 인해 구독이 즉시 취소되었습니다
      • API 방식 또는 엑솔라 게시자 계정을 통해 변경된 상태입니다.
      • 사용자에 의해 취소됨.
      • 구독 만료됨(매개변수에서 만료 일자를 설정한 경우).
      • 최대 충전 시도 횟수가 초과했습니다. 이는 3으로 기본 설정되어 있습니다. 이를 변경하려면 계정 관리자에게 문의하십시오.
      • 게임에서 사용자를 찾을 수 없는 경우.
      • 사용자 계정이 삭제된 경우.

    알림
    정기결제가 취소된 경우 마지막에 결제한 금액을 환불할 수 있습니다. 이 옵션은 파트너 및 사용자가 모두 이용할 수 있습니다.

    • 갱신하지 않음. 구독 갱신이 취소된 경우. 본 구독은 현재 결제 주기가 종료될 때까지 지속된 다음, 취소됨 상태로 변경됩니다. 갱신은 다음과 같은 사유로 인해 취소될 수 있습니다
      • API 방식 또는 게시자 계정을 통해 변경된 상태.
      • 이메일 링크를 통해 사용자가 취소함.
      • 사용자 계정이 삭제된 경우.

    진행률
    의견을 보내 주셔서 감사드립니다!
    마지막 업데이트: 2021년 12월 29일

    오자 또는 기타 텍스트 오류를 찾으셨나요? 텍스트를 선택하고 컨트롤+엔터를 누르세요.

    문제 보고
    콘텐츠를 항상 검토합니다. 여러분의 피드백은 콘텐츠를 개선에 도움이 됩니다.
    후속 조치를 위해 이메일을 제공해 주세요
    의견을 보내 주셔서 감사드립니다!